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