]> icculus.org git repositories - divverent/darkplaces.git/blob - draw.h
added a comment
[divverent/darkplaces.git] / 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 // shared color tag printing constants
73 #define STRING_COLOR_TAG                        '^'
74 #define STRING_COLOR_DEFAULT            7
75 #define STRING_COLOR_DEFAULT_STR        "^7"
76
77 // sets r_defdef.draw2dstage and prepares for 2D rendering
78 void DrawQ_Begin(void);
79 // draw an image (or a filled rectangle if pic == NULL)
80 void DrawQ_Pic(float x, float y, cachepic_t *pic, float width, float height, float red, float green, float blue, float alpha, int flags);
81 // draw a text string
82 void DrawQ_String(float x, float y, const char *string, int maxlen, float scalex, float scaley, float red, float green, float blue, float alpha, int flags);
83 // draw a text string that supports color tags (colorindex can either be NULL, -1 to make it choose the default color or valid index to start with)
84 void DrawQ_ColoredString( float x, float y, const char *text, int maxlen, float scalex, float scaley, float basered, float basegreen, float baseblue, float basealpha, int flags, int *outcolor );
85 // draw a very fancy pic (per corner texcoord/color control), the order is tl, tr, bl, br
86 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);
87 // draw a triangle mesh
88 void DrawQ_Mesh(drawqueuemesh_t *mesh, int flags);
89 // set the clipping area
90 void DrawQ_SetClipArea(float x, float y, float width, float height);
91 // reset the clipping area
92 void DrawQ_ResetClipArea(void);
93 // draw a line
94 void DrawQ_Line(float width, float x1, float y1, float x2, float y2, float r, float g, float b, float alpha, int flags);
95 // draw a line loop
96 void DrawQ_LineLoop(drawqueuemesh_t *mesh, int flags);
97 // resets r_refdef.draw2dstage
98 void DrawQ_Finish(void);
99
100 void R_DrawGamma(void);
101
102 #endif
103