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