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