draw.h

   1 /*
   2 Copyright (C) 1996-1997 Id Software, Inc.
   3
   4 This program is free software; you can redistribute it and/or
   5 modify it under the terms of the GNU General Public License
   6 as published by the Free Software Foundation; either version 2
   7 of the License, or (at your option) any later version.
   8
   9 This program is distributed in the hope that it will be useful,
  10 but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  12
  13 See the GNU General Public License for more details.
  14
  15 You should have received a copy of the GNU General Public License
  16 along with this program; if not, write to the Free Software
  17 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  18
  19 */
  20
  21 // draw.h -- these are the only functions outside the refresh allowed
  22 // to touch the vid buffer
  23
  24 #ifndef DRAW_H
  25 #define DRAW_H
  26
  27 // FIXME: move this stuff to cl_screen
  28 typedef struct cachepic_s
  29 {
  30         // size of pic
  31         int width, height;
  32         // renderer texture to use
  33         rtexture_t *tex;
  34         // used for hash lookups
  35         struct cachepic_s *chain;
  36         // name of pic
  37         char name[MAX_QPATH];
  38 }
  39 cachepic_t;
  40
  41 void Draw_Init (void);
  42 cachepic_t *Draw_CachePic (const char *path, qboolean persistent);
  43 // create or update a pic's image
  44 cachepic_t *Draw_NewPic(const char *picname, int width, int height, int alpha, unsigned char *pixels);
  45 // free the texture memory used by a pic
  46 void Draw_FreePic(const char *picname);
  47
  48 // a triangle mesh..
  49 // each vertex is 3 floats
  50 // each texcoord is 2 floats
  51 // each color is 4 floats
  52 typedef struct drawqueuemesh_s
  53 {
  54         rtexture_t *texture;
  55         int num_triangles;
  56         int num_vertices;
  57         int *data_element3i;
  58         float *data_vertex3f;
  59         float *data_texcoord2f;
  60         float *data_color4f;
  61 }
  62 drawqueuemesh_t;
  63
  64 enum drawqueue_drawflag_e {
  65 DRAWFLAG_NORMAL,
  66 DRAWFLAG_ADDITIVE,
  67 DRAWFLAG_MODULATE,
  68 DRAWFLAG_2XMODULATE,
  69 DRAWFLAG_NUMFLAGS
  70 };
  71
  72 typedef struct dp_font_s
  73 {
  74         rtexture_t *tex;
  75         float width_of[256]; // width_of[0] == max width of any char; 1.0f is base width (1/16 of texture width); therefore, all widths have to be <= 1
  76         char texpath[MAX_QPATH];
  77         char title[MAX_QPATH];
  78 }
  79 dp_font_t;
  80
  81 #define MAX_FONTS 16
  82 extern dp_font_t dp_fonts[MAX_FONTS];
  83 #define FONT_DEFAULT     (&dp_fonts[0]) // should be fixed width
  84 #define FONT_CONSOLE     (&dp_fonts[1]) // REALLY should be fixed width (ls!)
  85 #define FONT_SBAR        (&dp_fonts[2]) // must be fixed width
  86 #define FONT_NOTIFY      (&dp_fonts[3]) // free
  87 #define FONT_CHAT        (&dp_fonts[4]) // free
  88 #define FONT_CENTERPRINT (&dp_fonts[5]) // free
  89 #define FONT_INFOBAR     (&dp_fonts[6]) // free
  90 #define FONT_MENU        (&dp_fonts[7]) // should be fixed width
  91 #define FONT_USER        (&dp_fonts[8]) // userdefined fonts
  92 #define MAX_USERFONTS (MAX_FONTS - (FONT_USER - dp_fonts))
  93
  94 // shared color tag printing constants
  95 #define STRING_COLOR_TAG                        '^'
  96 #define STRING_COLOR_DEFAULT            7
  97 #define STRING_COLOR_DEFAULT_STR        "^7"
  98
  99 // all of these functions will set r_defdef.draw2dstage if not in 2D rendering mode (and of course prepare for 2D rendering in that case)
 100
 101 // draw an image (or a filled rectangle if pic == NULL)
 102 void DrawQ_Pic(float x, float y, cachepic_t *pic, float width, float height, float red, float green, float blue, float alpha, int flags);
 103 // draw a filled rectangle (slightly faster than DrawQ_Pic with pic = NULL)
 104 void DrawQ_Fill(float x, float y, float width, float height, float red, float green, float blue, float alpha, int flags);
 105 // draw a text string,
 106 // with optional color tag support,
 107 // returns final unclipped x coordinate
 108 // if outcolor is provided the initial color is read from it, and it is updated at the end with the new value at the end of the text (not at the end of the clipped part)
 109 // the color is tinted by the provided base color
 110 // if r_textshadow is not zero, an additional instance of the text is drawn first at an offset with an inverted shade of gray (black text produces a white shadow, brightly colored text produces a black shadow)
 111 float DrawQ_String(float x, float y, const char *text, size_t maxlen, float scalex, float scaley, float basered, float basegreen, float baseblue, float basealpha, int flags, int *outcolor, qboolean ignorecolorcodes);
 112 float DrawQ_String_Font(float x, float y, const char *text, size_t maxlen, float scalex, float scaley, float basered, float basegreen, float baseblue, float basealpha, int flags, int *outcolor, qboolean ignorecolorcodes, const dp_font_t *fnt);
 113 float DrawQ_TextWidth_Font(const char *text, size_t maxlen, float scalex, float scaley, qboolean ignorecolorcodes, const dp_font_t *fnt);
 114 float DrawQ_TextWidth_Font_UntilWidth(const char *text, size_t *maxlen, float scalex, float scaley, qboolean ignorecolorcodes, const dp_font_t *fnt, float maxWidth);
 115 // draw a very fancy pic (per corner texcoord/color control), the order is tl, tr, bl, br
 116 void DrawQ_SuperPic(float x, float y, cachepic_t *pic, float width, float height, float s1, float t1, float r1, float g1, float b1, float a1, float s2, float t2, float r2, float g2, float b2, float a2, float s3, float t3, float r3, float g3, float b3, float a3, float s4, float t4, float r4, float g4, float b4, float a4, int flags);
 117 // draw a triangle mesh
 118 void DrawQ_Mesh(drawqueuemesh_t *mesh, int flags);
 119 // set the clipping area
 120 void DrawQ_SetClipArea(float x, float y, float width, float height);
 121 // reset the clipping area
 122 void DrawQ_ResetClipArea(void);
 123 // draw a line
 124 void DrawQ_Line(float width, float x1, float y1, float x2, float y2, float r, float g, float b, float alpha, int flags);
 125 // draw a line loop
 126 void DrawQ_LineLoop(drawqueuemesh_t *mesh, int flags);
 127 // resets r_refdef.draw2dstage
 128 void DrawQ_Finish(void);
 129
 130 void R_DrawGamma(void);
 131
 132 #endif
 133