src/mesa/main/mtypes.h

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