add a number of PBO validate/map/unmap functions
[mesa.git] / src / mesa / main / mtypes.h
1 /**
2 * \file mtypes.h
3 * Main Mesa data structures.
4 *
5 * Please try to mark derived values with a leading underscore ('_').
6 */
7
8 /*
9 * Mesa 3-D graphics library
10 * Version: 6.5.3
11 *
12 * Copyright (C) 1999-2007 Brian Paul All Rights Reserved.
13 *
14 * Permission is hereby granted, free of charge, to any person obtaining a
15 * copy of this software and associated documentation files (the "Software"),
16 * to deal in the Software without restriction, including without limitation
17 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
18 * and/or sell copies of the Software, and to permit persons to whom the
19 * Software is furnished to do so, subject to the following conditions:
20 *
21 * The above copyright notice and this permission notice shall be included
22 * in all copies or substantial portions of the Software.
23 *
24 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
25 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
26 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
27 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
28 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
29 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
30 */
31
32
33
34 #ifndef TYPES_H
35 #define TYPES_H
36
37
38 #include "glheader.h"
39 #include <GL/internal/glcore.h> /* __GLcontextModes (GLvisual) */
40 #include "config.h" /* Hardwired parameters */
41 #include "glapi/glapitable.h"
42 #include "glapi/glthread.h"
43 #include "math/m_matrix.h" /* GLmatrix */
44 #include "bitset.h"
45
46
47 /**
48 * Special, internal token
49 */
50 #define GL_SHADER_PROGRAM_MESA 0x9999
51
52
53 /**
54 * Color channel data type.
55 */
56 #if CHAN_BITS == 8
57 typedef GLubyte GLchan;
58 #define CHAN_MAX 255
59 #define CHAN_MAXF 255.0F
60 #define CHAN_TYPE GL_UNSIGNED_BYTE
61 #elif CHAN_BITS == 16
62 typedef GLushort GLchan;
63 #define CHAN_MAX 65535
64 #define CHAN_MAXF 65535.0F
65 #define CHAN_TYPE GL_UNSIGNED_SHORT
66 #elif CHAN_BITS == 32
67 typedef GLfloat GLchan;
68 #define CHAN_MAX 1.0
69 #define CHAN_MAXF 1.0F
70 #define CHAN_TYPE GL_FLOAT
71 #else
72 #error "illegal number of color channel bits"
73 #endif
74
75
76 /**
77 * Stencil buffer data type.
78 */
79 #if STENCIL_BITS==8
80 typedef GLubyte GLstencil;
81 #elif STENCIL_BITS==16
82 typedef GLushort GLstencil;
83 #else
84 # error "illegal number of stencil bits"
85 #endif
86
87
88 /**
89 * Fixed point data type.
90 */
91 typedef int GLfixed;
92 /*
93 * Fixed point arithmetic macros
94 */
95 #ifndef FIXED_FRAC_BITS
96 #define FIXED_FRAC_BITS 11
97 #endif
98
99 #define FIXED_SHIFT FIXED_FRAC_BITS
100 #define FIXED_ONE (1 << FIXED_SHIFT)
101 #define FIXED_HALF (1 << (FIXED_SHIFT-1))
102 #define FIXED_FRAC_MASK (FIXED_ONE - 1)
103 #define FIXED_INT_MASK (~FIXED_FRAC_MASK)
104 #define FIXED_EPSILON 1
105 #define FIXED_SCALE ((float) FIXED_ONE)
106 #define FIXED_DBL_SCALE ((double) FIXED_ONE)
107 #define FloatToFixed(X) (IROUND((X) * FIXED_SCALE))
108 #define FixedToDouble(X) ((X) * (1.0 / FIXED_DBL_SCALE))
109 #define IntToFixed(I) ((I) << FIXED_SHIFT)
110 #define FixedToInt(X) ((X) >> FIXED_SHIFT)
111 #define FixedToUns(X) (((unsigned int)(X)) >> FIXED_SHIFT)
112 #define FixedCeil(X) (((X) + FIXED_ONE - FIXED_EPSILON) & FIXED_INT_MASK)
113 #define FixedFloor(X) ((X) & FIXED_INT_MASK)
114 #define FixedToFloat(X) ((X) * (1.0F / FIXED_SCALE))
115 #define PosFloatToFixed(X) FloatToFixed(X)
116 #define SignedFloatToFixed(X) FloatToFixed(X)
117
118
119
120 /**
121 * \name Some forward type declarations
122 */
123 /*@{*/
124 struct _mesa_HashTable;
125 struct gl_pixelstore_attrib;
126 struct gl_program_cache;
127 struct gl_texture_format;
128 struct gl_texture_image;
129 struct gl_texture_object;
130 struct st_context;
131 struct pipe_surface;
132 typedef struct __GLcontextRec GLcontext;
133 typedef struct __GLcontextModesRec GLvisual;
134 typedef struct gl_framebuffer GLframebuffer;
135 /*@}*/
136
137
138
139 /**
140 * Indexes for vertex program attributes.
141 * GL_NV_vertex_program aliases generic attributes over the conventional
142 * attributes. In GL_ARB_vertex_program shader the aliasing is optional.
143 * In GL_ARB_vertex_shader / OpenGL 2.0 the aliasing is disallowed (the
144 * generic attributes are distinct/separate).
145 */
146 enum
147 {
148 VERT_ATTRIB_POS = 0,
149 VERT_ATTRIB_WEIGHT = 1,
150 VERT_ATTRIB_NORMAL = 2,
151 VERT_ATTRIB_COLOR0 = 3,
152 VERT_ATTRIB_COLOR1 = 4,
153 VERT_ATTRIB_FOG = 5,
154 VERT_ATTRIB_COLOR_INDEX = 6,
155 VERT_ATTRIB_EDGEFLAG = 7,
156 VERT_ATTRIB_TEX0 = 8,
157 VERT_ATTRIB_TEX1 = 9,
158 VERT_ATTRIB_TEX2 = 10,
159 VERT_ATTRIB_TEX3 = 11,
160 VERT_ATTRIB_TEX4 = 12,
161 VERT_ATTRIB_TEX5 = 13,
162 VERT_ATTRIB_TEX6 = 14,
163 VERT_ATTRIB_TEX7 = 15,
164 VERT_ATTRIB_GENERIC0 = 16,
165 VERT_ATTRIB_GENERIC1 = 17,
166 VERT_ATTRIB_GENERIC2 = 18,
167 VERT_ATTRIB_GENERIC3 = 19,
168 VERT_ATTRIB_GENERIC4 = 20,
169 VERT_ATTRIB_GENERIC5 = 21,
170 VERT_ATTRIB_GENERIC6 = 22,
171 VERT_ATTRIB_GENERIC7 = 23,
172 VERT_ATTRIB_GENERIC8 = 24,
173 VERT_ATTRIB_GENERIC9 = 25,
174 VERT_ATTRIB_GENERIC10 = 26,
175 VERT_ATTRIB_GENERIC11 = 27,
176 VERT_ATTRIB_GENERIC12 = 28,
177 VERT_ATTRIB_GENERIC13 = 29,
178 VERT_ATTRIB_GENERIC14 = 30,
179 VERT_ATTRIB_GENERIC15 = 31,
180 VERT_ATTRIB_MAX = 32
181 };
182
183 /**
184 * Bitflags for vertex attributes.
185 * These are used in bitfields in many places.
186 */
187 /*@{*/
188 #define VERT_BIT_POS (1 << VERT_ATTRIB_POS)
189 #define VERT_BIT_WEIGHT (1 << VERT_ATTRIB_WEIGHT)
190 #define VERT_BIT_NORMAL (1 << VERT_ATTRIB_NORMAL)
191 #define VERT_BIT_COLOR0 (1 << VERT_ATTRIB_COLOR0)
192 #define VERT_BIT_COLOR1 (1 << VERT_ATTRIB_COLOR1)
193 #define VERT_BIT_FOG (1 << VERT_ATTRIB_FOG)
194 #define VERT_BIT_COLOR_INDEX (1 << VERT_ATTRIB_COLOR_INDEX)
195 #define VERT_BIT_EDGEFLAG (1 << VERT_ATTRIB_EDGEFLAG)
196 #define VERT_BIT_TEX0 (1 << VERT_ATTRIB_TEX0)
197 #define VERT_BIT_TEX1 (1 << VERT_ATTRIB_TEX1)
198 #define VERT_BIT_TEX2 (1 << VERT_ATTRIB_TEX2)
199 #define VERT_BIT_TEX3 (1 << VERT_ATTRIB_TEX3)
200 #define VERT_BIT_TEX4 (1 << VERT_ATTRIB_TEX4)
201 #define VERT_BIT_TEX5 (1 << VERT_ATTRIB_TEX5)
202 #define VERT_BIT_TEX6 (1 << VERT_ATTRIB_TEX6)
203 #define VERT_BIT_TEX7 (1 << VERT_ATTRIB_TEX7)
204 #define VERT_BIT_GENERIC0 (1 << VERT_ATTRIB_GENERIC0)
205 #define VERT_BIT_GENERIC1 (1 << VERT_ATTRIB_GENERIC1)
206 #define VERT_BIT_GENERIC2 (1 << VERT_ATTRIB_GENERIC2)
207 #define VERT_BIT_GENERIC3 (1 << VERT_ATTRIB_GENERIC3)
208 #define VERT_BIT_GENERIC4 (1 << VERT_ATTRIB_GENERIC4)
209 #define VERT_BIT_GENERIC5 (1 << VERT_ATTRIB_GENERIC5)
210 #define VERT_BIT_GENERIC6 (1 << VERT_ATTRIB_GENERIC6)
211 #define VERT_BIT_GENERIC7 (1 << VERT_ATTRIB_GENERIC7)
212 #define VERT_BIT_GENERIC8 (1 << VERT_ATTRIB_GENERIC8)
213 #define VERT_BIT_GENERIC9 (1 << VERT_ATTRIB_GENERIC9)
214 #define VERT_BIT_GENERIC10 (1 << VERT_ATTRIB_GENERIC10)
215 #define VERT_BIT_GENERIC11 (1 << VERT_ATTRIB_GENERIC11)
216 #define VERT_BIT_GENERIC12 (1 << VERT_ATTRIB_GENERIC12)
217 #define VERT_BIT_GENERIC13 (1 << VERT_ATTRIB_GENERIC13)
218 #define VERT_BIT_GENERIC14 (1 << VERT_ATTRIB_GENERIC14)
219 #define VERT_BIT_GENERIC15 (1 << VERT_ATTRIB_GENERIC15)
220
221 #define VERT_BIT_TEX(u) (1 << (VERT_ATTRIB_TEX0 + (u)))
222 #define VERT_BIT_GENERIC(g) (1 << (VERT_ATTRIB_GENERIC0 + (g)))
223 /*@}*/
224
225
226 /**
227 * Indexes for vertex program result attributes
228 */
229 /*@{*/
230 #define VERT_RESULT_HPOS 0
231 #define VERT_RESULT_COL0 1
232 #define VERT_RESULT_COL1 2
233 #define VERT_RESULT_FOGC 3
234 #define VERT_RESULT_TEX0 4
235 #define VERT_RESULT_TEX1 5
236 #define VERT_RESULT_TEX2 6
237 #define VERT_RESULT_TEX3 7
238 #define VERT_RESULT_TEX4 8
239 #define VERT_RESULT_TEX5 9
240 #define VERT_RESULT_TEX6 10
241 #define VERT_RESULT_TEX7 11
242 #define VERT_RESULT_PSIZ 12
243 #define VERT_RESULT_BFC0 13
244 #define VERT_RESULT_BFC1 14
245 #define VERT_RESULT_EDGE 15
246 #define VERT_RESULT_VAR0 16 /**< shader varying */
247 #define VERT_RESULT_MAX (VERT_RESULT_VAR0 + MAX_VARYING)
248 /*@}*/
249
250
251 /**
252 * Indexes for fragment program input attributes.
253 */
254 enum
255 {
256 FRAG_ATTRIB_WPOS = 0,
257 FRAG_ATTRIB_COL0 = 1,
258 FRAG_ATTRIB_COL1 = 2,
259 FRAG_ATTRIB_FOGC = 3,
260 FRAG_ATTRIB_TEX0 = 4,
261 FRAG_ATTRIB_TEX1 = 5,
262 FRAG_ATTRIB_TEX2 = 6,
263 FRAG_ATTRIB_TEX3 = 7,
264 FRAG_ATTRIB_TEX4 = 8,
265 FRAG_ATTRIB_TEX5 = 9,
266 FRAG_ATTRIB_TEX6 = 10,
267 FRAG_ATTRIB_TEX7 = 11,
268 FRAG_ATTRIB_VAR0 = 12, /**< shader varying */
269 FRAG_ATTRIB_MAX = (FRAG_ATTRIB_VAR0 + MAX_VARYING)
270 };
271
272 /**
273 * Bitflags for fragment program input attributes.
274 */
275 /*@{*/
276 #define FRAG_BIT_WPOS (1 << FRAG_ATTRIB_WPOS)
277 #define FRAG_BIT_COL0 (1 << FRAG_ATTRIB_COL0)
278 #define FRAG_BIT_COL1 (1 << FRAG_ATTRIB_COL1)
279 #define FRAG_BIT_FOGC (1 << FRAG_ATTRIB_FOGC)
280 #define FRAG_BIT_TEX0 (1 << FRAG_ATTRIB_TEX0)
281 #define FRAG_BIT_TEX1 (1 << FRAG_ATTRIB_TEX1)
282 #define FRAG_BIT_TEX2 (1 << FRAG_ATTRIB_TEX2)
283 #define FRAG_BIT_TEX3 (1 << FRAG_ATTRIB_TEX3)
284 #define FRAG_BIT_TEX4 (1 << FRAG_ATTRIB_TEX4)
285 #define FRAG_BIT_TEX5 (1 << FRAG_ATTRIB_TEX5)
286 #define FRAG_BIT_TEX6 (1 << FRAG_ATTRIB_TEX6)
287 #define FRAG_BIT_TEX7 (1 << FRAG_ATTRIB_TEX7)
288 #define FRAG_BIT_VAR0 (1 << FRAG_ATTRIB_VAR0)
289
290 #define FRAG_BIT_TEX(U) (FRAG_BIT_TEX0 << (U))
291 #define FRAG_BIT_VAR(V) (FRAG_BIT_VAR0 << (V))
292
293 #define FRAG_BITS_TEX_ANY (FRAG_BIT_TEX0| \
294 FRAG_BIT_TEX1| \
295 FRAG_BIT_TEX2| \
296 FRAG_BIT_TEX3| \
297 FRAG_BIT_TEX4| \
298 FRAG_BIT_TEX5| \
299 FRAG_BIT_TEX6| \
300 FRAG_BIT_TEX7)
301 /*@}*/
302
303
304 /**
305 * Fragment program results
306 */
307 enum
308 {
309 FRAG_RESULT_COLR = 0,
310 FRAG_RESULT_COLH = 1,
311 FRAG_RESULT_DEPR = 2,
312 FRAG_RESULT_DATA0 = 3,
313 FRAG_RESULT_MAX = (FRAG_RESULT_DATA0 + MAX_DRAW_BUFFERS)
314 };
315
316
317 /**
318 * Indexes for all renderbuffers
319 */
320 enum {
321 BUFFER_FRONT_LEFT = 0, /* the four standard color buffers */
322 BUFFER_BACK_LEFT = 1,
323 BUFFER_FRONT_RIGHT = 2,
324 BUFFER_BACK_RIGHT = 3,
325 BUFFER_AUX0 = 4, /* optional aux buffer */
326 BUFFER_AUX1 = 5,
327 BUFFER_AUX2 = 6,
328 BUFFER_AUX3 = 7,
329 BUFFER_DEPTH = 8,
330 BUFFER_STENCIL = 9,
331 BUFFER_ACCUM = 10,
332 BUFFER_COLOR0 = 11, /* generic renderbuffers */
333 BUFFER_COLOR1 = 12,
334 BUFFER_COLOR2 = 13,
335 BUFFER_COLOR3 = 14,
336 BUFFER_COLOR4 = 15,
337 BUFFER_COLOR5 = 16,
338 BUFFER_COLOR6 = 17,
339 BUFFER_COLOR7 = 18,
340 BUFFER_COUNT = 19
341 };
342
343 /**
344 * Bit flags for all renderbuffers
345 */
346 #define BUFFER_BIT_FRONT_LEFT (1 << BUFFER_FRONT_LEFT)
347 #define BUFFER_BIT_BACK_LEFT (1 << BUFFER_BACK_LEFT)
348 #define BUFFER_BIT_FRONT_RIGHT (1 << BUFFER_FRONT_RIGHT)
349 #define BUFFER_BIT_BACK_RIGHT (1 << BUFFER_BACK_RIGHT)
350 #define BUFFER_BIT_AUX0 (1 << BUFFER_AUX0)
351 #define BUFFER_BIT_AUX1 (1 << BUFFER_AUX1)
352 #define BUFFER_BIT_AUX2 (1 << BUFFER_AUX2)
353 #define BUFFER_BIT_AUX3 (1 << BUFFER_AUX3)
354 #define BUFFER_BIT_DEPTH (1 << BUFFER_DEPTH)
355 #define BUFFER_BIT_STENCIL (1 << BUFFER_STENCIL)
356 #define BUFFER_BIT_ACCUM (1 << BUFFER_ACCUM)
357 #define BUFFER_BIT_COLOR0 (1 << BUFFER_COLOR0)
358 #define BUFFER_BIT_COLOR1 (1 << BUFFER_COLOR1)
359 #define BUFFER_BIT_COLOR2 (1 << BUFFER_COLOR2)
360 #define BUFFER_BIT_COLOR3 (1 << BUFFER_COLOR3)
361 #define BUFFER_BIT_COLOR4 (1 << BUFFER_COLOR4)
362 #define BUFFER_BIT_COLOR5 (1 << BUFFER_COLOR5)
363 #define BUFFER_BIT_COLOR6 (1 << BUFFER_COLOR6)
364 #define BUFFER_BIT_COLOR7 (1 << BUFFER_COLOR7)
365
366 /**
367 * Mask of all the color buffer bits (but not accum).
368 */
369 #define BUFFER_BITS_COLOR (BUFFER_BIT_FRONT_LEFT | \
370 BUFFER_BIT_BACK_LEFT | \
371 BUFFER_BIT_FRONT_RIGHT | \
372 BUFFER_BIT_BACK_RIGHT | \
373 BUFFER_BIT_AUX0 | \
374 BUFFER_BIT_AUX1 | \
375 BUFFER_BIT_AUX2 | \
376 BUFFER_BIT_AUX3 | \
377 BUFFER_BIT_COLOR0 | \
378 BUFFER_BIT_COLOR1 | \
379 BUFFER_BIT_COLOR2 | \
380 BUFFER_BIT_COLOR3 | \
381 BUFFER_BIT_COLOR4 | \
382 BUFFER_BIT_COLOR5 | \
383 BUFFER_BIT_COLOR6 | \
384 BUFFER_BIT_COLOR7)
385
386
387 /** The pixel transfer path has three color tables: */
388 /*@{*/
389 #define COLORTABLE_PRECONVOLUTION 0
390 #define COLORTABLE_POSTCONVOLUTION 1
391 #define COLORTABLE_POSTCOLORMATRIX 2
392 #define COLORTABLE_MAX 3
393 /*@}*/
394
395
396 /**
397 * Data structure for color tables
398 */
399 struct gl_color_table
400 {
401 GLenum InternalFormat; /**< The user-specified format */
402 GLenum _BaseFormat; /**< GL_ALPHA, GL_RGBA, GL_RGB, etc */
403 GLuint Size; /**< number of entries in table */
404 GLfloat *TableF; /**< Color table, floating point values */
405 GLubyte *TableUB; /**< Color table, ubyte values */
406 GLubyte RedSize;
407 GLubyte GreenSize;
408 GLubyte BlueSize;
409 GLubyte AlphaSize;
410 GLubyte LuminanceSize;
411 GLubyte IntensitySize;
412 };
413
414
415 /**
416 * \name Bit flags used for updating material values.
417 */
418 /*@{*/
419 #define MAT_ATTRIB_FRONT_AMBIENT 0
420 #define MAT_ATTRIB_BACK_AMBIENT 1
421 #define MAT_ATTRIB_FRONT_DIFFUSE 2
422 #define MAT_ATTRIB_BACK_DIFFUSE 3
423 #define MAT_ATTRIB_FRONT_SPECULAR 4
424 #define MAT_ATTRIB_BACK_SPECULAR 5
425 #define MAT_ATTRIB_FRONT_EMISSION 6
426 #define MAT_ATTRIB_BACK_EMISSION 7
427 #define MAT_ATTRIB_FRONT_SHININESS 8
428 #define MAT_ATTRIB_BACK_SHININESS 9
429 #define MAT_ATTRIB_FRONT_INDEXES 10
430 #define MAT_ATTRIB_BACK_INDEXES 11
431 #define MAT_ATTRIB_MAX 12
432
433 #define MAT_ATTRIB_AMBIENT(f) (MAT_ATTRIB_FRONT_AMBIENT+(f))
434 #define MAT_ATTRIB_DIFFUSE(f) (MAT_ATTRIB_FRONT_DIFFUSE+(f))
435 #define MAT_ATTRIB_SPECULAR(f) (MAT_ATTRIB_FRONT_SPECULAR+(f))
436 #define MAT_ATTRIB_EMISSION(f) (MAT_ATTRIB_FRONT_EMISSION+(f))
437 #define MAT_ATTRIB_SHININESS(f)(MAT_ATTRIB_FRONT_SHININESS+(f))
438 #define MAT_ATTRIB_INDEXES(f) (MAT_ATTRIB_FRONT_INDEXES+(f))
439
440 #define MAT_INDEX_AMBIENT 0
441 #define MAT_INDEX_DIFFUSE 1
442 #define MAT_INDEX_SPECULAR 2
443
444 #define MAT_BIT_FRONT_AMBIENT (1<<MAT_ATTRIB_FRONT_AMBIENT)
445 #define MAT_BIT_BACK_AMBIENT (1<<MAT_ATTRIB_BACK_AMBIENT)
446 #define MAT_BIT_FRONT_DIFFUSE (1<<MAT_ATTRIB_FRONT_DIFFUSE)
447 #define MAT_BIT_BACK_DIFFUSE (1<<MAT_ATTRIB_BACK_DIFFUSE)
448 #define MAT_BIT_FRONT_SPECULAR (1<<MAT_ATTRIB_FRONT_SPECULAR)
449 #define MAT_BIT_BACK_SPECULAR (1<<MAT_ATTRIB_BACK_SPECULAR)
450 #define MAT_BIT_FRONT_EMISSION (1<<MAT_ATTRIB_FRONT_EMISSION)
451 #define MAT_BIT_BACK_EMISSION (1<<MAT_ATTRIB_BACK_EMISSION)
452 #define MAT_BIT_FRONT_SHININESS (1<<MAT_ATTRIB_FRONT_SHININESS)
453 #define MAT_BIT_BACK_SHININESS (1<<MAT_ATTRIB_BACK_SHININESS)
454 #define MAT_BIT_FRONT_INDEXES (1<<MAT_ATTRIB_FRONT_INDEXES)
455 #define MAT_BIT_BACK_INDEXES (1<<MAT_ATTRIB_BACK_INDEXES)
456
457
458 #define FRONT_MATERIAL_BITS (MAT_BIT_FRONT_EMISSION | \
459 MAT_BIT_FRONT_AMBIENT | \
460 MAT_BIT_FRONT_DIFFUSE | \
461 MAT_BIT_FRONT_SPECULAR | \
462 MAT_BIT_FRONT_SHININESS | \
463 MAT_BIT_FRONT_INDEXES)
464
465 #define BACK_MATERIAL_BITS (MAT_BIT_BACK_EMISSION | \
466 MAT_BIT_BACK_AMBIENT | \
467 MAT_BIT_BACK_DIFFUSE | \
468 MAT_BIT_BACK_SPECULAR | \
469 MAT_BIT_BACK_SHININESS | \
470 MAT_BIT_BACK_INDEXES)
471
472 #define ALL_MATERIAL_BITS (FRONT_MATERIAL_BITS | BACK_MATERIAL_BITS)
473 /*@}*/
474
475
476 #define EXP_TABLE_SIZE 512 /**< Specular exponent lookup table sizes */
477 #define SHINE_TABLE_SIZE 256 /**< Material shininess lookup table sizes */
478
479 /**
480 * Material shininess lookup table.
481 */
482 struct gl_shine_tab
483 {
484 struct gl_shine_tab *next, *prev;
485 GLfloat tab[SHINE_TABLE_SIZE+1];
486 GLfloat shininess;
487 GLuint refcount;
488 };
489
490
491 /**
492 * Light source state.
493 */
494 struct gl_light
495 {
496 struct gl_light *next; /**< double linked list with sentinel */
497 struct gl_light *prev;
498
499 GLfloat Ambient[4]; /**< ambient color */
500 GLfloat Diffuse[4]; /**< diffuse color */
501 GLfloat Specular[4]; /**< specular color */
502 GLfloat EyePosition[4]; /**< position in eye coordinates */
503 GLfloat EyeDirection[4]; /**< spotlight dir in eye coordinates */
504 GLfloat SpotExponent;
505 GLfloat SpotCutoff; /**< in degrees */
506 GLfloat _CosCutoffNeg; /**< = cos(SpotCutoff) */
507 GLfloat _CosCutoff; /**< = MAX(0, cos(SpotCutoff)) */
508 GLfloat ConstantAttenuation;
509 GLfloat LinearAttenuation;
510 GLfloat QuadraticAttenuation;
511 GLboolean Enabled; /**< On/off flag */
512
513 /**
514 * \name Derived fields
515 */
516 /*@{*/
517 GLbitfield _Flags; /**< State */
518
519 GLfloat _Position[4]; /**< position in eye/obj coordinates */
520 GLfloat _VP_inf_norm[3]; /**< Norm direction to infinite light */
521 GLfloat _h_inf_norm[3]; /**< Norm( _VP_inf_norm + <0,0,1> ) */
522 GLfloat _NormDirection[4]; /**< normalized spotlight direction */
523 GLfloat _VP_inf_spot_attenuation;
524
525 GLfloat _SpotExpTable[EXP_TABLE_SIZE][2]; /**< to replace a pow() call */
526 GLfloat _MatAmbient[2][3]; /**< material ambient * light ambient */
527 GLfloat _MatDiffuse[2][3]; /**< material diffuse * light diffuse */
528 GLfloat _MatSpecular[2][3]; /**< material spec * light specular */
529 GLfloat _dli; /**< CI diffuse light intensity */
530 GLfloat _sli; /**< CI specular light intensity */
531 /*@}*/
532 };
533
534
535 /**
536 * Light model state.
537 */
538 struct gl_lightmodel
539 {
540 GLfloat Ambient[4]; /**< ambient color */
541 GLboolean LocalViewer; /**< Local (or infinite) view point? */
542 GLboolean TwoSide; /**< Two (or one) sided lighting? */
543 GLenum ColorControl; /**< either GL_SINGLE_COLOR
544 * or GL_SEPARATE_SPECULAR_COLOR */
545 };
546
547
548 /**
549 * Material state.
550 */
551 struct gl_material
552 {
553 GLfloat Attrib[MAT_ATTRIB_MAX][4];
554 };
555
556
557 /**
558 * Accumulation buffer attribute group (GL_ACCUM_BUFFER_BIT)
559 */
560 struct gl_accum_attrib
561 {
562 GLfloat ClearColor[4]; /**< Accumulation buffer clear color */
563 };
564
565
566 /**
567 * Color buffer attribute group (GL_COLOR_BUFFER_BIT).
568 */
569 struct gl_colorbuffer_attrib
570 {
571 GLuint ClearIndex; /**< Index to use for glClear */
572 GLclampf ClearColor[4]; /**< Color to use for glClear */
573
574 GLuint IndexMask; /**< Color index write mask */
575 GLubyte ColorMask[4]; /**< Each flag is 0xff or 0x0 */
576
577 GLenum DrawBuffer[MAX_DRAW_BUFFERS]; /**< Which buffer to draw into */
578
579 /**
580 * \name alpha testing
581 */
582 /*@{*/
583 GLboolean AlphaEnabled; /**< Alpha test enabled flag */
584 GLenum AlphaFunc; /**< Alpha test function */
585 GLclampf AlphaRef; /**< Alpha reference value */
586 /*@}*/
587
588 /**
589 * \name Blending
590 */
591 /*@{*/
592 GLboolean BlendEnabled; /**< Blending enabled flag */
593 GLenum BlendSrcRGB; /**< Blending source operator */
594 GLenum BlendDstRGB; /**< Blending destination operator */
595 GLenum BlendSrcA; /**< GL_INGR_blend_func_separate */
596 GLenum BlendDstA; /**< GL_INGR_blend_func_separate */
597 GLenum BlendEquationRGB; /**< Blending equation */
598 GLenum BlendEquationA; /**< GL_EXT_blend_equation_separate */
599 GLfloat BlendColor[4]; /**< Blending color */
600 /*@}*/
601
602 /**
603 * \name Logic op
604 */
605 /*@{*/
606 GLenum LogicOp; /**< Logic operator */
607 GLboolean IndexLogicOpEnabled; /**< Color index logic op enabled flag */
608 GLboolean ColorLogicOpEnabled; /**< RGBA logic op enabled flag */
609 GLboolean _LogicOpEnabled; /**< RGBA logic op + EXT_blend_logic_op enabled flag */
610 /*@}*/
611
612 GLboolean DitherFlag; /**< Dither enable flag */
613
614 GLenum ClampFragmentColor; /**< GL_TRUE, GL_FALSE or GL_FIXED_ONLY_ARB */
615 GLenum ClampReadColor; /**< GL_TRUE, GL_FALSE or GL_FIXED_ONLY_ARB */
616 };
617
618
619 /**
620 * Current attribute group (GL_CURRENT_BIT).
621 */
622 struct gl_current_attrib
623 {
624 /**
625 * \name Current vertex attributes.
626 * \note Values are valid only after FLUSH_VERTICES has been called.
627 * \note Index and Edgeflag current values are stored as floats in the
628 * SIX and SEVEN attribute slots.
629 */
630 /*@{*/
631 GLfloat Attrib[VERT_ATTRIB_MAX][4]; /**< Position, color, texcoords, etc */
632 /*@}*/
633
634 /**
635 * \name Current raster position attributes (always valid).
636 * \note This set of attributes is very similar to the SWvertex struct.
637 */
638 /*@{*/
639 GLfloat RasterPos[4];
640 GLfloat RasterDistance;
641 GLfloat RasterColor[4];
642 GLfloat RasterSecondaryColor[4];
643 GLfloat RasterIndex;
644 GLfloat RasterTexCoords[MAX_TEXTURE_COORD_UNITS][4];
645 GLboolean RasterPosValid;
646 /*@}*/
647 };
648
649
650 /**
651 * Depth buffer attribute group (GL_DEPTH_BUFFER_BIT).
652 */
653 struct gl_depthbuffer_attrib
654 {
655 GLenum Func; /**< Function for depth buffer compare */
656 GLclampd Clear; /**< Value to clear depth buffer to */
657 GLboolean Test; /**< Depth buffering enabled flag */
658 GLboolean Mask; /**< Depth buffer writable? */
659 GLboolean BoundsTest; /**< GL_EXT_depth_bounds_test */
660 GLfloat BoundsMin, BoundsMax;/**< GL_EXT_depth_bounds_test */
661 };
662
663
664 /**
665 * glEnable()/glDisable() attribute group (GL_ENABLE_BIT).
666 */
667 struct gl_enable_attrib
668 {
669 GLboolean AlphaTest;
670 GLboolean AutoNormal;
671 GLboolean Blend;
672 GLbitfield ClipPlanes;
673 GLboolean ColorMaterial;
674 GLboolean ColorTable[COLORTABLE_MAX];
675 GLboolean Convolution1D;
676 GLboolean Convolution2D;
677 GLboolean Separable2D;
678 GLboolean CullFace;
679 GLboolean DepthTest;
680 GLboolean Dither;
681 GLboolean Fog;
682 GLboolean Histogram;
683 GLboolean Light[MAX_LIGHTS];
684 GLboolean Lighting;
685 GLboolean LineSmooth;
686 GLboolean LineStipple;
687 GLboolean IndexLogicOp;
688 GLboolean ColorLogicOp;
689 GLboolean Map1Color4;
690 GLboolean Map1Index;
691 GLboolean Map1Normal;
692 GLboolean Map1TextureCoord1;
693 GLboolean Map1TextureCoord2;
694 GLboolean Map1TextureCoord3;
695 GLboolean Map1TextureCoord4;
696 GLboolean Map1Vertex3;
697 GLboolean Map1Vertex4;
698 GLboolean Map1Attrib[16]; /* GL_NV_vertex_program */
699 GLboolean Map2Color4;
700 GLboolean Map2Index;
701 GLboolean Map2Normal;
702 GLboolean Map2TextureCoord1;
703 GLboolean Map2TextureCoord2;
704 GLboolean Map2TextureCoord3;
705 GLboolean Map2TextureCoord4;
706 GLboolean Map2Vertex3;
707 GLboolean Map2Vertex4;
708 GLboolean Map2Attrib[16]; /* GL_NV_vertex_program */
709 GLboolean MinMax;
710 GLboolean Normalize;
711 GLboolean PixelTexture;
712 GLboolean PointSmooth;
713 GLboolean PolygonOffsetPoint;
714 GLboolean PolygonOffsetLine;
715 GLboolean PolygonOffsetFill;
716 GLboolean PolygonSmooth;
717 GLboolean PolygonStipple;
718 GLboolean RescaleNormals;
719 GLboolean Scissor;
720 GLboolean Stencil;
721 GLboolean StencilTwoSide; /* GL_EXT_stencil_two_side */
722 GLboolean MultisampleEnabled; /* GL_ARB_multisample */
723 GLboolean SampleAlphaToCoverage; /* GL_ARB_multisample */
724 GLboolean SampleAlphaToOne; /* GL_ARB_multisample */
725 GLboolean SampleCoverage; /* GL_ARB_multisample */
726 GLboolean SampleCoverageInvert; /* GL_ARB_multisample */
727 GLboolean RasterPositionUnclipped; /* GL_IBM_rasterpos_clip */
728 GLuint Texture[MAX_TEXTURE_IMAGE_UNITS];
729 GLuint TexGen[MAX_TEXTURE_COORD_UNITS];
730 /* SGI_texture_color_table */
731 GLboolean TextureColorTable[MAX_TEXTURE_IMAGE_UNITS];
732 /* GL_ARB_vertex_program / GL_NV_vertex_program */
733 GLboolean VertexProgram;
734 GLboolean VertexProgramPointSize;
735 GLboolean VertexProgramTwoSide;
736 /* GL_ARB_point_sprite / GL_NV_point_sprite */
737 GLboolean PointSprite;
738 GLboolean FragmentShaderATI;
739 };
740
741
742 /**
743 * Evaluator attribute group (GL_EVAL_BIT).
744 */
745 struct gl_eval_attrib
746 {
747 /**
748 * \name Enable bits
749 */
750 /*@{*/
751 GLboolean Map1Color4;
752 GLboolean Map1Index;
753 GLboolean Map1Normal;
754 GLboolean Map1TextureCoord1;
755 GLboolean Map1TextureCoord2;
756 GLboolean Map1TextureCoord3;
757 GLboolean Map1TextureCoord4;
758 GLboolean Map1Vertex3;
759 GLboolean Map1Vertex4;
760 GLboolean Map1Attrib[16]; /* GL_NV_vertex_program */
761 GLboolean Map2Color4;
762 GLboolean Map2Index;
763 GLboolean Map2Normal;
764 GLboolean Map2TextureCoord1;
765 GLboolean Map2TextureCoord2;
766 GLboolean Map2TextureCoord3;
767 GLboolean Map2TextureCoord4;
768 GLboolean Map2Vertex3;
769 GLboolean Map2Vertex4;
770 GLboolean Map2Attrib[16]; /* GL_NV_vertex_program */
771 GLboolean AutoNormal;
772 /*@}*/
773
774 /**
775 * \name Map Grid endpoints and divisions and calculated du values
776 */
777 /*@{*/
778 GLint MapGrid1un;
779 GLfloat MapGrid1u1, MapGrid1u2, MapGrid1du;
780 GLint MapGrid2un, MapGrid2vn;
781 GLfloat MapGrid2u1, MapGrid2u2, MapGrid2du;
782 GLfloat MapGrid2v1, MapGrid2v2, MapGrid2dv;
783 /*@}*/
784 };
785
786
787 /**
788 * Fog attribute group (GL_FOG_BIT).
789 */
790 struct gl_fog_attrib
791 {
792 GLboolean Enabled; /**< Fog enabled flag */
793 GLfloat Color[4]; /**< Fog color */
794 GLfloat Density; /**< Density >= 0.0 */
795 GLfloat Start; /**< Start distance in eye coords */
796 GLfloat End; /**< End distance in eye coords */
797 GLfloat Index; /**< Fog index */
798 GLenum Mode; /**< Fog mode */
799 GLboolean ColorSumEnabled;
800 GLenum FogCoordinateSource; /**< GL_EXT_fog_coord */
801 GLfloat _Scale; /**< (End == Start) ? 1.0 : 1.0 / (End - Start) */
802 };
803
804
805 /**
806 * Hint attribute group (GL_HINT_BIT).
807 *
808 * Values are always one of GL_FASTEST, GL_NICEST, or GL_DONT_CARE.
809 */
810 struct gl_hint_attrib
811 {
812 GLenum PerspectiveCorrection;
813 GLenum PointSmooth;
814 GLenum LineSmooth;
815 GLenum PolygonSmooth;
816 GLenum Fog;
817 GLenum ClipVolumeClipping; /**< GL_EXT_clip_volume_hint */
818 GLenum TextureCompression; /**< GL_ARB_texture_compression */
819 GLenum GenerateMipmap; /**< GL_SGIS_generate_mipmap */
820 GLenum FragmentShaderDerivative; /**< GL_ARB_fragment_shader */
821 };
822
823
824 /**
825 * Histogram attributes.
826 */
827 struct gl_histogram_attrib
828 {
829 GLuint Width; /**< number of table entries */
830 GLint Format; /**< GL_ALPHA, GL_RGB, etc */
831 GLuint Count[HISTOGRAM_TABLE_SIZE][4]; /**< the histogram */
832 GLboolean Sink; /**< terminate image transfer? */
833 GLubyte RedSize; /**< Bits per counter */
834 GLubyte GreenSize;
835 GLubyte BlueSize;
836 GLubyte AlphaSize;
837 GLubyte LuminanceSize;
838 };
839
840
841 /**
842 * Color Min/max state.
843 */
844 struct gl_minmax_attrib
845 {
846 GLenum Format;
847 GLboolean Sink;
848 GLfloat Min[4], Max[4]; /**< RGBA */
849 };
850
851
852 /**
853 * Image convolution state.
854 */
855 struct gl_convolution_attrib
856 {
857 GLenum Format;
858 GLenum InternalFormat;
859 GLuint Width;
860 GLuint Height;
861 GLfloat Filter[MAX_CONVOLUTION_WIDTH * MAX_CONVOLUTION_HEIGHT * 4];
862 };
863
864
865 /**
866 * Light state flags.
867 */
868 /*@{*/
869 #define LIGHT_SPOT 0x1
870 #define LIGHT_LOCAL_VIEWER 0x2
871 #define LIGHT_POSITIONAL 0x4
872 #define LIGHT_NEED_VERTICES (LIGHT_POSITIONAL|LIGHT_LOCAL_VIEWER)
873 /*@}*/
874
875
876 /**
877 * Lighting attribute group (GL_LIGHT_BIT).
878 */
879 struct gl_light_attrib
880 {
881 struct gl_light Light[MAX_LIGHTS]; /**< Array of light sources */
882 struct gl_lightmodel Model; /**< Lighting model */
883
884 /**
885 * Must flush FLUSH_VERTICES before referencing:
886 */
887 /*@{*/
888 struct gl_material Material; /**< Includes front & back values */
889 /*@}*/
890
891 GLboolean Enabled; /**< Lighting enabled flag */
892 GLenum ShadeModel; /**< GL_FLAT or GL_SMOOTH */
893 GLenum ColorMaterialFace; /**< GL_FRONT, BACK or FRONT_AND_BACK */
894 GLenum ColorMaterialMode; /**< GL_AMBIENT, GL_DIFFUSE, etc */
895 GLbitfield ColorMaterialBitmask; /**< bitmask formed from Face and Mode */
896 GLboolean ColorMaterialEnabled;
897 GLenum ClampVertexColor;
898
899 struct gl_light EnabledList; /**< List sentinel */
900
901 /**
902 * Derived state for optimizations:
903 */
904 /*@{*/
905 GLboolean _NeedEyeCoords;
906 GLboolean _NeedVertices; /**< Use fast shader? */
907 GLbitfield _Flags; /**< LIGHT_* flags, see above */
908 GLfloat _BaseColor[2][3];
909 /*@}*/
910 };
911
912
913 /**
914 * Line attribute group (GL_LINE_BIT).
915 */
916 struct gl_line_attrib
917 {
918 GLboolean SmoothFlag; /**< GL_LINE_SMOOTH enabled? */
919 GLboolean StippleFlag; /**< GL_LINE_STIPPLE enabled? */
920 GLushort StipplePattern; /**< Stipple pattern */
921 GLint StippleFactor; /**< Stipple repeat factor */
922 GLfloat Width; /**< Line width */
923 };
924
925
926 /**
927 * Display list attribute group (GL_LIST_BIT).
928 */
929 struct gl_list_attrib
930 {
931 GLuint ListBase;
932 };
933
934
935 /**
936 * Used by device drivers to hook new commands into display lists.
937 */
938 struct gl_list_instruction
939 {
940 GLuint Size;
941 void (*Execute)( GLcontext *ctx, void *data );
942 void (*Destroy)( GLcontext *ctx, void *data );
943 void (*Print)( GLcontext *ctx, void *data );
944 };
945
946 #define MAX_DLIST_EXT_OPCODES 16
947
948 /**
949 * Used by device drivers to hook new commands into display lists.
950 */
951 struct gl_list_extensions
952 {
953 struct gl_list_instruction Opcode[MAX_DLIST_EXT_OPCODES];
954 GLuint NumOpcodes;
955 };
956
957
958 /**
959 * Multisample attribute group (GL_MULTISAMPLE_BIT).
960 */
961 struct gl_multisample_attrib
962 {
963 GLboolean Enabled;
964 GLboolean SampleAlphaToCoverage;
965 GLboolean SampleAlphaToOne;
966 GLboolean SampleCoverage;
967 GLfloat SampleCoverageValue;
968 GLboolean SampleCoverageInvert;
969 };
970
971
972 /**
973 * A pixelmap (see glPixelMap)
974 */
975 struct gl_pixelmap
976 {
977 GLint Size;
978 GLfloat Map[MAX_PIXEL_MAP_TABLE];
979 GLubyte Map8[MAX_PIXEL_MAP_TABLE]; /**< converted to 8-bit color */
980 };
981
982
983 /**
984 * Collection of all pixelmaps
985 */
986 struct gl_pixelmaps
987 {
988 struct gl_pixelmap RtoR; /**< i.e. GL_PIXEL_MAP_R_TO_R */
989 struct gl_pixelmap GtoG;
990 struct gl_pixelmap BtoB;
991 struct gl_pixelmap AtoA;
992 struct gl_pixelmap ItoR;
993 struct gl_pixelmap ItoG;
994 struct gl_pixelmap ItoB;
995 struct gl_pixelmap ItoA;
996 struct gl_pixelmap ItoI;
997 struct gl_pixelmap StoS;
998 };
999
1000
1001 /**
1002 * Pixel attribute group (GL_PIXEL_MODE_BIT).
1003 */
1004 struct gl_pixel_attrib
1005 {
1006 GLenum ReadBuffer; /**< source buffer for glRead/CopyPixels() */
1007
1008 /*--- Begin Pixel Transfer State ---*/
1009 /* Fields are in the order in which they're applied... */
1010
1011 /* Scale & Bias (index shift, offset) */
1012 GLfloat RedBias, RedScale;
1013 GLfloat GreenBias, GreenScale;
1014 GLfloat BlueBias, BlueScale;
1015 GLfloat AlphaBias, AlphaScale;
1016 GLfloat DepthBias, DepthScale;
1017 GLint IndexShift, IndexOffset;
1018
1019 /* Pixel Maps */
1020 /* Note: actual pixel maps are not part of this attrib group */
1021 GLboolean MapColorFlag;
1022 GLboolean MapStencilFlag;
1023
1024 /* There are multiple color table stages: */
1025 GLboolean ColorTableEnabled[COLORTABLE_MAX];
1026 GLfloat ColorTableScale[COLORTABLE_MAX][4]; /**< RGBA */
1027 GLfloat ColorTableBias[COLORTABLE_MAX][4]; /**< RGBA */
1028
1029 /* Convolution (GL_EXT_convolution) */
1030 GLboolean Convolution1DEnabled;
1031 GLboolean Convolution2DEnabled;
1032 GLboolean Separable2DEnabled;
1033 GLfloat ConvolutionBorderColor[3][4];
1034 GLenum ConvolutionBorderMode[3];
1035 GLfloat ConvolutionFilterScale[3][4]; /**< RGBA */
1036 GLfloat ConvolutionFilterBias[3][4]; /**< RGBA */
1037 GLfloat PostConvolutionScale[4]; /**< RGBA */
1038 GLfloat PostConvolutionBias[4]; /**< RGBA */
1039
1040 /* Color matrix (GL_SGI_color_matrix) */
1041 /* Note: the color matrix is not part of this attrib group */
1042 GLfloat PostColorMatrixScale[4]; /**< RGBA */
1043 GLfloat PostColorMatrixBias[4]; /**< RGBA */
1044
1045 /* Histogram & minmax (GL_EXT_histogram) */
1046 /* Note: histogram and minmax data are not part of this attrib group */
1047 GLboolean HistogramEnabled;
1048 GLboolean MinMaxEnabled;
1049
1050 /*--- End Pixel Transfer State ---*/
1051
1052 /* Pixel Zoom */
1053 GLfloat ZoomX, ZoomY;
1054
1055 /** GL_SGI_texture_color_table */
1056 GLfloat TextureColorTableScale[4];
1057 GLfloat TextureColorTableBias[4];
1058 };
1059
1060
1061 /**
1062 * Point attribute group (GL_POINT_BIT).
1063 */
1064 struct gl_point_attrib
1065 {
1066 GLboolean SmoothFlag; /**< True if GL_POINT_SMOOTH is enabled */
1067 GLfloat Size; /**< User-specified point size */
1068 GLfloat Params[3]; /**< GL_EXT_point_parameters */
1069 GLfloat MinSize, MaxSize; /**< GL_EXT_point_parameters */
1070 GLfloat Threshold; /**< GL_EXT_point_parameters */
1071 GLboolean _Attenuated; /**< True if Params != [1, 0, 0] */
1072 GLboolean PointSprite; /**< GL_NV/ARB_point_sprite */
1073 GLboolean CoordReplace[MAX_TEXTURE_COORD_UNITS]; /**< GL_ARB_point_sprite */
1074 GLenum SpriteRMode; /**< GL_NV_point_sprite (only!) */
1075 GLenum SpriteOrigin; /**< GL_ARB_point_sprite */
1076 };
1077
1078
1079 /**
1080 * Polygon attribute group (GL_POLYGON_BIT).
1081 */
1082 struct gl_polygon_attrib
1083 {
1084 GLenum FrontFace; /**< Either GL_CW or GL_CCW */
1085 GLenum FrontMode; /**< Either GL_POINT, GL_LINE or GL_FILL */
1086 GLenum BackMode; /**< Either GL_POINT, GL_LINE or GL_FILL */
1087 GLboolean _FrontBit; /**< 0=GL_CCW, 1=GL_CW */
1088 GLboolean CullFlag; /**< Culling on/off flag */
1089 GLboolean SmoothFlag; /**< True if GL_POLYGON_SMOOTH is enabled */
1090 GLboolean StippleFlag; /**< True if GL_POLYGON_STIPPLE is enabled */
1091 GLenum CullFaceMode; /**< Culling mode GL_FRONT or GL_BACK */
1092 GLfloat OffsetFactor; /**< Polygon offset factor, from user */
1093 GLfloat OffsetUnits; /**< Polygon offset units, from user */
1094 GLboolean OffsetPoint; /**< Offset in GL_POINT mode */
1095 GLboolean OffsetLine; /**< Offset in GL_LINE mode */
1096 GLboolean OffsetFill; /**< Offset in GL_FILL mode */
1097 };
1098
1099
1100 /**
1101 * Scissor attributes (GL_SCISSOR_BIT).
1102 */
1103 struct gl_scissor_attrib
1104 {
1105 GLboolean Enabled; /**< Scissor test enabled? */
1106 GLint X, Y; /**< Lower left corner of box */
1107 GLsizei Width, Height; /**< Size of box */
1108 };
1109
1110
1111 /**
1112 * Stencil attribute group (GL_STENCIL_BUFFER_BIT).
1113 */
1114 struct gl_stencil_attrib
1115 {
1116 GLboolean Enabled; /**< Enabled flag */
1117 GLboolean TestTwoSide; /**< GL_EXT_stencil_two_side */
1118 GLubyte ActiveFace; /**< GL_EXT_stencil_two_side (0 or 1) */
1119 GLboolean _TestTwoSide;
1120 GLenum Function[2]; /**< Stencil function */
1121 GLenum FailFunc[2]; /**< Fail function */
1122 GLenum ZPassFunc[2]; /**< Depth buffer pass function */
1123 GLenum ZFailFunc[2]; /**< Depth buffer fail function */
1124 GLint Ref[2]; /**< Reference value */
1125 GLuint ValueMask[2]; /**< Value mask */
1126 GLuint WriteMask[2]; /**< Write mask */
1127 GLuint Clear; /**< Clear value */
1128 };
1129
1130
1131 #define NUM_TEXTURE_TARGETS 7 /* 1D, 2D, 3D, CUBE, RECT, 1D_STACK, and 2D_STACK */
1132
1133 /**
1134 * An index for each type of texture object
1135 */
1136 /*@{*/
1137 #define TEXTURE_1D_INDEX 0
1138 #define TEXTURE_2D_INDEX 1
1139 #define TEXTURE_3D_INDEX 2
1140 #define TEXTURE_CUBE_INDEX 3
1141 #define TEXTURE_RECT_INDEX 4
1142 #define TEXTURE_1D_ARRAY_INDEX 5
1143 #define TEXTURE_2D_ARRAY_INDEX 6
1144 /*@}*/
1145
1146 /**
1147 * Bit flags for each type of texture object
1148 * Used for Texture.Unit[]._ReallyEnabled flags.
1149 */
1150 /*@{*/
1151 #define TEXTURE_1D_BIT (1 << TEXTURE_1D_INDEX)
1152 #define TEXTURE_2D_BIT (1 << TEXTURE_2D_INDEX)
1153 #define TEXTURE_3D_BIT (1 << TEXTURE_3D_INDEX)
1154 #define TEXTURE_CUBE_BIT (1 << TEXTURE_CUBE_INDEX)
1155 #define TEXTURE_RECT_BIT (1 << TEXTURE_RECT_INDEX)
1156 #define TEXTURE_1D_ARRAY_BIT (1 << TEXTURE_1D_ARRAY_INDEX)
1157 #define TEXTURE_2D_ARRAY_BIT (1 << TEXTURE_2D_ARRAY_INDEX)
1158 /*@}*/
1159
1160
1161 /**
1162 * TexGenEnabled flags.
1163 */
1164 /*@{*/
1165 #define S_BIT 1
1166 #define T_BIT 2
1167 #define R_BIT 4
1168 #define Q_BIT 8
1169 /*@}*/
1170
1171
1172 /**
1173 * Bit flag versions of the corresponding GL_ constants.
1174 */
1175 /*@{*/
1176 #define TEXGEN_SPHERE_MAP 0x1
1177 #define TEXGEN_OBJ_LINEAR 0x2
1178 #define TEXGEN_EYE_LINEAR 0x4
1179 #define TEXGEN_REFLECTION_MAP_NV 0x8
1180 #define TEXGEN_NORMAL_MAP_NV 0x10
1181
1182 #define TEXGEN_NEED_NORMALS (TEXGEN_SPHERE_MAP | \
1183 TEXGEN_REFLECTION_MAP_NV | \
1184 TEXGEN_NORMAL_MAP_NV)
1185 #define TEXGEN_NEED_EYE_COORD (TEXGEN_SPHERE_MAP | \
1186 TEXGEN_REFLECTION_MAP_NV | \
1187 TEXGEN_NORMAL_MAP_NV | \
1188 TEXGEN_EYE_LINEAR)
1189 /*@}*/
1190
1191
1192 /* A selection of state flags to make driver and module's lives easier. */
1193 #define ENABLE_TEXGEN0 0x1
1194 #define ENABLE_TEXGEN1 0x2
1195 #define ENABLE_TEXGEN2 0x4
1196 #define ENABLE_TEXGEN3 0x8
1197 #define ENABLE_TEXGEN4 0x10
1198 #define ENABLE_TEXGEN5 0x20
1199 #define ENABLE_TEXGEN6 0x40
1200 #define ENABLE_TEXGEN7 0x80
1201
1202 #define ENABLE_TEXMAT0 0x1 /* Ie. not the identity matrix */
1203 #define ENABLE_TEXMAT1 0x2
1204 #define ENABLE_TEXMAT2 0x4
1205 #define ENABLE_TEXMAT3 0x8
1206 #define ENABLE_TEXMAT4 0x10
1207 #define ENABLE_TEXMAT5 0x20
1208 #define ENABLE_TEXMAT6 0x40
1209 #define ENABLE_TEXMAT7 0x80
1210
1211 #define ENABLE_TEXGEN(i) (ENABLE_TEXGEN0 << (i))
1212 #define ENABLE_TEXMAT(i) (ENABLE_TEXMAT0 << (i))
1213
1214
1215 /**
1216 * Texel fetch function prototype. We use texel fetch functions to
1217 * extract RGBA, color indexes and depth components out of 1D, 2D and 3D
1218 * texture images. These functions help to isolate us from the gritty
1219 * details of all the various texture image encodings.
1220 *
1221 * \param texImage texture image.
1222 * \param col texel column.
1223 * \param row texel row.
1224 * \param img texel image level/layer.
1225 * \param texelOut output texel (up to 4 GLchans)
1226 */
1227 typedef void (*FetchTexelFuncC)( const struct gl_texture_image *texImage,
1228 GLint col, GLint row, GLint img,
1229 GLchan *texelOut );
1230
1231 /**
1232 * As above, but returns floats.
1233 * Used for depth component images and for upcoming signed/float
1234 * texture images.
1235 */
1236 typedef void (*FetchTexelFuncF)( const struct gl_texture_image *texImage,
1237 GLint col, GLint row, GLint img,
1238 GLfloat *texelOut );
1239
1240
1241 typedef void (*StoreTexelFunc)(struct gl_texture_image *texImage,
1242 GLint col, GLint row, GLint img,
1243 const void *texel);
1244
1245
1246 /**
1247 * This macro defines the (many) parameters to the texstore functions.
1248 * \param dims either 1 or 2 or 3
1249 * \param baseInternalFormat user-specified base internal format
1250 * \param dstFormat destination Mesa texture format
1251 * \param dstAddr destination image address
1252 * \param dstX/Y/Zoffset destination x/y/z offset (ala TexSubImage), in texels
1253 * \param dstRowStride destination image row stride, in bytes
1254 * \param dstImageOffsets offset of each 2D slice within 3D texture, in texels
1255 * \param srcWidth/Height/Depth source image size, in pixels
1256 * \param srcFormat incoming image format
1257 * \param srcType incoming image data type
1258 * \param srcAddr source image address
1259 * \param srcPacking source image packing parameters
1260 */
1261 #define TEXSTORE_PARAMS \
1262 GLcontext *ctx, GLuint dims, \
1263 GLenum baseInternalFormat, \
1264 const struct gl_texture_format *dstFormat, \
1265 GLvoid *dstAddr, \
1266 GLint dstXoffset, GLint dstYoffset, GLint dstZoffset, \
1267 GLint dstRowStride, const GLuint *dstImageOffsets, \
1268 GLint srcWidth, GLint srcHeight, GLint srcDepth, \
1269 GLenum srcFormat, GLenum srcType, \
1270 const GLvoid *srcAddr, \
1271 const struct gl_pixelstore_attrib *srcPacking
1272
1273
1274
1275 /**
1276 * Texture image storage function.
1277 */
1278 typedef GLboolean (*StoreTexImageFunc)(TEXSTORE_PARAMS);
1279
1280
1281 /**
1282 * Texture format record
1283 */
1284 struct gl_texture_format
1285 {
1286 GLint MesaFormat; /**< One of the MESA_FORMAT_* values */
1287
1288 GLenum BaseFormat; /**< Either GL_RGB, GL_RGBA, GL_ALPHA,
1289 * GL_LUMINANCE, GL_LUMINANCE_ALPHA,
1290 * GL_INTENSITY, GL_COLOR_INDEX or
1291 * GL_DEPTH_COMPONENT.
1292 */
1293 GLenum DataType; /**< GL_FLOAT or GL_UNSIGNED_NORMALIZED_ARB */
1294
1295 /**
1296 * Bits per texel component. These are just rough approximations
1297 * for compressed texture formats.
1298 */
1299 /*@{*/
1300 GLubyte RedBits;
1301 GLubyte GreenBits;
1302 GLubyte BlueBits;
1303 GLubyte AlphaBits;
1304 GLubyte LuminanceBits;
1305 GLubyte IntensityBits;
1306 GLubyte IndexBits;
1307 GLubyte DepthBits;
1308 GLubyte StencilBits; /**< GL_EXT_packed_depth_stencil */
1309 /*@}*/
1310
1311 GLuint TexelBytes; /**< Bytes per texel, 0 if compressed format */
1312
1313 StoreTexImageFunc StoreImage;
1314
1315 /**
1316 * \name Texel fetch function pointers
1317 */
1318 /*@{*/
1319 FetchTexelFuncC FetchTexel1D;
1320 FetchTexelFuncC FetchTexel2D;
1321 FetchTexelFuncC FetchTexel3D;
1322 FetchTexelFuncF FetchTexel1Df;
1323 FetchTexelFuncF FetchTexel2Df;
1324 FetchTexelFuncF FetchTexel3Df;
1325 /*@}*/
1326
1327 StoreTexelFunc StoreTexel;
1328 };
1329
1330
1331 /**
1332 * Texture image state. Describes the dimensions of a texture image,
1333 * the texel format and pointers to Texel Fetch functions.
1334 */
1335 struct gl_texture_image
1336 {
1337 GLenum _BaseFormat; /**< Either GL_RGB, GL_RGBA, GL_ALPHA,
1338 * GL_LUMINANCE, GL_LUMINANCE_ALPHA,
1339 * GL_INTENSITY, GL_COLOR_INDEX,
1340 * GL_DEPTH_COMPONENT or GL_DEPTH_STENCIL_EXT
1341 * only. Used for choosing TexEnv arithmetic.
1342 */
1343 GLint InternalFormat; /**< Internal format as given by the user */
1344 GLuint Border; /**< 0 or 1 */
1345 GLuint Width; /**< = 2^WidthLog2 + 2*Border */
1346 GLuint Height; /**< = 2^HeightLog2 + 2*Border */
1347 GLuint Depth; /**< = 2^DepthLog2 + 2*Border */
1348 GLuint Width2; /**< = Width - 2*Border */
1349 GLuint Height2; /**< = Height - 2*Border */
1350 GLuint Depth2; /**< = Depth - 2*Border */
1351 GLuint WidthLog2; /**< = log2(Width2) */
1352 GLuint HeightLog2; /**< = log2(Height2) */
1353 GLuint DepthLog2; /**< = log2(Depth2) */
1354 GLuint MaxLog2; /**< = MAX(WidthLog2, HeightLog2) */
1355 GLfloat WidthScale; /**< used for mipmap LOD computation */
1356 GLfloat HeightScale; /**< used for mipmap LOD computation */
1357 GLfloat DepthScale; /**< used for mipmap LOD computation */
1358 GLboolean IsClientData; /**< Data owned by client? */
1359 GLboolean _IsPowerOfTwo; /**< Are all dimensions powers of two? */
1360
1361 const struct gl_texture_format *TexFormat;
1362
1363 struct gl_texture_object *TexObject; /**< Pointer back to parent object */
1364
1365 FetchTexelFuncC FetchTexelc; /**< GLchan texel fetch function pointer */
1366 FetchTexelFuncF FetchTexelf; /**< Float texel fetch function pointer */
1367
1368 GLboolean IsCompressed; /**< GL_ARB_texture_compression */
1369 GLuint CompressedSize; /**< GL_ARB_texture_compression */
1370
1371 GLuint RowStride; /**< == Width unless IsClientData and padded */
1372 GLuint *ImageOffsets; /**< if 3D texture: array [Depth] of offsets to
1373 each 2D slice in 'Data', in texels */
1374 GLvoid *Data; /**< Image data, accessed via FetchTexel() */
1375
1376 /**
1377 * \name For device driver:
1378 */
1379 /*@{*/
1380 void *DriverData; /**< Arbitrary device driver data */
1381 /*@}*/
1382 };
1383
1384
1385 /**
1386 * Indexes for cube map faces.
1387 */
1388 /*@{*/
1389 #define FACE_POS_X 0
1390 #define FACE_NEG_X 1
1391 #define FACE_POS_Y 2
1392 #define FACE_NEG_Y 3
1393 #define FACE_POS_Z 4
1394 #define FACE_NEG_Z 5
1395 #define MAX_FACES 6
1396 /*@}*/
1397
1398
1399 /**
1400 * Texture object state. Contains the array of mipmap images, border color,
1401 * wrap modes, filter modes, shadow/texcompare state, and the per-texture
1402 * color palette.
1403 */
1404 struct gl_texture_object
1405 {
1406 GLint RefCount; /**< reference count */
1407 GLuint Name; /**< the user-visible texture object ID */
1408 GLenum Target; /**< GL_TEXTURE_1D, GL_TEXTURE_2D, etc. */
1409 GLfloat Priority; /**< in [0,1] */
1410 GLfloat BorderColor[4]; /**< unclamped */
1411 GLchan _BorderChan[4]; /**< clamped, as GLchan */
1412 GLenum WrapS; /**< S-axis texture image wrap mode */
1413 GLenum WrapT; /**< T-axis texture image wrap mode */
1414 GLenum WrapR; /**< R-axis texture image wrap mode */
1415 GLenum MinFilter; /**< minification filter */
1416 GLenum MagFilter; /**< magnification filter */
1417 GLfloat MinLod; /**< min lambda, OpenGL 1.2 */
1418 GLfloat MaxLod; /**< max lambda, OpenGL 1.2 */
1419 GLfloat LodBias; /**< OpenGL 1.4 */
1420 GLint BaseLevel; /**< min mipmap level, OpenGL 1.2 */
1421 GLint MaxLevel; /**< max mipmap level, OpenGL 1.2 */
1422 GLfloat MaxAnisotropy; /**< GL_EXT_texture_filter_anisotropic */
1423 GLboolean CompareFlag; /**< GL_SGIX_shadow */
1424 GLenum CompareOperator; /**< GL_SGIX_shadow */
1425 GLfloat ShadowAmbient; /**< GL_ARB_shadow_ambient */
1426 GLenum CompareMode; /**< GL_ARB_shadow */
1427 GLenum CompareFunc; /**< GL_ARB_shadow */
1428 GLenum _Function; /**< Comparison function derived from
1429 * \c CompareOperator, \c CompareMode, and
1430 * \c CompareFunc.
1431 */
1432 GLenum DepthMode; /**< GL_ARB_depth_texture */
1433 GLint _MaxLevel; /**< actual max mipmap level (q in the spec) */
1434 GLfloat _MaxLambda; /**< = _MaxLevel - BaseLevel (q - b in spec) */
1435 GLboolean GenerateMipmap; /**< GL_SGIS_generate_mipmap */
1436 GLboolean _Complete; /**< Is texture object complete? */
1437
1438 /** Actual texture images, indexed by [cube face] and [mipmap level] */
1439 struct gl_texture_image *Image[MAX_FACES][MAX_TEXTURE_LEVELS];
1440
1441 /** GL_EXT_paletted_texture */
1442 struct gl_color_table Palette;
1443
1444
1445 /**
1446 * \name For device driver.
1447 * Note: instead of attaching driver data to this pointer, it's preferable
1448 * to instead use this struct as a base class for your own texture object
1449 * class. Driver->NewTextureObject() can be used to implement the
1450 * allocation.
1451 */
1452 void *DriverData; /**< Arbitrary device driver data */
1453 };
1454
1455
1456 /**
1457 * Texture combine environment state.
1458 *
1459 * \todo
1460 * If GL_NV_texture_env_combine4 is ever supported, the arrays in this
1461 * structure will need to be expanded for 4 elements.
1462 */
1463 struct gl_tex_env_combine_state
1464 {
1465 GLenum ModeRGB; /**< GL_REPLACE, GL_DECAL, GL_ADD, etc. */
1466 GLenum ModeA; /**< GL_REPLACE, GL_DECAL, GL_ADD, etc. */
1467 GLenum SourceRGB[3]; /**< GL_PRIMARY_COLOR, GL_TEXTURE, etc. */
1468 GLenum SourceA[3]; /**< GL_PRIMARY_COLOR, GL_TEXTURE, etc. */
1469 GLenum OperandRGB[3]; /**< SRC_COLOR, ONE_MINUS_SRC_COLOR, etc */
1470 GLenum OperandA[3]; /**< SRC_ALPHA, ONE_MINUS_SRC_ALPHA, etc */
1471 GLuint ScaleShiftRGB; /**< 0, 1 or 2 */
1472 GLuint ScaleShiftA; /**< 0, 1 or 2 */
1473 GLuint _NumArgsRGB; /**< Number of inputs used for the combine mode. */
1474 GLuint _NumArgsA; /**< Number of inputs used for the combine mode. */
1475 };
1476
1477
1478 /**
1479 * Texture unit state. Contains enable flags, texture environment/function/
1480 * combiners, texgen state, pointers to current texture objects and
1481 * post-filter color tables.
1482 */
1483 struct gl_texture_unit
1484 {
1485 GLbitfield Enabled; /**< bitmask of TEXTURE_*_BIT flags */
1486 GLbitfield _ReallyEnabled; /**< 0 or exactly one of TEXTURE_*_BIT flags */
1487
1488 GLenum EnvMode; /**< GL_MODULATE, GL_DECAL, GL_BLEND, etc. */
1489 GLfloat EnvColor[4];
1490 GLbitfield TexGenEnabled; /**< Bitwise-OR of [STRQ]_BIT values */
1491 /** \name Tex coord generation mode
1492 * Either GL_OBJECT_LINEAR, GL_EYE_LINEAR or GL_SPHERE_MAP. */
1493 /*@{*/
1494 GLenum GenModeS;
1495 GLenum GenModeT;
1496 GLenum GenModeR;
1497 GLenum GenModeQ;
1498 /*@}*/
1499 GLbitfield _GenBitS;
1500 GLbitfield _GenBitT;
1501 GLbitfield _GenBitR;
1502 GLbitfield _GenBitQ;
1503 GLbitfield _GenFlags; /**< bitwise or of _GenBit[STRQ] */
1504 GLfloat ObjectPlaneS[4];
1505 GLfloat ObjectPlaneT[4];
1506 GLfloat ObjectPlaneR[4];
1507 GLfloat ObjectPlaneQ[4];
1508 GLfloat EyePlaneS[4];
1509 GLfloat EyePlaneT[4];
1510 GLfloat EyePlaneR[4];
1511 GLfloat EyePlaneQ[4];
1512 GLfloat LodBias; /**< for biasing mipmap levels */
1513
1514 /**
1515 * \name GL_EXT_texture_env_combine
1516 */
1517 struct gl_tex_env_combine_state Combine;
1518
1519 /**
1520 * Derived state based on \c EnvMode and the \c BaseFormat of the
1521 * currently enabled texture.
1522 */
1523 struct gl_tex_env_combine_state _EnvMode;
1524
1525 /**
1526 * Currently enabled combiner state. This will point to either
1527 * \c Combine or \c _EnvMode.
1528 */
1529 struct gl_tex_env_combine_state *_CurrentCombine;
1530
1531 struct gl_texture_object *Current1D;
1532 struct gl_texture_object *Current2D;
1533 struct gl_texture_object *Current3D;
1534 struct gl_texture_object *CurrentCubeMap; /**< GL_ARB_texture_cube_map */
1535 struct gl_texture_object *CurrentRect; /**< GL_NV_texture_rectangle */
1536 struct gl_texture_object *Current1DArray; /**< GL_MESA_texture_array */
1537 struct gl_texture_object *Current2DArray; /**< GL_MESA_texture_array */
1538
1539 struct gl_texture_object *_Current; /**< Points to really enabled tex obj */
1540
1541 /** These are used for glPush/PopAttrib */
1542 /*@{*/
1543 struct gl_texture_object Saved1D;
1544 struct gl_texture_object Saved2D;
1545 struct gl_texture_object Saved3D;
1546 struct gl_texture_object SavedCubeMap;
1547 struct gl_texture_object SavedRect;
1548 struct gl_texture_object Saved1DArray;
1549 struct gl_texture_object Saved2DArray;
1550 /*@}*/
1551
1552 /** GL_SGI_texture_color_table */
1553 /*@{*/
1554 struct gl_color_table ColorTable;
1555 struct gl_color_table ProxyColorTable;
1556 GLboolean ColorTableEnabled;
1557 /*@}*/
1558 };
1559
1560
1561 /**
1562 * Texture attribute group (GL_TEXTURE_BIT).
1563 */
1564 struct gl_texture_attrib
1565 {
1566 /**
1567 * name multitexture
1568 */
1569 /**@{*/
1570 GLuint CurrentUnit; /**< Active texture unit */
1571 GLbitfield _EnabledUnits; /**< one bit set for each really-enabled unit */
1572 GLbitfield _EnabledCoordUnits; /**< one bit per enabled coordinate unit */
1573 GLbitfield _GenFlags; /**< for texgen */
1574 GLbitfield _TexGenEnabled;
1575 GLbitfield _TexMatEnabled;
1576 /**@}*/
1577
1578 struct gl_texture_unit Unit[MAX_TEXTURE_UNITS];
1579
1580 struct gl_texture_object *Proxy1D;
1581 struct gl_texture_object *Proxy2D;
1582 struct gl_texture_object *Proxy3D;
1583 struct gl_texture_object *ProxyCubeMap;
1584 struct gl_texture_object *ProxyRect;
1585 struct gl_texture_object *Proxy1DArray;
1586 struct gl_texture_object *Proxy2DArray;
1587
1588 /** GL_EXT_shared_texture_palette */
1589 GLboolean SharedPalette;
1590 struct gl_color_table Palette;
1591 };
1592
1593
1594 /**
1595 * Transformation attribute group (GL_TRANSFORM_BIT).
1596 */
1597 struct gl_transform_attrib
1598 {
1599 GLenum MatrixMode; /**< Matrix mode */
1600 GLfloat EyeUserPlane[MAX_CLIP_PLANES][4]; /**< User clip planes */
1601 GLfloat _ClipUserPlane[MAX_CLIP_PLANES][4]; /**< derived */
1602 GLbitfield ClipPlanesEnabled; /**< on/off bitmask */
1603 GLboolean Normalize; /**< Normalize all normals? */
1604 GLboolean RescaleNormals; /**< GL_EXT_rescale_normal */
1605 GLboolean RasterPositionUnclipped; /**< GL_IBM_rasterpos_clip */
1606
1607 GLboolean CullVertexFlag; /**< True if GL_CULL_VERTEX_EXT is enabled */
1608 GLfloat CullEyePos[4];
1609 GLfloat CullObjPos[4];
1610 };
1611
1612
1613 /**
1614 * Viewport attribute group (GL_VIEWPORT_BIT).
1615 */
1616 struct gl_viewport_attrib
1617 {
1618 GLint X, Y; /**< position */
1619 GLsizei Width, Height; /**< size */
1620 GLfloat Near, Far; /**< Depth buffer range */
1621 GLmatrix _WindowMap; /**< Mapping transformation as a matrix. */
1622 };
1623
1624
1625 /**
1626 * Node for the attribute stack.
1627 */
1628 struct gl_attrib_node
1629 {
1630 GLbitfield kind;
1631 void *data;
1632 struct gl_attrib_node *next;
1633 };
1634
1635
1636 /**
1637 * GL_ARB_vertex/pixel_buffer_object buffer object
1638 */
1639 struct gl_buffer_object
1640 {
1641 GLint RefCount;
1642 GLuint Name;
1643 GLenum Usage;
1644 GLenum Access;
1645 GLvoid *Pointer; /**< Only valid while buffer is mapped */
1646 GLsizeiptrARB Size; /**< Size of storage in bytes */
1647 GLubyte *Data; /**< Location of storage either in RAM or VRAM. */
1648 GLboolean OnCard; /**< Is buffer in VRAM? (hardware drivers) */
1649 };
1650
1651
1652
1653 /**
1654 * Client pixel packing/unpacking attributes
1655 */
1656 struct gl_pixelstore_attrib
1657 {
1658 GLint Alignment;
1659 GLint RowLength;
1660 GLint SkipPixels;
1661 GLint SkipRows;
1662 GLint ImageHeight; /**< for GL_EXT_texture3D */
1663 GLint SkipImages; /**< for GL_EXT_texture3D */
1664 GLboolean SwapBytes;
1665 GLboolean LsbFirst;
1666 GLboolean ClientStorage; /**< GL_APPLE_client_storage */
1667 GLboolean Invert; /**< GL_MESA_pack_invert */
1668 struct gl_buffer_object *BufferObj; /**< GL_ARB_pixel_buffer_object */
1669 };
1670
1671
1672
1673 /**
1674 * Client vertex array attributes
1675 */
1676 struct gl_client_array
1677 {
1678 GLint Size; /**< components per element (1,2,3,4) */
1679 GLenum Type; /**< datatype: GL_FLOAT, GL_INT, etc */
1680 GLsizei Stride; /**< user-specified stride */
1681 GLsizei StrideB; /**< actual stride in bytes */
1682 const GLubyte *Ptr; /**< Points to array data */
1683 GLboolean Enabled; /**< Enabled flag is a boolean */
1684 GLboolean Normalized; /**< GL_ARB_vertex_program */
1685
1686 /**< GL_ARB_vertex_buffer_object */
1687 struct gl_buffer_object *BufferObj;
1688 GLuint _MaxElement;
1689 };
1690
1691
1692 /**
1693 * Collection of vertex arrays. Defined by the GL_APPLE_vertex_array_object
1694 * extension, but a nice encapsulation in any case.
1695 */
1696 struct gl_array_object
1697 {
1698 /** Name of the array object as received from glGenVertexArrayAPPLE. */
1699 GLuint Name;
1700
1701 /** Conventional vertex arrays */
1702 /*@{*/
1703 struct gl_client_array Vertex;
1704 struct gl_client_array Normal;
1705 struct gl_client_array Color;
1706 struct gl_client_array SecondaryColor;
1707 struct gl_client_array FogCoord;
1708 struct gl_client_array Index;
1709 struct gl_client_array EdgeFlag;
1710 struct gl_client_array TexCoord[MAX_TEXTURE_COORD_UNITS];
1711 /*@}*/
1712
1713 /** Generic arrays for vertex programs/shaders */
1714 struct gl_client_array VertexAttrib[VERT_ATTRIB_MAX];
1715
1716 /** Mask of _NEW_ARRAY_* values indicating which arrays are enabled */
1717 GLbitfield _Enabled;
1718 };
1719
1720
1721 /**
1722 * Vertex array state
1723 */
1724 struct gl_array_attrib
1725 {
1726 struct gl_array_object *ArrayObj;
1727 struct gl_array_object *DefaultArrayObj;
1728
1729 GLint ActiveTexture; /**< Client Active Texture */
1730 GLuint LockFirst; /**< GL_EXT_compiled_vertex_array */
1731 GLuint LockCount; /**< GL_EXT_compiled_vertex_array */
1732
1733 GLbitfield NewState; /**< mask of _NEW_ARRAY_* values */
1734
1735 #if FEATURE_ARB_vertex_buffer_object
1736 struct gl_buffer_object *NullBufferObj;
1737 struct gl_buffer_object *ArrayBufferObj;
1738 struct gl_buffer_object *ElementArrayBufferObj;
1739 #endif
1740 GLuint _MaxElement; /* Min of all enabled array's maxes */
1741 };
1742
1743
1744 /**
1745 * Feedback buffer state
1746 */
1747 struct gl_feedback
1748 {
1749 GLenum Type;
1750 GLbitfield _Mask; /* FB_* bits */
1751 GLfloat *Buffer;
1752 GLuint BufferSize;
1753 GLuint Count;
1754 };
1755
1756
1757 /**
1758 * Selection buffer state
1759 */
1760 struct gl_selection
1761 {
1762 GLuint *Buffer; /**< selection buffer */
1763 GLuint BufferSize; /**< size of the selection buffer */
1764 GLuint BufferCount; /**< number of values in the selection buffer */
1765 GLuint Hits; /**< number of records in the selection buffer */
1766 GLuint NameStackDepth; /**< name stack depth */
1767 GLuint NameStack[MAX_NAME_STACK_DEPTH]; /**< name stack */
1768 GLboolean HitFlag; /**< hit flag */
1769 GLfloat HitMinZ; /**< minimum hit depth */
1770 GLfloat HitMaxZ; /**< maximum hit depth */
1771 };
1772
1773
1774 /**
1775 * 1-D Evaluator control points
1776 */
1777 struct gl_1d_map
1778 {
1779 GLuint Order; /**< Number of control points */
1780 GLfloat u1, u2, du; /**< u1, u2, 1.0/(u2-u1) */
1781 GLfloat *Points; /**< Points to contiguous control points */
1782 };
1783
1784
1785 /**
1786 * 2-D Evaluator control points
1787 */
1788 struct gl_2d_map
1789 {
1790 GLuint Uorder; /**< Number of control points in U dimension */
1791 GLuint Vorder; /**< Number of control points in V dimension */
1792 GLfloat u1, u2, du;
1793 GLfloat v1, v2, dv;
1794 GLfloat *Points; /**< Points to contiguous control points */
1795 };
1796
1797
1798 /**
1799 * All evaluator control point state
1800 */
1801 struct gl_evaluators
1802 {
1803 /**
1804 * \name 1-D maps
1805 */
1806 /*@{*/
1807 struct gl_1d_map Map1Vertex3;
1808 struct gl_1d_map Map1Vertex4;
1809 struct gl_1d_map Map1Index;
1810 struct gl_1d_map Map1Color4;
1811 struct gl_1d_map Map1Normal;
1812 struct gl_1d_map Map1Texture1;
1813 struct gl_1d_map Map1Texture2;
1814 struct gl_1d_map Map1Texture3;
1815 struct gl_1d_map Map1Texture4;
1816 struct gl_1d_map Map1Attrib[16]; /**< GL_NV_vertex_program */
1817 /*@}*/
1818
1819 /**
1820 * \name 2-D maps
1821 */
1822 /*@{*/
1823 struct gl_2d_map Map2Vertex3;
1824 struct gl_2d_map Map2Vertex4;
1825 struct gl_2d_map Map2Index;
1826 struct gl_2d_map Map2Color4;
1827 struct gl_2d_map Map2Normal;
1828 struct gl_2d_map Map2Texture1;
1829 struct gl_2d_map Map2Texture2;
1830 struct gl_2d_map Map2Texture3;
1831 struct gl_2d_map Map2Texture4;
1832 struct gl_2d_map Map2Attrib[16]; /**< GL_NV_vertex_program */
1833 /*@}*/
1834 };
1835
1836
1837 /**
1838 * Names of the various vertex/fragment program register files, etc.
1839 *
1840 * NOTE: first four tokens must fit into 2 bits (see t_vb_arbprogram.c)
1841 * All values should fit in a 4-bit field.
1842 *
1843 * NOTE: PROGRAM_ENV_PARAM, PROGRAM_STATE_VAR, PROGRAM_NAMED_PARAM,
1844 * PROGRAM_CONSTANT, and PROGRAM_UNIFORM can all be considered to
1845 * be "uniform" variables since they can only be set outside glBegin/End.
1846 * They're also all stored in the same Parameters array.
1847 */
1848 enum register_file
1849 {
1850 PROGRAM_TEMPORARY = 0, /**< machine->Temporary[] */
1851 PROGRAM_LOCAL_PARAM = 1, /**< gl_program->LocalParams[] */
1852 PROGRAM_ENV_PARAM = 2, /**< gl_program->Parameters[] */
1853 PROGRAM_STATE_VAR = 3, /**< gl_program->Parameters[] */
1854 PROGRAM_INPUT = 4, /**< machine->Inputs[] */
1855 PROGRAM_OUTPUT = 5, /**< machine->Outputs[] */
1856 PROGRAM_NAMED_PARAM = 6, /**< gl_program->Parameters[] */
1857 PROGRAM_CONSTANT = 7, /**< gl_program->Parameters[] */
1858 PROGRAM_UNIFORM = 8, /**< gl_program->Parameters[] */
1859 PROGRAM_VARYING = 9, /**< machine->Inputs[]/Outputs[] */
1860 PROGRAM_WRITE_ONLY = 10, /**< A dummy, write-only register */
1861 PROGRAM_ADDRESS = 11, /**< machine->AddressReg */
1862 PROGRAM_SAMPLER = 12, /**< for shader samplers, compile-time only */
1863 PROGRAM_UNDEFINED = 13, /**< Invalid value */
1864 PROGRAM_FILE_MAX
1865 };
1866
1867
1868 /** Vertex and fragment instructions */
1869 struct prog_instruction;
1870 struct gl_program_parameter_list;
1871
1872
1873 /**
1874 * Base class for any kind of program object
1875 */
1876 struct gl_program
1877 {
1878 GLuint Id;
1879 GLubyte *String; /**< Null-terminated program text */
1880 GLint RefCount;
1881 GLenum Target; /**< GL_VERTEX/FRAGMENT_PROGRAM_ARB, GL_FRAGMENT_PROGRAM_NV */
1882 GLenum Format; /**< String encoding format */
1883 GLboolean Resident;
1884
1885 struct prog_instruction *Instructions;
1886
1887 GLbitfield InputsRead; /**< Bitmask of which input regs are read */
1888 GLbitfield OutputsWritten; /**< Bitmask of which output regs are written to */
1889 GLbitfield TexturesUsed[MAX_TEXTURE_IMAGE_UNITS]; /**< TEXTURE_x_BIT bitmask */
1890 GLbitfield SamplersUsed; /**< Bitfield of which samplers are used */
1891 GLbitfield ShadowSamplers; /**< Texture units used for shadow sampling. */
1892
1893 /** Named parameters, constants, etc. from program text */
1894 struct gl_program_parameter_list *Parameters;
1895 /** Numbered local parameters */
1896 GLfloat LocalParams[MAX_PROGRAM_LOCAL_PARAMS][4];
1897
1898 /** Vertex/fragment shader varying vars */
1899 struct gl_program_parameter_list *Varying;
1900 /** Vertex program user-defined attributes */
1901 struct gl_program_parameter_list *Attributes;
1902
1903 /** Map from sampler unit to texture unit (set by glUniform1i()) */
1904 GLubyte SamplerUnits[MAX_SAMPLERS];
1905 /** Which texture target is being sampled (TEXTURE_1D/2D/3D/etc_INDEX) */
1906 GLubyte SamplerTargets[MAX_SAMPLERS];
1907
1908 /** Logical counts */
1909 /*@{*/
1910 GLuint NumInstructions;
1911 GLuint NumTemporaries;
1912 GLuint NumParameters;
1913 GLuint NumAttributes;
1914 GLuint NumAddressRegs;
1915 GLuint NumAluInstructions;
1916 GLuint NumTexInstructions;
1917 GLuint NumTexIndirections;
1918 /*@}*/
1919 /** Native, actual h/w counts */
1920 /*@{*/
1921 GLuint NumNativeInstructions;
1922 GLuint NumNativeTemporaries;
1923 GLuint NumNativeParameters;
1924 GLuint NumNativeAttributes;
1925 GLuint NumNativeAddressRegs;
1926 GLuint NumNativeAluInstructions;
1927 GLuint NumNativeTexInstructions;
1928 GLuint NumNativeTexIndirections;
1929 /*@}*/
1930 };
1931
1932
1933 /** Vertex program object */
1934 struct gl_vertex_program
1935 {
1936 struct gl_program Base; /**< base class */
1937 GLboolean IsNVProgram; /**< is this a GL_NV_vertex_program program? */
1938 GLboolean IsPositionInvariant;
1939 void *TnlData; /**< should probably use Base.DriverData */
1940 };
1941
1942
1943 /** Fragment program object */
1944 struct gl_fragment_program
1945 {
1946 struct gl_program Base; /**< base class */
1947 GLenum FogOption;
1948 GLboolean UsesKill;
1949 };
1950
1951
1952 /**
1953 * State common to vertex and fragment programs.
1954 */
1955 struct gl_program_state
1956 {
1957 GLint ErrorPos; /* GL_PROGRAM_ERROR_POSITION_ARB/NV */
1958 const char *ErrorString; /* GL_PROGRAM_ERROR_STRING_ARB/NV */
1959 };
1960
1961
1962 /**
1963 * Context state for vertex programs.
1964 */
1965 struct gl_vertex_program_state
1966 {
1967 GLboolean Enabled; /**< GL_VERTEX_PROGRAM_ARB/NV */
1968 GLboolean _Enabled; /**< Enabled and valid program? */
1969 GLboolean PointSizeEnabled; /**< GL_VERTEX_PROGRAM_POINT_SIZE_ARB/NV */
1970 GLboolean TwoSideEnabled; /**< GL_VERTEX_PROGRAM_TWO_SIDE_ARB/NV */
1971 struct gl_vertex_program *Current; /**< user-bound vertex program */
1972
1973 /** Currently enabled and valid program (including internal programs
1974 * and compiled shader programs).
1975 */
1976 struct gl_vertex_program *_Current;
1977
1978 GLfloat Parameters[MAX_PROGRAM_ENV_PARAMS][4]; /**< Env params */
1979
1980 /* For GL_NV_vertex_program only: */
1981 GLenum TrackMatrix[MAX_PROGRAM_ENV_PARAMS / 4];
1982 GLenum TrackMatrixTransform[MAX_PROGRAM_ENV_PARAMS / 4];
1983
1984 /** Should fixed-function T&L be implemented with a vertex prog? */
1985 GLboolean _MaintainTnlProgram;
1986
1987 /** Program to emulate fixed-function T&L (see above) */
1988 struct gl_vertex_program *_TnlProgram;
1989
1990 /** Cache of fixed-function programs */
1991 struct gl_program_cache *Cache;
1992
1993 #if FEATURE_MESA_program_debug
1994 GLprogramcallbackMESA Callback;
1995 GLvoid *CallbackData;
1996 GLboolean CallbackEnabled;
1997 GLuint CurrentPosition;
1998 #endif
1999 };
2000
2001
2002 /**
2003 * Context state for fragment programs.
2004 */
2005 struct gl_fragment_program_state
2006 {
2007 GLboolean Enabled; /**< User-set fragment program enable flag */
2008 GLboolean _Enabled; /**< Fragment program enabled and valid? */
2009 GLboolean _Active;
2010 struct gl_fragment_program *Current; /**< User-bound fragment program */
2011
2012 /** Currently enabled and valid program (including internal programs
2013 * and compiled shader programs).
2014 */
2015 struct gl_fragment_program *_Current;
2016
2017 GLfloat Parameters[MAX_PROGRAM_ENV_PARAMS][4]; /**< Env params */
2018
2019 /** Should fixed-function texturing be implemented with a fragment prog? */
2020 GLboolean _MaintainTexEnvProgram;
2021 GLboolean _UseTexEnvProgram;
2022
2023 /** Program to emulate fixed-function texture env/combine (see above) */
2024 struct gl_fragment_program *_TexEnvProgram;
2025
2026 /** Cache of fixed-function programs */
2027 struct gl_program_cache *Cache;
2028
2029 #if FEATURE_MESA_program_debug
2030 GLprogramcallbackMESA Callback;
2031 GLvoid *CallbackData;
2032 GLboolean CallbackEnabled;
2033 GLuint CurrentPosition;
2034 #endif
2035 };
2036
2037
2038 /**
2039 * ATI_fragment_shader runtime state
2040 */
2041 #define ATI_FS_INPUT_PRIMARY 0
2042 #define ATI_FS_INPUT_SECONDARY 1
2043
2044 struct atifs_instruction;
2045 struct atifs_setupinst;
2046
2047 /**
2048 * ATI fragment shader
2049 */
2050 struct ati_fragment_shader
2051 {
2052 GLuint Id;
2053 GLint RefCount;
2054 struct atifs_instruction *Instructions[2];
2055 struct atifs_setupinst *SetupInst[2];
2056 GLfloat Constants[8][4];
2057 GLbitfield LocalConstDef; /** Indicates which constants have been set */
2058 GLubyte numArithInstr[2];
2059 GLubyte regsAssigned[2];
2060 GLubyte NumPasses; /** 1 or 2 */
2061 GLubyte cur_pass;
2062 GLubyte last_optype;
2063 GLboolean interpinp1;
2064 GLboolean isValid;
2065 GLuint swizzlerq;
2066 };
2067
2068 /**
2069 * Context state for GL_ATI_fragment_shader
2070 */
2071 struct gl_ati_fragment_shader_state
2072 {
2073 GLboolean Enabled;
2074 GLboolean _Enabled; /** enabled and valid shader? */
2075 GLboolean Compiling;
2076 GLfloat GlobalConstants[8][4];
2077 struct ati_fragment_shader *Current;
2078 };
2079
2080
2081 /**
2082 * Occlusion/timer query object.
2083 */
2084 struct gl_query_object
2085 {
2086 GLenum Target; /**< The query target, when active */
2087 GLuint Id; /**< hash table ID/name */
2088 GLuint64EXT Result; /**< the counter */
2089 GLboolean Active; /**< inside Begin/EndQuery */
2090 GLboolean Ready; /**< result is ready? */
2091 };
2092
2093
2094 /**
2095 * Context state for query objects.
2096 */
2097 struct gl_query_state
2098 {
2099 struct _mesa_HashTable *QueryObjects;
2100 struct gl_query_object *CurrentOcclusionObject; /* GL_ARB_occlusion_query */
2101 struct gl_query_object *CurrentTimerObject; /* GL_EXT_timer_query */
2102 };
2103
2104
2105
2106 /**
2107 * A GLSL shader object.
2108 */
2109 struct gl_shader
2110 {
2111 GLenum Type; /**< GL_FRAGMENT_SHADER || GL_VERTEX_SHADER (first field!) */
2112 GLuint Name; /**< AKA the handle */
2113 GLint RefCount; /**< Reference count */
2114 GLboolean DeletePending;
2115
2116 const GLchar *Source; /**< Source code string */
2117 GLboolean CompileStatus;
2118 GLuint NumPrograms; /**< size of Programs[] array */
2119 struct gl_program **Programs; /**< Post-compile assembly code */
2120 GLchar *InfoLog;
2121 };
2122
2123
2124 /**
2125 * A GLSL program object. Basically a linked collection of "shaders".
2126 */
2127 struct gl_shader_program
2128 {
2129 GLenum Type; /**< Always GL_SHADER_PROGRAM (internal token) */
2130 GLuint Name; /**< aka handle or ID */
2131 GLint RefCount; /**< Reference count */
2132 GLboolean DeletePending;
2133
2134 GLuint NumShaders; /**< number of attached shaders */
2135 struct gl_shader **Shaders; /**< List of attached the shaders */
2136
2137 /* post-link info: */
2138 struct gl_vertex_program *VertexProgram; /**< Linked vertex program */
2139 struct gl_fragment_program *FragmentProgram; /**< Linked fragment prog */
2140 struct gl_program_parameter_list *Uniforms; /**< Plus constants, etc */
2141 struct gl_program_parameter_list *Varying;
2142 struct gl_program_parameter_list *Attributes; /**< Vertex attributes */
2143 GLboolean LinkStatus; /**< GL_LINK_STATUS */
2144 GLboolean Validated;
2145 GLchar *InfoLog;
2146 };
2147
2148
2149 /**
2150 * Context state for GLSL vertex/fragment shaders.
2151 */
2152 struct gl_shader_state
2153 {
2154 struct gl_shader_program *CurrentProgram; /**< The user-bound program */
2155 /** Driver-selectable options: */
2156 GLboolean EmitHighLevelInstructions; /**< IF/ELSE/ENDIF vs. BRA, etc. */
2157 GLboolean EmitCondCodes; /**< Use condition codes? */
2158 GLboolean EmitComments; /**< Annotated instructions */
2159 void *MemPool;
2160 };
2161
2162
2163 /**
2164 * State which can be shared by multiple contexts:
2165 */
2166 struct gl_shared_state
2167 {
2168 _glthread_Mutex Mutex; /**< for thread safety */
2169 GLint RefCount; /**< Reference count */
2170 struct _mesa_HashTable *DisplayList; /**< Display lists hash table */
2171 struct _mesa_HashTable *TexObjects; /**< Texture objects hash table */
2172
2173 /**
2174 * \name Default texture objects (shared by all multi-texture units)
2175 */
2176 /*@{*/
2177 struct gl_texture_object *Default1D;
2178 struct gl_texture_object *Default2D;
2179 struct gl_texture_object *Default3D;
2180 struct gl_texture_object *DefaultCubeMap;
2181 struct gl_texture_object *DefaultRect;
2182 struct gl_texture_object *Default1DArray;
2183 struct gl_texture_object *Default2DArray;
2184 /*@}*/
2185
2186 /**
2187 * \name Thread safety and statechange notification for texture
2188 * objects.
2189 *
2190 * \todo Improve the granularity of locking.
2191 */
2192 /*@{*/
2193 _glthread_Mutex TexMutex; /**< texobj thread safety */
2194 GLuint TextureStateStamp; /**< state notification for shared tex */
2195 /*@}*/
2196
2197
2198 /**
2199 * \name Vertex/fragment programs
2200 */
2201 /*@{*/
2202 struct _mesa_HashTable *Programs; /**< All vertex/fragment programs */
2203 #if FEATURE_ARB_vertex_program
2204 struct gl_program *DefaultVertexProgram;
2205 #endif
2206 #if FEATURE_ARB_fragment_program
2207 struct gl_program *DefaultFragmentProgram;
2208 #endif
2209 /*@}*/
2210
2211 #if FEATURE_ATI_fragment_shader
2212 struct _mesa_HashTable *ATIShaders;
2213 struct ati_fragment_shader *DefaultFragmentShader;
2214 #endif
2215
2216 #if FEATURE_ARB_vertex_buffer_object || FEATURE_ARB_pixel_buffer_object
2217 struct _mesa_HashTable *BufferObjects;
2218 #endif
2219
2220 #if FEATURE_ARB_shader_objects
2221 /** Table of both gl_shader and gl_shader_program objects */
2222 struct _mesa_HashTable *ShaderObjects;
2223 #endif
2224
2225 #if FEATURE_EXT_framebuffer_object
2226 struct _mesa_HashTable *RenderBuffers;
2227 struct _mesa_HashTable *FrameBuffers;
2228 #endif
2229
2230 /** Objects associated with the GL_APPLE_vertex_array_object extension. */
2231 struct _mesa_HashTable *ArrayObjects;
2232
2233 void *DriverData; /**< Device driver shared state */
2234 };
2235
2236
2237
2238
2239 /**
2240 * A renderbuffer stores colors or depth values or stencil values.
2241 * A framebuffer object will have a collection of these.
2242 * Data are read/written to the buffer with a handful of Get/Put functions.
2243 *
2244 * Instances of this object are allocated with the Driver's NewRenderbuffer
2245 * hook. Drivers will likely wrap this class inside a driver-specific
2246 * class to simulate inheritance.
2247 */
2248 struct gl_renderbuffer
2249 {
2250 #define RB_MAGIC 0xaabbccdd
2251 int Magic; /** XXX TEMPORARY DEBUG INFO */
2252 _glthread_Mutex Mutex; /**< for thread safety */
2253 GLuint ClassID; /**< Useful for drivers */
2254 GLuint Name;
2255 GLint RefCount;
2256 GLuint Width, Height;
2257 GLenum InternalFormat; /**< The user-specified format */
2258 GLenum _ActualFormat; /**< The driver-chosen format */
2259 GLenum _BaseFormat; /**< Either GL_RGB, GL_RGBA, GL_DEPTH_COMPONENT or
2260 GL_STENCIL_INDEX. */
2261 GLenum DataType; /**< Type of values passed to the Get/Put functions */
2262 GLubyte RedBits; /**< Bits of red per pixel */
2263 GLubyte GreenBits;
2264 GLubyte BlueBits;
2265 GLubyte AlphaBits;
2266 GLubyte IndexBits;
2267 GLubyte DepthBits;
2268 GLubyte StencilBits;
2269 GLvoid *Data; /**< This may not be used by some kinds of RBs */
2270
2271 /* Used to wrap one renderbuffer around another: */
2272 struct gl_renderbuffer *Wrapped;
2273
2274 /* Delete this renderbuffer */
2275 void (*Delete)(struct gl_renderbuffer *rb);
2276
2277 /* Allocate new storage for this renderbuffer */
2278 GLboolean (*AllocStorage)(GLcontext *ctx, struct gl_renderbuffer *rb,
2279 GLenum internalFormat,
2280 GLuint width, GLuint height);
2281
2282 /* Lock/Unlock are called before/after calling the Get/Put functions.
2283 * Not sure this is the right place for these yet.
2284 void (*Lock)(GLcontext *ctx, struct gl_renderbuffer *rb);
2285 void (*Unlock)(GLcontext *ctx, struct gl_renderbuffer *rb);
2286 */
2287
2288 /* Return a pointer to the element/pixel at (x,y).
2289 * Should return NULL if the buffer memory can't be directly addressed.
2290 */
2291 void *(*GetPointer)(GLcontext *ctx, struct gl_renderbuffer *rb,
2292 GLint x, GLint y);
2293
2294 /* Get/Read a row of values.
2295 * The values will be of format _BaseFormat and type DataType.
2296 */
2297 void (*GetRow)(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
2298 GLint x, GLint y, void *values);
2299
2300 /* Get/Read values at arbitrary locations.
2301 * The values will be of format _BaseFormat and type DataType.
2302 */
2303 void (*GetValues)(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
2304 const GLint x[], const GLint y[], void *values);
2305
2306 /* Put/Write a row of values.
2307 * The values will be of format _BaseFormat and type DataType.
2308 */
2309 void (*PutRow)(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
2310 GLint x, GLint y, const void *values, const GLubyte *mask);
2311
2312 /* Put/Write a row of RGB values. This is a special-case routine that's
2313 * only used for RGBA renderbuffers when the source data is GL_RGB. That's
2314 * a common case for glDrawPixels and some triangle routines.
2315 * The values will be of format GL_RGB and type DataType.
2316 */
2317 void (*PutRowRGB)(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
2318 GLint x, GLint y, const void *values, const GLubyte *mask);
2319
2320
2321 /* Put/Write a row of identical values.
2322 * The values will be of format _BaseFormat and type DataType.
2323 */
2324 void (*PutMonoRow)(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
2325 GLint x, GLint y, const void *value, const GLubyte *mask);
2326
2327 /* Put/Write values at arbitrary locations.
2328 * The values will be of format _BaseFormat and type DataType.
2329 */
2330 void (*PutValues)(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
2331 const GLint x[], const GLint y[], const void *values,
2332 const GLubyte *mask);
2333 /* Put/Write identical values at arbitrary locations.
2334 * The values will be of format _BaseFormat and type DataType.
2335 */
2336 void (*PutMonoValues)(GLcontext *ctx, struct gl_renderbuffer *rb,
2337 GLuint count, const GLint x[], const GLint y[],
2338 const void *value, const GLubyte *mask);
2339 };
2340
2341
2342 /**
2343 * A renderbuffer attachment point points to either a texture object
2344 * (and specifies a mipmap level, cube face or 3D texture slice) or
2345 * points to a renderbuffer.
2346 */
2347 struct gl_renderbuffer_attachment
2348 {
2349 GLenum Type; /**< \c GL_NONE or \c GL_TEXTURE or \c GL_RENDERBUFFER_EXT */
2350 GLboolean Complete;
2351
2352 /**
2353 * If \c Type is \c GL_RENDERBUFFER_EXT, this stores a pointer to the
2354 * application supplied renderbuffer object.
2355 */
2356 struct gl_renderbuffer *Renderbuffer;
2357
2358 /**
2359 * If \c Type is \c GL_TEXTURE, this stores a pointer to the application
2360 * supplied texture object.
2361 */
2362 struct gl_texture_object *Texture;
2363 GLuint TextureLevel; /**< Attached mipmap level. */
2364 GLuint CubeMapFace; /**< 0 .. 5, for cube map textures. */
2365 GLuint Zoffset; /**< Slice for 3D textures, or layer for both 1D
2366 * and 2D array textures */
2367 };
2368
2369
2370 /**
2371 * A framebuffer is a collection of renderbuffers (color, depth, stencil, etc).
2372 * In C++ terms, think of this as a base class from which device drivers
2373 * will make derived classes.
2374 */
2375 struct gl_framebuffer
2376 {
2377 _glthread_Mutex Mutex; /**< for thread safety */
2378 GLuint Name; /* if zero, this is a window system framebuffer */
2379 GLint RefCount;
2380 GLboolean DeletePending;
2381
2382 GLvisual Visual; /**< The framebuffer's visual.
2383 Immutable if this is a window system buffer.
2384 Computed from attachments if user-made FBO. */
2385
2386 GLboolean Initialized;
2387
2388 GLuint Width, Height; /**< size of frame buffer in pixels */
2389
2390 /** \name Drawing bounds (Intersection of buffer size and scissor box) */
2391 /*@{*/
2392 GLint _Xmin, _Xmax; /**< inclusive */
2393 GLint _Ymin, _Ymax; /**< exclusive */
2394 /*@}*/
2395
2396 /** \name Derived Z buffer stuff */
2397 /*@{*/
2398 GLuint _DepthMax; /**< Max depth buffer value */
2399 GLfloat _DepthMaxF; /**< Float max depth buffer value */
2400 GLfloat _MRD; /**< minimum resolvable difference in Z values */
2401 /*@}*/
2402
2403 GLenum _Status; /* One of the GL_FRAMEBUFFER_(IN)COMPLETE_* tokens */
2404
2405 /* Array of all renderbuffer attachments, indexed by BUFFER_* tokens. */
2406 struct gl_renderbuffer_attachment Attachment[BUFFER_COUNT];
2407
2408 /* In unextended OpenGL these vars are part of the GL_COLOR_BUFFER
2409 * attribute group and GL_PIXEL attribute group, respectively.
2410 */
2411 GLenum ColorDrawBuffer[MAX_DRAW_BUFFERS];
2412 GLenum ColorReadBuffer;
2413
2414 /* These are computed from ColorDrawBuffer and ColorReadBuffer */
2415 GLbitfield _ColorDrawBufferMask[MAX_DRAW_BUFFERS]; /* Mask of BUFFER_BIT_* flags */
2416 GLint _ColorReadBufferIndex; /* -1 = None */
2417
2418 /* These are computed from _ColorDrawBufferMask and _ColorReadBufferIndex */
2419 GLuint _NumColorDrawBuffers[MAX_DRAW_BUFFERS];
2420 struct gl_renderbuffer *_ColorDrawBuffers[MAX_DRAW_BUFFERS][4];
2421 struct gl_renderbuffer *_ColorReadBuffer;
2422
2423 /** The Actual depth/stencil buffers to use. May be wrappers around the
2424 * depth/stencil buffers attached above. */
2425 struct gl_renderbuffer *_DepthBuffer;
2426 struct gl_renderbuffer *_StencilBuffer;
2427
2428 /** Delete this framebuffer */
2429 void (*Delete)(struct gl_framebuffer *fb);
2430 };
2431
2432
2433 /**
2434 * Limits for vertex and fragment programs.
2435 */
2436 struct gl_program_constants
2437 {
2438 /* logical limits */
2439 GLuint MaxInstructions;
2440 GLuint MaxAluInstructions; /* fragment programs only, for now */
2441 GLuint MaxTexInstructions; /* fragment programs only, for now */
2442 GLuint MaxTexIndirections; /* fragment programs only, for now */
2443 GLuint MaxAttribs;
2444 GLuint MaxTemps;
2445 GLuint MaxAddressRegs; /* vertex program only, for now */
2446 GLuint MaxParameters;
2447 GLuint MaxLocalParams;
2448 GLuint MaxEnvParams;
2449 /* native/hardware limits */
2450 GLuint MaxNativeInstructions;
2451 GLuint MaxNativeAluInstructions; /* fragment programs only, for now */
2452 GLuint MaxNativeTexInstructions; /* fragment programs only, for now */
2453 GLuint MaxNativeTexIndirections; /* fragment programs only, for now */
2454 GLuint MaxNativeAttribs;
2455 GLuint MaxNativeTemps;
2456 GLuint MaxNativeAddressRegs; /* vertex program only, for now */
2457 GLuint MaxNativeParameters;
2458 /* For shaders */
2459 GLuint MaxUniformComponents;
2460 };
2461
2462
2463 /**
2464 * Constants which may be overridden by device driver during context creation
2465 * but are never changed after that.
2466 */
2467 struct gl_constants
2468 {
2469 GLint MaxTextureLevels; /**< Maximum number of allowed mipmap levels. */
2470 GLint Max3DTextureLevels; /**< Maximum number of allowed mipmap levels for 3D texture targets. */
2471 GLint MaxCubeTextureLevels; /**< Maximum number of allowed mipmap levels for GL_ARB_texture_cube_map */
2472 GLint MaxArrayTextureLayers; /**< Maximum number of layers in an array texture. */
2473 GLint MaxTextureRectSize; /* GL_NV_texture_rectangle */
2474 GLuint MaxTextureCoordUnits;
2475 GLuint MaxTextureImageUnits;
2476 GLuint MaxTextureUnits; /* = MIN(CoordUnits, ImageUnits) */
2477 GLfloat MaxTextureMaxAnisotropy; /* GL_EXT_texture_filter_anisotropic */
2478 GLfloat MaxTextureLodBias; /* GL_EXT_texture_lod_bias */
2479 GLuint MaxArrayLockSize;
2480 GLint SubPixelBits;
2481 GLfloat MinPointSize, MaxPointSize; /* aliased */
2482 GLfloat MinPointSizeAA, MaxPointSizeAA; /* antialiased */
2483 GLfloat PointSizeGranularity;
2484 GLfloat MinLineWidth, MaxLineWidth; /* aliased */
2485 GLfloat MinLineWidthAA, MaxLineWidthAA; /* antialiased */
2486 GLfloat LineWidthGranularity;
2487 GLuint MaxColorTableSize;
2488 GLuint MaxConvolutionWidth;
2489 GLuint MaxConvolutionHeight;
2490 GLuint MaxClipPlanes;
2491 GLuint MaxLights;
2492 GLfloat MaxShininess; /* GL_NV_light_max_exponent */
2493 GLfloat MaxSpotExponent; /* GL_NV_light_max_exponent */
2494 GLuint MaxViewportWidth, MaxViewportHeight;
2495 struct gl_program_constants VertexProgram; /* GL_ARB_vertex_program */
2496 struct gl_program_constants FragmentProgram; /* GL_ARB_fragment_program */
2497 /* shared by vertex and fragment program: */
2498 GLuint MaxProgramMatrices;
2499 GLuint MaxProgramMatrixStackDepth;
2500 /* vertex array / buffer object bounds checking */
2501 GLboolean CheckArrayBounds;
2502 /* GL_ARB_draw_buffers */
2503 GLuint MaxDrawBuffers;
2504 /* GL_OES_read_format */
2505 GLenum ColorReadFormat;
2506 GLenum ColorReadType;
2507 /* GL_EXT_framebuffer_object */
2508 GLuint MaxColorAttachments;
2509 GLuint MaxRenderbufferSize;
2510 /* GL_ARB_vertex_shader */
2511 GLuint MaxVertexTextureImageUnits;
2512 GLuint MaxVarying;
2513 };
2514
2515
2516 /**
2517 * Enable flag for each OpenGL extension. Different device drivers will
2518 * enable different extensions at runtime.
2519 */
2520 struct gl_extensions
2521 {
2522 /**
2523 * \name Flags to quickly test if certain extensions are available.
2524 *
2525 * Not every extension needs to have such a flag, but it's encouraged.
2526 */
2527 /*@{*/
2528 GLboolean dummy; /* don't remove this! */
2529 GLboolean ARB_depth_texture;
2530 GLboolean ARB_draw_buffers;
2531 GLboolean ARB_fragment_program;
2532 GLboolean ARB_fragment_program_shadow;
2533 GLboolean ARB_fragment_shader;
2534 GLboolean ARB_half_float_pixel;
2535 GLboolean ARB_imaging;
2536 GLboolean ARB_multisample;
2537 GLboolean ARB_multitexture;
2538 GLboolean ARB_occlusion_query;
2539 GLboolean ARB_point_sprite;
2540 GLboolean ARB_shader_objects;
2541 GLboolean ARB_shading_language_100;
2542 GLboolean ARB_shading_language_120;
2543 GLboolean ARB_shadow;
2544 GLboolean ARB_texture_border_clamp;
2545 GLboolean ARB_texture_compression;
2546 GLboolean ARB_texture_cube_map;
2547 GLboolean ARB_texture_env_combine;
2548 GLboolean ARB_texture_env_crossbar;
2549 GLboolean ARB_texture_env_dot3;
2550 GLboolean ARB_texture_float;
2551 GLboolean ARB_texture_mirrored_repeat;
2552 GLboolean ARB_texture_non_power_of_two;
2553 GLboolean ARB_transpose_matrix;
2554 GLboolean ARB_vertex_buffer_object;
2555 GLboolean ARB_vertex_program;
2556 GLboolean ARB_vertex_shader;
2557 GLboolean ARB_window_pos;
2558 GLboolean EXT_abgr;
2559 GLboolean EXT_bgra;
2560 GLboolean EXT_blend_color;
2561 GLboolean EXT_blend_equation_separate;
2562 GLboolean EXT_blend_func_separate;
2563 GLboolean EXT_blend_logic_op;
2564 GLboolean EXT_blend_minmax;
2565 GLboolean EXT_blend_subtract;
2566 GLboolean EXT_clip_volume_hint;
2567 GLboolean EXT_cull_vertex;
2568 GLboolean EXT_convolution;
2569 GLboolean EXT_compiled_vertex_array;
2570 GLboolean EXT_copy_texture;
2571 GLboolean EXT_depth_bounds_test;
2572 GLboolean EXT_draw_range_elements;
2573 GLboolean EXT_framebuffer_object;
2574 GLboolean EXT_fog_coord;
2575 GLboolean EXT_framebuffer_blit;
2576 GLboolean EXT_gpu_program_parameters;
2577 GLboolean EXT_histogram;
2578 GLboolean EXT_multi_draw_arrays;
2579 GLboolean EXT_paletted_texture;
2580 GLboolean EXT_packed_depth_stencil;
2581 GLboolean EXT_packed_pixels;
2582 GLboolean EXT_pixel_buffer_object;
2583 GLboolean EXT_point_parameters;
2584 GLboolean EXT_polygon_offset;
2585 GLboolean EXT_rescale_normal;
2586 GLboolean EXT_shadow_funcs;
2587 GLboolean EXT_secondary_color;
2588 GLboolean EXT_separate_specular_color;
2589 GLboolean EXT_shared_texture_palette;
2590 GLboolean EXT_stencil_wrap;
2591 GLboolean EXT_stencil_two_side;
2592 GLboolean EXT_subtexture;
2593 GLboolean EXT_texture;
2594 GLboolean EXT_texture_object;
2595 GLboolean EXT_texture3D;
2596 GLboolean EXT_texture_compression_s3tc;
2597 GLboolean EXT_texture_env_add;
2598 GLboolean EXT_texture_env_combine;
2599 GLboolean EXT_texture_env_dot3;
2600 GLboolean EXT_texture_filter_anisotropic;
2601 GLboolean EXT_texture_lod_bias;
2602 GLboolean EXT_texture_mirror_clamp;
2603 GLboolean EXT_texture_sRGB;
2604 GLboolean EXT_timer_query;
2605 GLboolean EXT_vertex_array;
2606 GLboolean EXT_vertex_array_set;
2607 /* vendor extensions */
2608 GLboolean APPLE_client_storage;
2609 GLboolean APPLE_packed_pixels;
2610 GLboolean APPLE_vertex_array_object;
2611 GLboolean ATI_texture_mirror_once;
2612 GLboolean ATI_texture_env_combine3;
2613 GLboolean ATI_fragment_shader;
2614 GLboolean ATI_separate_stencil;
2615 GLboolean IBM_rasterpos_clip;
2616 GLboolean IBM_multimode_draw_arrays;
2617 GLboolean MESA_pack_invert;
2618 GLboolean MESA_packed_depth_stencil;
2619 GLboolean MESA_program_debug;
2620 GLboolean MESA_resize_buffers;
2621 GLboolean MESA_ycbcr_texture;
2622 GLboolean MESA_texture_array;
2623 GLboolean NV_blend_square;
2624 GLboolean NV_fragment_program;
2625 GLboolean NV_light_max_exponent;
2626 GLboolean NV_point_sprite;
2627 GLboolean NV_texgen_reflection;
2628 GLboolean NV_texture_rectangle;
2629 GLboolean NV_vertex_program;
2630 GLboolean NV_vertex_program1_1;
2631 GLboolean OES_read_format;
2632 GLboolean SGI_color_matrix;
2633 GLboolean SGI_color_table;
2634 GLboolean SGI_texture_color_table;
2635 GLboolean SGIS_generate_mipmap;
2636 GLboolean SGIS_texture_edge_clamp;
2637 GLboolean SGIS_texture_lod;
2638 GLboolean SGIX_depth_texture;
2639 GLboolean SGIX_shadow;
2640 GLboolean SGIX_shadow_ambient; /* or GL_ARB_shadow_ambient */
2641 GLboolean TDFX_texture_compression_FXT1;
2642 GLboolean S3_s3tc;
2643 /*@}*/
2644 /* The extension string */
2645 const GLubyte *String;
2646 };
2647
2648
2649 /**
2650 * A stack of matrices (projection, modelview, color, texture, etc).
2651 */
2652 struct gl_matrix_stack
2653 {
2654 GLmatrix *Top; /**< points into Stack */
2655 GLmatrix *Stack; /**< array [MaxDepth] of GLmatrix */
2656 GLuint Depth; /**< 0 <= Depth < MaxDepth */
2657 GLuint MaxDepth; /**< size of Stack[] array */
2658 GLuint DirtyFlag; /**< _NEW_MODELVIEW or _NEW_PROJECTION, for example */
2659 };
2660
2661
2662 /**
2663 * \name Bits for image transfer operations
2664 *
2665 * \sa __GLcontextRec::ImageTransferState.
2666 */
2667 /*@{*/
2668 #define IMAGE_SCALE_BIAS_BIT 0x1
2669 #define IMAGE_SHIFT_OFFSET_BIT 0x2
2670 #define IMAGE_MAP_COLOR_BIT 0x4
2671 #define IMAGE_COLOR_TABLE_BIT 0x8
2672 #define IMAGE_CONVOLUTION_BIT 0x10
2673 #define IMAGE_POST_CONVOLUTION_SCALE_BIAS 0x20
2674 #define IMAGE_POST_CONVOLUTION_COLOR_TABLE_BIT 0x40
2675 #define IMAGE_COLOR_MATRIX_BIT 0x80
2676 #define IMAGE_POST_COLOR_MATRIX_COLOR_TABLE_BIT 0x100
2677 #define IMAGE_HISTOGRAM_BIT 0x200
2678 #define IMAGE_MIN_MAX_BIT 0x400
2679 #define IMAGE_CLAMP_BIT 0x800 /* extra */
2680
2681
2682 /** Pixel Transfer ops up to convolution */
2683 #define IMAGE_PRE_CONVOLUTION_BITS (IMAGE_SCALE_BIAS_BIT | \
2684 IMAGE_SHIFT_OFFSET_BIT | \
2685 IMAGE_MAP_COLOR_BIT | \
2686 IMAGE_COLOR_TABLE_BIT)
2687
2688 /** Pixel transfer ops after convolution */
2689 #define IMAGE_POST_CONVOLUTION_BITS (IMAGE_POST_CONVOLUTION_SCALE_BIAS | \
2690 IMAGE_POST_CONVOLUTION_COLOR_TABLE_BIT | \
2691 IMAGE_COLOR_MATRIX_BIT | \
2692 IMAGE_POST_COLOR_MATRIX_COLOR_TABLE_BIT |\
2693 IMAGE_HISTOGRAM_BIT | \
2694 IMAGE_MIN_MAX_BIT)
2695 /*@}*/
2696
2697
2698 /**
2699 * \name Bits to indicate what state has changed.
2700 *
2701 * 4 unused flags.
2702 */
2703 /*@{*/
2704 #define _NEW_MODELVIEW 0x1 /**< __GLcontextRec::ModelView */
2705 #define _NEW_PROJECTION 0x2 /**< __GLcontextRec::Projection */
2706 #define _NEW_TEXTURE_MATRIX 0x4 /**< __GLcontextRec::TextureMatrix */
2707 #define _NEW_COLOR_MATRIX 0x8 /**< __GLcontextRec::ColorMatrix */
2708 #define _NEW_ACCUM 0x10 /**< __GLcontextRec::Accum */
2709 #define _NEW_COLOR 0x20 /**< __GLcontextRec::Color */
2710 #define _NEW_DEPTH 0x40 /**< __GLcontextRec::Depth */
2711 #define _NEW_EVAL 0x80 /**< __GLcontextRec::Eval, __GLcontextRec::EvalMap */
2712 #define _NEW_FOG 0x100 /**< __GLcontextRec::Fog */
2713 #define _NEW_HINT 0x200 /**< __GLcontextRec::Hint */
2714 #define _NEW_LIGHT 0x400 /**< __GLcontextRec::Light */
2715 #define _NEW_LINE 0x800 /**< __GLcontextRec::Line */
2716 #define _NEW_PIXEL 0x1000 /**< __GLcontextRec::Pixel */
2717 #define _NEW_POINT 0x2000 /**< __GLcontextRec::Point */
2718 #define _NEW_POLYGON 0x4000 /**< __GLcontextRec::Polygon */
2719 #define _NEW_POLYGONSTIPPLE 0x8000 /**< __GLcontextRec::PolygonStipple */
2720 #define _NEW_SCISSOR 0x10000 /**< __GLcontextRec::Scissor */
2721 #define _NEW_STENCIL 0x20000 /**< __GLcontextRec::Stencil */
2722 #define _NEW_TEXTURE 0x40000 /**< __GLcontextRec::Texture */
2723 #define _NEW_TRANSFORM 0x80000 /**< __GLcontextRec::Transform */
2724 #define _NEW_VIEWPORT 0x100000 /**< __GLcontextRec::Viewport */
2725 #define _NEW_PACKUNPACK 0x200000 /**< __GLcontextRec::Pack, __GLcontextRec::Unpack */
2726 #define _NEW_ARRAY 0x400000 /**< __GLcontextRec::Array */
2727 #define _NEW_RENDERMODE 0x800000 /**< __GLcontextRec::RenderMode, __GLcontextRec::Feedback, __GLcontextRec::Select */
2728 #define _NEW_BUFFERS 0x1000000 /**< __GLcontextRec::Visual, __GLcontextRec::DrawBuffer, */
2729 #define _NEW_MULTISAMPLE 0x2000000 /**< __GLcontextRec::Multisample */
2730 #define _NEW_TRACK_MATRIX 0x4000000 /**< __GLcontextRec::VertexProgram */
2731 #define _NEW_PROGRAM 0x8000000 /**< __GLcontextRec::VertexProgram */
2732 #define _NEW_ALL ~0
2733 /*@}*/
2734
2735
2736 /**
2737 * \name Bits to track array state changes
2738 *
2739 * Also used to summarize array enabled.
2740 */
2741 /*@{*/
2742 #define _NEW_ARRAY_VERTEX VERT_BIT_POS
2743 #define _NEW_ARRAY_WEIGHT VERT_BIT_WEIGHT
2744 #define _NEW_ARRAY_NORMAL VERT_BIT_NORMAL
2745 #define _NEW_ARRAY_COLOR0 VERT_BIT_COLOR0
2746 #define _NEW_ARRAY_COLOR1 VERT_BIT_COLOR1
2747 #define _NEW_ARRAY_FOGCOORD VERT_BIT_FOG
2748 #define _NEW_ARRAY_INDEX VERT_BIT_COLOR_INDEX
2749 #define _NEW_ARRAY_EDGEFLAG VERT_BIT_EDGEFLAG
2750 #define _NEW_ARRAY_TEXCOORD_0 VERT_BIT_TEX0
2751 #define _NEW_ARRAY_TEXCOORD_1 VERT_BIT_TEX1
2752 #define _NEW_ARRAY_TEXCOORD_2 VERT_BIT_TEX2
2753 #define _NEW_ARRAY_TEXCOORD_3 VERT_BIT_TEX3
2754 #define _NEW_ARRAY_TEXCOORD_4 VERT_BIT_TEX4
2755 #define _NEW_ARRAY_TEXCOORD_5 VERT_BIT_TEX5
2756 #define _NEW_ARRAY_TEXCOORD_6 VERT_BIT_TEX6
2757 #define _NEW_ARRAY_TEXCOORD_7 VERT_BIT_TEX7
2758 #define _NEW_ARRAY_ATTRIB_0 VERT_BIT_GENERIC0 /* start at bit 16 */
2759 #define _NEW_ARRAY_ALL 0xffffffff
2760
2761
2762 #define _NEW_ARRAY_TEXCOORD(i) (_NEW_ARRAY_TEXCOORD_0 << (i))
2763 #define _NEW_ARRAY_ATTRIB(i) (_NEW_ARRAY_ATTRIB_0 << (i))
2764 /*@}*/
2765
2766
2767 /**
2768 * \name A bunch of flags that we think might be useful to drivers.
2769 *
2770 * Set in the __GLcontextRec::_TriangleCaps bitfield.
2771 */
2772 /*@{*/
2773 #define DD_FLATSHADE 0x1
2774 #define DD_SEPARATE_SPECULAR 0x2
2775 #define DD_TRI_CULL_FRONT_BACK 0x4 /* special case on some hw */
2776 #define DD_TRI_LIGHT_TWOSIDE 0x8
2777 #define DD_TRI_UNFILLED 0x10
2778 #define DD_TRI_SMOOTH 0x20
2779 #define DD_TRI_STIPPLE 0x40
2780 #define DD_TRI_OFFSET 0x80
2781 #define DD_LINE_SMOOTH 0x100
2782 #define DD_LINE_STIPPLE 0x200
2783 #define DD_LINE_WIDTH 0x400
2784 #define DD_POINT_SMOOTH 0x800
2785 #define DD_POINT_SIZE 0x1000
2786 #define DD_POINT_ATTEN 0x2000
2787 #define DD_TRI_TWOSTENCIL 0x4000
2788 /*@}*/
2789
2790
2791 /**
2792 * \name Define the state changes under which each of these bits might change
2793 */
2794 /*@{*/
2795 #define _DD_NEW_FLATSHADE _NEW_LIGHT
2796 #define _DD_NEW_SEPARATE_SPECULAR (_NEW_LIGHT | _NEW_FOG | _NEW_PROGRAM)
2797 #define _DD_NEW_TRI_CULL_FRONT_BACK _NEW_POLYGON
2798 #define _DD_NEW_TRI_LIGHT_TWOSIDE _NEW_LIGHT
2799 #define _DD_NEW_TRI_UNFILLED _NEW_POLYGON
2800 #define _DD_NEW_TRI_SMOOTH _NEW_POLYGON
2801 #define _DD_NEW_TRI_STIPPLE _NEW_POLYGON
2802 #define _DD_NEW_TRI_OFFSET _NEW_POLYGON
2803 #define _DD_NEW_LINE_SMOOTH _NEW_LINE
2804 #define _DD_NEW_LINE_STIPPLE _NEW_LINE
2805 #define _DD_NEW_LINE_WIDTH _NEW_LINE
2806 #define _DD_NEW_POINT_SMOOTH _NEW_POINT
2807 #define _DD_NEW_POINT_SIZE _NEW_POINT
2808 #define _DD_NEW_POINT_ATTEN _NEW_POINT
2809 /*@}*/
2810
2811
2812 #define _MESA_NEW_NEED_EYE_COORDS (_NEW_LIGHT | \
2813 _NEW_TEXTURE | \
2814 _NEW_POINT | \
2815 _NEW_PROGRAM | \
2816 _NEW_MODELVIEW)
2817
2818 #define _MESA_NEW_NEED_NORMALS (_NEW_LIGHT | \
2819 _NEW_TEXTURE)
2820
2821 #define _IMAGE_NEW_TRANSFER_STATE (_NEW_PIXEL | _NEW_COLOR_MATRIX)
2822
2823
2824
2825
2826 /*
2827 * Forward declaration of display list data types:
2828 */
2829 union node;
2830 typedef union node Node;
2831
2832
2833 /* This has to be included here. */
2834 #include "dd.h"
2835
2836
2837 #define NUM_VERTEX_FORMAT_ENTRIES (sizeof(GLvertexformat) / sizeof(void *))
2838
2839 /**
2840 * Core Mesa's support for tnl modules:
2841 */
2842 struct gl_tnl_module
2843 {
2844 /**
2845 * Vertex format to be lazily swapped into current dispatch.
2846 */
2847 const GLvertexformat *Current;
2848
2849 /**
2850 * \name Record of functions swapped out.
2851 * On restore, only need to swap these functions back in.
2852 */
2853 /*@{*/
2854 struct {
2855 _glapi_proc * location;
2856 _glapi_proc function;
2857 } Swapped[NUM_VERTEX_FORMAT_ENTRIES];
2858 GLuint SwapCount;
2859 /*@}*/
2860 };
2861
2862 /* Strictly this is a tnl/ private concept, but it doesn't seem
2863 * worthwhile adding a tnl private structure just to hold this one bit
2864 * of information:
2865 */
2866 #define MESA_DLIST_DANGLING_REFS 0x1
2867
2868 /* Provide a location where information about a display list can be
2869 * collected. Could be extended with driverPrivate structures,
2870 * etc. in the future.
2871 */
2872 struct mesa_display_list
2873 {
2874 Node *node;
2875 GLuint id;
2876 GLbitfield flags;
2877 };
2878
2879
2880 /**
2881 * State used during display list compilation and execution.
2882 */
2883 struct gl_dlist_state
2884 {
2885 struct mesa_display_list *CallStack[MAX_LIST_NESTING];
2886 GLuint CallDepth; /**< Current recursion calling depth */
2887
2888 struct mesa_display_list *CurrentList;
2889 Node *CurrentListPtr; /**< Head of list being compiled */
2890 GLuint CurrentListNum; /**< Number of the list being compiled */
2891 Node *CurrentBlock; /**< Pointer to current block of nodes */
2892 GLuint CurrentPos; /**< Index into current block of nodes */
2893
2894 GLvertexformat ListVtxfmt;
2895
2896 GLubyte ActiveAttribSize[VERT_ATTRIB_MAX];
2897 GLfloat CurrentAttrib[VERT_ATTRIB_MAX][4];
2898
2899 GLubyte ActiveMaterialSize[MAT_ATTRIB_MAX];
2900 GLfloat CurrentMaterial[MAT_ATTRIB_MAX][4];
2901
2902 GLubyte ActiveIndex;
2903 GLfloat CurrentIndex;
2904
2905 GLubyte ActiveEdgeFlag;
2906 GLboolean CurrentEdgeFlag;
2907 };
2908
2909
2910 /**
2911 * Mesa rendering context.
2912 *
2913 * This is the central context data structure for Mesa. Almost all
2914 * OpenGL state is contained in this structure.
2915 * Think of this as a base class from which device drivers will derive
2916 * sub classes.
2917 *
2918 * The GLcontext typedef names this structure.
2919 */
2920 struct __GLcontextRec
2921 {
2922 /** State possibly shared with other contexts in the address space */
2923 struct gl_shared_state *Shared;
2924
2925 /** \name API function pointer tables */
2926 /*@{*/
2927 struct _glapi_table *Save; /**< Display list save functions */
2928 struct _glapi_table *Exec; /**< Execute functions */
2929 struct _glapi_table *CurrentDispatch; /**< == Save or Exec !! */
2930 /*@}*/
2931
2932 GLvisual Visual;
2933 GLframebuffer *DrawBuffer; /**< buffer for writing */
2934 GLframebuffer *ReadBuffer; /**< buffer for reading */
2935 GLframebuffer *WinSysDrawBuffer; /**< set with MakeCurrent */
2936 GLframebuffer *WinSysReadBuffer; /**< set with MakeCurrent */
2937
2938 /**
2939 * Device driver function pointer table
2940 */
2941 struct dd_function_table Driver;
2942
2943 void *DriverCtx; /**< Points to device driver context/state */
2944
2945 /** Core/Driver constants */
2946 struct gl_constants Const;
2947
2948 /** \name The various 4x4 matrix stacks */
2949 /*@{*/
2950 struct gl_matrix_stack ModelviewMatrixStack;
2951 struct gl_matrix_stack ProjectionMatrixStack;
2952 struct gl_matrix_stack ColorMatrixStack;
2953 struct gl_matrix_stack TextureMatrixStack[MAX_TEXTURE_COORD_UNITS];
2954 struct gl_matrix_stack ProgramMatrixStack[MAX_PROGRAM_MATRICES];
2955 struct gl_matrix_stack *CurrentStack; /**< Points to one of the above stacks */
2956 /*@}*/
2957
2958 /** Combined modelview and projection matrix */
2959 GLmatrix _ModelProjectMatrix;
2960
2961 /** \name Display lists */
2962 struct gl_dlist_state ListState;
2963
2964 GLboolean ExecuteFlag; /**< Execute GL commands? */
2965 GLboolean CompileFlag; /**< Compile GL commands into display list? */
2966
2967 /** Extension information */
2968 struct gl_extensions Extensions;
2969
2970 /** \name State attribute stack (for glPush/PopAttrib) */
2971 /*@{*/
2972 GLuint AttribStackDepth;
2973 struct gl_attrib_node *AttribStack[MAX_ATTRIB_STACK_DEPTH];
2974 /*@}*/
2975
2976 /** \name Renderer attribute groups
2977 *
2978 * We define a struct for each attribute group to make pushing and popping
2979 * attributes easy. Also it's a good organization.
2980 */
2981 /*@{*/
2982 struct gl_accum_attrib Accum; /**< Accum buffer attributes */
2983 struct gl_colorbuffer_attrib Color; /**< Color buffer attributes */
2984 struct gl_current_attrib Current; /**< Current attributes */
2985 struct gl_depthbuffer_attrib Depth; /**< Depth buffer attributes */
2986 struct gl_eval_attrib Eval; /**< Eval attributes */
2987 struct gl_fog_attrib Fog; /**< Fog attributes */
2988 struct gl_hint_attrib Hint; /**< Hint attributes */
2989 struct gl_light_attrib Light; /**< Light attributes */
2990 struct gl_line_attrib Line; /**< Line attributes */
2991 struct gl_list_attrib List; /**< List attributes */
2992 struct gl_multisample_attrib Multisample;
2993 struct gl_pixel_attrib Pixel; /**< Pixel attributes */
2994 struct gl_point_attrib Point; /**< Point attributes */
2995 struct gl_polygon_attrib Polygon; /**< Polygon attributes */
2996 GLuint PolygonStipple[32]; /**< Polygon stipple */
2997 struct gl_scissor_attrib Scissor; /**< Scissor attributes */
2998 struct gl_stencil_attrib Stencil; /**< Stencil buffer attributes */
2999 struct gl_texture_attrib Texture; /**< Texture attributes */
3000 struct gl_transform_attrib Transform; /**< Transformation attributes */
3001 struct gl_viewport_attrib Viewport; /**< Viewport attributes */
3002 /*@}*/
3003
3004 /** \name Client attribute stack */
3005 /*@{*/
3006 GLuint ClientAttribStackDepth;
3007 struct gl_attrib_node *ClientAttribStack[MAX_CLIENT_ATTRIB_STACK_DEPTH];
3008 /*@}*/
3009
3010 /** \name Client attribute groups */
3011 /*@{*/
3012 struct gl_array_attrib Array; /**< Vertex arrays */
3013 struct gl_pixelstore_attrib Pack; /**< Pixel packing */
3014 struct gl_pixelstore_attrib Unpack; /**< Pixel unpacking */
3015 struct gl_pixelstore_attrib DefaultPacking; /**< Default params */
3016 /*@}*/
3017
3018 /** \name Other assorted state (not pushed/popped on attribute stack) */
3019 /*@{*/
3020 struct gl_pixelmaps PixelMaps;
3021 struct gl_histogram_attrib Histogram;
3022 struct gl_minmax_attrib MinMax;
3023 struct gl_convolution_attrib Convolution1D;
3024 struct gl_convolution_attrib Convolution2D;
3025 struct gl_convolution_attrib Separable2D;
3026
3027 struct gl_evaluators EvalMap; /**< All evaluators */
3028 struct gl_feedback Feedback; /**< Feedback */
3029 struct gl_selection Select; /**< Selection */
3030
3031 struct gl_color_table ColorTable[COLORTABLE_MAX];
3032 struct gl_color_table ProxyColorTable[COLORTABLE_MAX];
3033 #if 0
3034 struct gl_color_table PostConvolutionColorTable;
3035 struct gl_color_table ProxyPostConvolutionColorTable;
3036 struct gl_color_table PostColorMatrixColorTable;
3037 struct gl_color_table ProxyPostColorMatrixColorTable;
3038 #endif
3039
3040 struct gl_program_state Program; /**< for vertex or fragment progs */
3041 struct gl_vertex_program_state VertexProgram; /**< GL_ARB/NV_vertex_program */
3042 struct gl_fragment_program_state FragmentProgram; /**< GL_ARB/NV_vertex_program */
3043 struct gl_ati_fragment_shader_state ATIFragmentShader; /**< GL_ATI_fragment_shader */
3044
3045 struct gl_query_state Query; /**< GL_ARB_occlusion_query */
3046
3047 struct gl_shader_state Shader; /**< GLSL shader object state */
3048 /*@}*/
3049
3050 #if FEATURE_EXT_framebuffer_object
3051 struct gl_renderbuffer *CurrentRenderbuffer;
3052 #endif
3053
3054 GLenum ErrorValue; /**< Last error code */
3055 GLenum RenderMode; /**< either GL_RENDER, GL_SELECT, GL_FEEDBACK */
3056 GLbitfield NewState; /**< bitwise-or of _NEW_* flags */
3057
3058 /** \name Derived state */
3059 /*@{*/
3060 GLbitfield _TriangleCaps; /**< bitwise-or of DD_* flags */
3061 GLbitfield _ImageTransferState;/**< bitwise-or of IMAGE_*_BIT flags */
3062 GLfloat _EyeZDir[3];
3063 GLfloat _ModelViewInvScale;
3064 GLboolean _NeedEyeCoords;
3065 GLboolean _ForceEyeCoords;
3066 GLenum _CurrentProgram; /* currently executing program */
3067
3068 GLuint TextureStateTimestamp; /* detect changes to shared state */
3069
3070 struct gl_shine_tab *_ShineTable[2]; /**< Active shine tables */
3071 struct gl_shine_tab *_ShineTabList; /**< MRU list of inactive shine tables */
3072 /**@}*/
3073
3074 struct gl_list_extensions ListExt; /**< driver dlist extensions */
3075
3076
3077 GLuint _Facing; /**< This is a hack for 2-sided stencil test.
3078 *
3079 * We don't have a better way to communicate this value from
3080 * swrast_setup to swrast. */
3081
3082 /** \name For debugging/development only */
3083 /*@{*/
3084 GLboolean FirstTimeCurrent;
3085 /*@}*/
3086
3087 /** Dither disable via MESA_NO_DITHER env var */
3088 GLboolean NoDither;
3089
3090 /** software compression/decompression supported or not */
3091 GLboolean Mesa_DXTn;
3092
3093 /** Core tnl module support */
3094 struct gl_tnl_module TnlModule;
3095
3096 /**
3097 * \name Hooks for module contexts.
3098 *
3099 * These will eventually live in the driver or elsewhere.
3100 */
3101 /*@{*/
3102 void *swrast_context;
3103 void *swsetup_context;
3104 void *swtnl_context;
3105 void *swtnl_im;
3106 struct st_context *st;
3107 void *aelt_context;
3108 /*@}*/
3109 };
3110
3111
3112 /** The string names for GL_POINT, GL_LINE_LOOP, etc */
3113 extern const char *_mesa_prim_name[GL_POLYGON+4];
3114
3115
3116 #ifdef DEBUG
3117 extern int MESA_VERBOSE;
3118 extern int MESA_DEBUG_FLAGS;
3119 # define MESA_FUNCTION __FUNCTION__
3120 #else
3121 # define MESA_VERBOSE 0
3122 # define MESA_DEBUG_FLAGS 0
3123 # define MESA_FUNCTION "a function"
3124 # ifndef NDEBUG
3125 # define NDEBUG
3126 # endif
3127 #endif
3128
3129
3130 enum _verbose
3131 {
3132 VERBOSE_VARRAY = 0x0001,
3133 VERBOSE_TEXTURE = 0x0002,
3134 VERBOSE_IMMEDIATE = 0x0004,
3135 VERBOSE_PIPELINE = 0x0008,
3136 VERBOSE_DRIVER = 0x0010,
3137 VERBOSE_STATE = 0x0020,
3138 VERBOSE_API = 0x0040,
3139 VERBOSE_DISPLAY_LIST = 0x0100,
3140 VERBOSE_LIGHTING = 0x0200,
3141 VERBOSE_PRIMS = 0x0400,
3142 VERBOSE_VERTS = 0x0800,
3143 VERBOSE_DISASSEM = 0x1000
3144 };
3145
3146
3147 enum _debug
3148 {
3149 DEBUG_ALWAYS_FLUSH = 0x1
3150 };
3151
3152
3153
3154 #define Elements(x) sizeof(x)/sizeof(*(x))
3155
3156
3157 #endif /* TYPES_H */