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