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