eliminated qbyte type, now uses unsigned char throughout the engine for this purpose
[divverent/darkplaces.git] / gl_backend.h
1
2 #ifndef GL_BACKEND_H
3 #define GL_BACKEND_H
4
5 #define MAX_TEXTUREUNITS 16
6
7 #define POLYGONELEMENTS_MAXPOINTS 258
8 extern int polygonelements[768];
9
10 void GL_SetupView_Orientation_Identity(void);
11 void GL_SetupView_Orientation_FromEntity(matrix4x4_t *matrix);
12 void GL_SetupView_Mode_Perspective(double fovx, double fovy, double zNear, double zFar);
13 void GL_SetupView_Mode_PerspectiveInfiniteFarClip(double fovx, double fovy, double zNear);
14 void GL_SetupView_Mode_Ortho(double x1, double y1, double x2, double y2, double zNear, double zFar);
15 void GL_BlendFunc(int blendfunc1, int blendfunc2);
16 void GL_DepthMask(int state);
17 void GL_DepthTest(int state);
18 void GL_ColorMask(int r, int g, int b, int a);
19 void GL_Color(float cr, float cg, float cb, float ca);
20 void GL_ShowTrisColor(float cr, float cg, float cb, float ca);
21 void GL_TransformToScreen(const vec4_t in, vec4_t out);
22 void GL_LockArrays(int first, int count);
23 void GL_ActiveTexture(unsigned int num);
24 void GL_ClientActiveTexture(unsigned int num);
25 void GL_Scissor(int x, int y, int width, int height); // AK for DRAWQUEUE_SETCLIP
26 void GL_ScissorTest(int state); // AK for DRAWQUEUE_(RE)SETCLIP
27 void GL_Clear(int mask);
28
29 unsigned int GL_Backend_CompileProgram(int vertexstrings_count, const char **vertexstrings_list, int fragmentstrings_count, const char **fragmentstrings_list);
30 void GL_Backend_FreeProgram(unsigned int prog);
31
32 extern cvar_t gl_lockarrays;
33 extern cvar_t gl_mesh_copyarrays;
34 extern cvar_t gl_paranoid;
35 extern cvar_t gl_printcheckerror;
36
37 //input to R_Mesh_State
38 typedef struct rmeshstate_s
39 {
40         // textures
41         int tex1d[MAX_TEXTUREUNITS];
42         int tex[MAX_TEXTUREUNITS];
43         int tex3d[MAX_TEXTUREUNITS];
44         int texcubemap[MAX_TEXTUREUNITS];
45         // texture combine settings
46         int texrgbscale[MAX_TEXTUREUNITS]; // used only if COMBINE is present
47         int texalphascale[MAX_TEXTUREUNITS]; // used only if COMBINE is present
48         int texcombinergb[MAX_TEXTUREUNITS]; // works with or without combine for some operations
49         int texcombinealpha[MAX_TEXTUREUNITS]; // does nothing without combine
50         // matrices
51         matrix4x4_t texmatrix[MAX_TEXTUREUNITS];
52         // pointers
53         const float *pointer_texcoord[MAX_TEXTUREUNITS]; // 2D
54         const float *pointer_texcoord3f[MAX_TEXTUREUNITS]; // 3D
55
56         // other state set by this
57         const float *pointer_vertex;
58         const float *pointer_color;
59 }
60 rmeshstate_t;
61
62 // adds console variables and registers the render module (only call from GL_Init)
63 void gl_backend_init(void);
64
65 // starts mesh rendering for the frame
66 void R_Mesh_Start(void);
67
68 // ends mesh rendering for the frame
69 // (only valid after R_Mesh_Start)
70 void R_Mesh_Finish(void);
71
72 // sets up the requested vertex transform matrix
73 void R_Mesh_Matrix(const matrix4x4_t *matrix);
74 // sets the vertex array pointer
75 void R_Mesh_VertexPointer(const float *vertex3f);
76 // sets the color array pointer (GL_Color only works when this is NULL)
77 void R_Mesh_ColorPointer(const float *color4f);
78 // sets the texcoord array pointer for an array unit
79 void R_Mesh_TexCoordPointer(unsigned int unitnum, unsigned int numcomponents, const float *texcoord);
80 // sets all textures bound to an image unit (multiple can be non-zero at once, according to OpenGL rules the highest one overrides the others)
81 void R_Mesh_TexBindAll(unsigned int unitnum, int tex1d, int tex2d, int tex3d, int texcubemap);
82 // sets these are like TexBindAll with only one of the texture indices non-zero
83 // (binds one texture type and unbinds all other types)
84 void R_Mesh_TexBind1D(unsigned int unitnum, int texnum);
85 void R_Mesh_TexBind(unsigned int unitnum, int texnum);
86 void R_Mesh_TexBind3D(unsigned int unitnum, int texnum);
87 void R_Mesh_TexBindCubeMap(unsigned int unitnum, int texnum);
88 // sets the texcoord matrix for a texenv unit
89 void R_Mesh_TexMatrix(unsigned int unitnum, const matrix4x4_t *matrix);
90 // sets the combine state for a texenv unit
91 void R_Mesh_TexCombine(unsigned int unitnum, int combinergb, int combinealpha, int rgbscale, int alphascale);
92 // set up the requested entire rendering state
93 void R_Mesh_State(const rmeshstate_t *m);
94
95 // renders a mesh
96 void R_Mesh_Draw(int firstvertex, int numvertices, int numtriangles, const int *elements);
97 // renders a mesh as lines
98 void R_Mesh_Draw_ShowTris(int firstvertex, int numvertices, int numtriangles, const int *elements);
99
100 // saves a section of the rendered frame to a .tga or .jpg file
101 qboolean SCR_ScreenShot(char *filename, unsigned char *buffer1, unsigned char *buffer2, unsigned char *buffer3, int x, int y, int width, int height, qboolean flipx, qboolean flipy, qboolean flipdiagonal, qboolean jpeg, qboolean gammacorrect);
102 // used by R_Envmap_f and internally in backend, clears the frame
103 void R_ClearScreen(void);
104 // invoke refresh of frame
105 void SCR_UpdateScreen(void);
106 // invoke refresh of loading plaque (nothing else seen)
107 void SCR_UpdateLoadingScreen(void);
108
109 // public structure
110 typedef struct rcachearrayrequest_s
111 {
112         // for use by the code that is requesting the array, these are not
113         // directly used but merely compared to determine if cache items are
114         // identical
115         const void *id_pointer1;
116         const void *id_pointer2;
117         const void *id_pointer3;
118         int id_number1;
119         int id_number2;
120         int id_number3;
121         // size of array data
122         int data_size;
123         // array data pointer
124         void *data;
125 }
126 rcachearrayrequest_t;
127
128 int R_Mesh_CacheArray(rcachearrayrequest_t *r);
129
130 extern float varray_vertex3f[65536*3];
131 extern float varray_svector3f[65536*3];
132 extern float varray_tvector3f[65536*3];
133 extern float varray_normal3f[65536*3];
134 extern float varray_color4f[65536*4];
135 extern float varray_texcoord2f[4][65536*2];
136 extern float varray_texcoord3f[4][65536*3];
137 extern int earray_element3i[65536];
138 extern float varray_vertex3f2[65536*3];
139
140 #endif
141