src/mesa/main/texstate.c

   1 /*
   2  * Mesa 3-D graphics library
   3  * Version:  7.5
   4  *
   5  * Copyright (C) 1999-2007  Brian Paul   All Rights Reserved.
   6  *
   7  * Permission is hereby granted, free of charge, to any person obtaining a
   8  * copy of this software and associated documentation files (the "Software"),
   9  * to deal in the Software without restriction, including without limitation
  10  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  11  * and/or sell copies of the Software, and to permit persons to whom the
  12  * Software is furnished to do so, subject to the following conditions:
  13  *
  14  * The above copyright notice and this permission notice shall be included
  15  * in all copies or substantial portions of the Software.
  16  *
  17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  18  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  19  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  20  * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
  21  * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  22  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  23  */
  24
  25 /**
  26  * \file texstate.c
  27  *
  28  * Texture state handling.
  29  */
  30
  31 #include "glheader.h"
  32 #include "mfeatures.h"
  33 #include "colormac.h"
  34 #include "colortab.h"
  35 #include "context.h"
  36 #include "enums.h"
  37 #include "macros.h"
  38 #include "texobj.h"
  39 #include "teximage.h"
  40 #include "texstate.h"
  41 #include "mtypes.h"
  42
  43
  44
  45 /**
  46  * Default texture combine environment state.  This is used to initialize
  47  * a context's texture units and as the basis for converting "classic"
  48  * texture environmnets to ARB_texture_env_combine style values.
  49  */
  50 static const struct gl_tex_env_combine_state default_combine_state = {
  51    GL_MODULATE, GL_MODULATE,
  52    { GL_TEXTURE, GL_PREVIOUS, GL_CONSTANT, GL_CONSTANT },
  53    { GL_TEXTURE, GL_PREVIOUS, GL_CONSTANT, GL_CONSTANT },
  54    { GL_SRC_COLOR, GL_SRC_COLOR, GL_SRC_ALPHA, GL_SRC_ALPHA },
  55    { GL_SRC_ALPHA, GL_SRC_ALPHA, GL_SRC_ALPHA, GL_SRC_ALPHA },
  56    0, 0,
  57    2, 2
  58 };
  59
  60
  61
  62 /**
  63  * Used by glXCopyContext to copy texture state from one context to another.
  64  */
  65 void
  66 _mesa_copy_texture_state( const GLcontext *src, GLcontext *dst )
  67 {
  68    GLuint u, tex;
  69
  70    ASSERT(src);
  71    ASSERT(dst);
  72
  73    dst->Texture.CurrentUnit = src->Texture.CurrentUnit;
  74    dst->Texture._GenFlags = src->Texture._GenFlags;
  75    dst->Texture._TexGenEnabled = src->Texture._TexGenEnabled;
  76    dst->Texture._TexMatEnabled = src->Texture._TexMatEnabled;
  77    dst->Texture.SharedPalette = src->Texture.SharedPalette;
  78
  79    /* per-unit state */
  80    for (u = 0; u < src->Const.MaxTextureImageUnits; u++) {
  81       dst->Texture.Unit[u].Enabled = src->Texture.Unit[u].Enabled;
  82       dst->Texture.Unit[u].EnvMode = src->Texture.Unit[u].EnvMode;
  83       COPY_4V(dst->Texture.Unit[u].EnvColor, src->Texture.Unit[u].EnvColor);
  84       dst->Texture.Unit[u].TexGenEnabled = src->Texture.Unit[u].TexGenEnabled;
  85       dst->Texture.Unit[u].GenS = src->Texture.Unit[u].GenS;
  86       dst->Texture.Unit[u].GenT = src->Texture.Unit[u].GenT;
  87       dst->Texture.Unit[u].GenR = src->Texture.Unit[u].GenR;
  88       dst->Texture.Unit[u].GenQ = src->Texture.Unit[u].GenQ;
  89       dst->Texture.Unit[u].LodBias = src->Texture.Unit[u].LodBias;
  90
  91       /* GL_EXT_texture_env_combine */
  92       dst->Texture.Unit[u].Combine = src->Texture.Unit[u].Combine;
  93
  94       /* GL_ATI_envmap_bumpmap - need this? */
  95       dst->Texture.Unit[u].BumpTarget = src->Texture.Unit[u].BumpTarget;
  96       COPY_4V(dst->Texture.Unit[u].RotMatrix, src->Texture.Unit[u].RotMatrix);
  97
  98       /*
  99        * XXX strictly speaking, we should compare texture names/ids and
 100        * bind textures in the dest context according to id.  For now, only
 101        * copy bindings if the contexts share the same pool of textures to
 102        * avoid refcounting bugs.
 103        */
 104       if (dst->Shared == src->Shared) {
 105          /* copy texture object bindings, not contents of texture objects */
 106          _mesa_lock_context_textures(dst);
 107
 108          for (tex = 0; tex < NUM_TEXTURE_TARGETS; tex++) {
 109             _mesa_reference_texobj(&dst->Texture.Unit[u].CurrentTex[tex],
 110                                    src->Texture.Unit[u].CurrentTex[tex]);
 111          }
 112          _mesa_unlock_context_textures(dst);
 113       }
 114    }
 115 }
 116
 117
 118 /*
 119  * For debugging
 120  */
 121 void
 122 _mesa_print_texunit_state( GLcontext *ctx, GLuint unit )
 123 {
 124    const struct gl_texture_unit *texUnit = ctx->Texture.Unit + unit;
 125    _mesa_printf("Texture Unit %d\n", unit);
 126    _mesa_printf("  GL_TEXTURE_ENV_MODE = %s\n", _mesa_lookup_enum_by_nr(texUnit->EnvMode));
 127    _mesa_printf("  GL_COMBINE_RGB = %s\n", _mesa_lookup_enum_by_nr(texUnit->Combine.ModeRGB));
 128    _mesa_printf("  GL_COMBINE_ALPHA = %s\n", _mesa_lookup_enum_by_nr(texUnit->Combine.ModeA));
 129    _mesa_printf("  GL_SOURCE0_RGB = %s\n", _mesa_lookup_enum_by_nr(texUnit->Combine.SourceRGB[0]));
 130    _mesa_printf("  GL_SOURCE1_RGB = %s\n", _mesa_lookup_enum_by_nr(texUnit->Combine.SourceRGB[1]));
 131    _mesa_printf("  GL_SOURCE2_RGB = %s\n", _mesa_lookup_enum_by_nr(texUnit->Combine.SourceRGB[2]));
 132    _mesa_printf("  GL_SOURCE0_ALPHA = %s\n", _mesa_lookup_enum_by_nr(texUnit->Combine.SourceA[0]));
 133    _mesa_printf("  GL_SOURCE1_ALPHA = %s\n", _mesa_lookup_enum_by_nr(texUnit->Combine.SourceA[1]));
 134    _mesa_printf("  GL_SOURCE2_ALPHA = %s\n", _mesa_lookup_enum_by_nr(texUnit->Combine.SourceA[2]));
 135    _mesa_printf("  GL_OPERAND0_RGB = %s\n", _mesa_lookup_enum_by_nr(texUnit->Combine.OperandRGB[0]));
 136    _mesa_printf("  GL_OPERAND1_RGB = %s\n", _mesa_lookup_enum_by_nr(texUnit->Combine.OperandRGB[1]));
 137    _mesa_printf("  GL_OPERAND2_RGB = %s\n", _mesa_lookup_enum_by_nr(texUnit->Combine.OperandRGB[2]));
 138    _mesa_printf("  GL_OPERAND0_ALPHA = %s\n", _mesa_lookup_enum_by_nr(texUnit->Combine.OperandA[0]));
 139    _mesa_printf("  GL_OPERAND1_ALPHA = %s\n", _mesa_lookup_enum_by_nr(texUnit->Combine.OperandA[1]));
 140    _mesa_printf("  GL_OPERAND2_ALPHA = %s\n", _mesa_lookup_enum_by_nr(texUnit->Combine.OperandA[2]));
 141    _mesa_printf("  GL_RGB_SCALE = %d\n", 1 << texUnit->Combine.ScaleShiftRGB);
 142    _mesa_printf("  GL_ALPHA_SCALE = %d\n", 1 << texUnit->Combine.ScaleShiftA);
 143    _mesa_printf("  GL_TEXTURE_ENV_COLOR = (%f, %f, %f, %f)\n", texUnit->EnvColor[0], texUnit->EnvColor[1], texUnit->EnvColor[2], texUnit->EnvColor[3]);
 144 }
 145
 146
 147
 148 /**********************************************************************/
 149 /*                       Texture Environment                          */
 150 /**********************************************************************/
 151
 152 /**
 153  * Convert "classic" texture environment to ARB_texture_env_combine style
 154  * environments.
 155  *
 156  * \param state  texture_env_combine state vector to be filled-in.
 157  * \param mode   Classic texture environment mode (i.e., \c GL_REPLACE,
 158  *               \c GL_BLEND, \c GL_DECAL, etc.).
 159  * \param texBaseFormat  Base format of the texture associated with the
 160  *               texture unit.
 161  */
 162 static void
 163 calculate_derived_texenv( struct gl_tex_env_combine_state *state,
 164                           GLenum mode, GLenum texBaseFormat )
 165 {
 166    GLenum mode_rgb;
 167    GLenum mode_a;
 168
 169    *state = default_combine_state;
 170
 171    switch (texBaseFormat) {
 172    case GL_ALPHA:
 173       state->SourceRGB[0] = GL_PREVIOUS;
 174       break;
 175
 176    case GL_LUMINANCE_ALPHA:
 177    case GL_INTENSITY:
 178    case GL_RGBA:
 179       break;
 180
 181    case GL_LUMINANCE:
 182    case GL_RGB:
 183    case GL_YCBCR_MESA:
 184    case GL_DUDV_ATI:
 185       state->SourceA[0] = GL_PREVIOUS;
 186       break;
 187
 188    default:
 189       _mesa_problem(NULL,
 190                     "Invalid texBaseFormat 0x%x in calculate_derived_texenv",
 191                     texBaseFormat);
 192       return;
 193    }
 194
 195    if (mode == GL_REPLACE_EXT)
 196       mode = GL_REPLACE;
 197
 198    switch (mode) {
 199    case GL_REPLACE:
 200    case GL_MODULATE:
 201       mode_rgb = (texBaseFormat == GL_ALPHA) ? GL_REPLACE : mode;
 202       mode_a   = mode;
 203       break;
 204
 205    case GL_DECAL:
 206       mode_rgb = GL_INTERPOLATE;
 207       mode_a   = GL_REPLACE;
 208
 209       state->SourceA[0] = GL_PREVIOUS;
 210
 211       /* Having alpha / luminance / intensity textures replace using the
 212        * incoming fragment color matches the definition in NV_texture_shader.
 213        * The 1.5 spec simply marks these as "undefined".
 214        */
 215       switch (texBaseFormat) {
 216       case GL_ALPHA:
 217       case GL_LUMINANCE:
 218       case GL_LUMINANCE_ALPHA:
 219       case GL_INTENSITY:
 220          state->SourceRGB[0] = GL_PREVIOUS;
 221          break;
 222       case GL_RGB:
 223       case GL_YCBCR_MESA:
 224       case GL_DUDV_ATI:
 225          mode_rgb = GL_REPLACE;
 226          break;
 227       case GL_RGBA:
 228          state->SourceRGB[2] = GL_TEXTURE;
 229          break;
 230       }
 231       break;
 232
 233    case GL_BLEND:
 234       mode_rgb = GL_INTERPOLATE;
 235       mode_a   = GL_MODULATE;
 236
 237       switch (texBaseFormat) {
 238       case GL_ALPHA:
 239          mode_rgb = GL_REPLACE;
 240          break;
 241       case GL_INTENSITY:
 242          mode_a = GL_INTERPOLATE;
 243          state->SourceA[0] = GL_CONSTANT;
 244          state->OperandA[2] = GL_SRC_ALPHA;
 245          /* FALLTHROUGH */
 246       case GL_LUMINANCE:
 247       case GL_RGB:
 248       case GL_LUMINANCE_ALPHA:
 249       case GL_RGBA:
 250       case GL_YCBCR_MESA:
 251       case GL_DUDV_ATI:
 252          state->SourceRGB[2] = GL_TEXTURE;
 253          state->SourceA[2]   = GL_TEXTURE;
 254          state->SourceRGB[0] = GL_CONSTANT;
 255          state->OperandRGB[2] = GL_SRC_COLOR;
 256          break;
 257       }
 258       break;
 259
 260    case GL_ADD:
 261       mode_rgb = (texBaseFormat == GL_ALPHA) ? GL_REPLACE : GL_ADD;
 262       mode_a   = (texBaseFormat == GL_INTENSITY) ? GL_ADD : GL_MODULATE;
 263       break;
 264
 265    default:
 266       _mesa_problem(NULL,
 267                     "Invalid texture env mode 0x%x in calculate_derived_texenv",
 268                     mode);
 269       return;
 270    }
 271
 272    state->ModeRGB = (state->SourceRGB[0] != GL_PREVIOUS)
 273        ? mode_rgb : GL_REPLACE;
 274    state->ModeA   = (state->SourceA[0]   != GL_PREVIOUS)
 275        ? mode_a   : GL_REPLACE;
 276 }
 277
 278
 279
 280
 281 /* GL_ARB_multitexture */
 282 void GLAPIENTRY
 283 _mesa_ActiveTextureARB(GLenum texture)
 284 {
 285    GET_CURRENT_CONTEXT(ctx);
 286    const GLuint texUnit = texture - GL_TEXTURE0;
 287    ASSERT_OUTSIDE_BEGIN_END(ctx);
 288
 289    if (MESA_VERBOSE & (VERBOSE_API|VERBOSE_TEXTURE))
 290       _mesa_debug(ctx, "glActiveTexture %s\n",
 291                   _mesa_lookup_enum_by_nr(texture));
 292
 293    if (texUnit >= ctx->Const.MaxTextureImageUnits) {
 294       _mesa_error(ctx, GL_INVALID_ENUM, "glActiveTexture(texture=%s)",
 295                   _mesa_lookup_enum_by_nr(texture));
 296       return;
 297    }
 298
 299    if (ctx->Texture.CurrentUnit == texUnit)
 300       return;
 301
 302    FLUSH_VERTICES(ctx, _NEW_TEXTURE);
 303
 304    ctx->Texture.CurrentUnit = texUnit;
 305    if (ctx->Transform.MatrixMode == GL_TEXTURE) {
 306       /* update current stack pointer */
 307       ctx->CurrentStack = &ctx->TextureMatrixStack[texUnit];
 308    }
 309 }
 310
 311
 312 /* GL_ARB_multitexture */
 313 void GLAPIENTRY
 314 _mesa_ClientActiveTextureARB(GLenum texture)
 315 {
 316    GET_CURRENT_CONTEXT(ctx);
 317    GLuint texUnit = texture - GL_TEXTURE0;
 318    ASSERT_OUTSIDE_BEGIN_END(ctx);
 319
 320    if (MESA_VERBOSE & (VERBOSE_API | VERBOSE_TEXTURE))
 321       _mesa_debug(ctx, "glClientActiveTexture %s\n",
 322                   _mesa_lookup_enum_by_nr(texture));
 323
 324    if (texUnit >= ctx->Const.MaxTextureCoordUnits) {
 325       _mesa_error(ctx, GL_INVALID_ENUM, "glClientActiveTexture(texture)");
 326       return;
 327    }
 328
 329    if (ctx->Array.ActiveTexture == texUnit)
 330       return;
 331
 332    FLUSH_VERTICES(ctx, _NEW_ARRAY);
 333    ctx->Array.ActiveTexture = texUnit;
 334 }
 335
 336
 337
 338 /**********************************************************************/
 339 /*****                    State management                        *****/
 340 /**********************************************************************/
 341
 342
 343 /**
 344  * \note This routine refers to derived texture attribute values to
 345  * compute the ENABLE_TEXMAT flags, but is only called on
 346  * _NEW_TEXTURE_MATRIX.  On changes to _NEW_TEXTURE, the ENABLE_TEXMAT
 347  * flags are updated by _mesa_update_textures(), below.
 348  *
 349  * \param ctx GL context.
 350  */
 351 static void
 352 update_texture_matrices( GLcontext *ctx )
 353 {
 354    GLuint u;
 355
 356    ctx->Texture._TexMatEnabled = 0x0;
 357
 358    for (u = 0; u < ctx->Const.MaxTextureCoordUnits; u++) {
 359       if (_math_matrix_is_dirty(ctx->TextureMatrixStack[u].Top)) {
 360          _math_matrix_analyse( ctx->TextureMatrixStack[u].Top );
 361
 362          if (ctx->Texture.Unit[u]._ReallyEnabled &&
 363              ctx->TextureMatrixStack[u].Top->type != MATRIX_IDENTITY)
 364             ctx->Texture._TexMatEnabled |= ENABLE_TEXMAT(u);
 365       }
 366    }
 367 }
 368
 369
 370 /**
 371  * Examine texture unit's combine/env state to update derived state.
 372  */
 373 static void
 374 update_tex_combine(GLcontext *ctx, struct gl_texture_unit *texUnit)
 375 {
 376    struct gl_tex_env_combine_state *combine;
 377
 378    /* Set the texUnit->_CurrentCombine field to point to the user's combiner
 379     * state, or the combiner state which is derived from traditional texenv
 380     * mode.
 381     */
 382    if (texUnit->EnvMode == GL_COMBINE ||
 383        texUnit->EnvMode == GL_COMBINE4_NV) {
 384       texUnit->_CurrentCombine = & texUnit->Combine;
 385    }
 386    else {
 387       const struct gl_texture_object *texObj = texUnit->_Current;
 388       GLenum format = texObj->Image[0][texObj->BaseLevel]->_BaseFormat;
 389       if (format == GL_COLOR_INDEX) {
 390          format = GL_RGBA;  /* a bit of a hack */
 391       }
 392       else if (format == GL_DEPTH_COMPONENT ||
 393                format == GL_DEPTH_STENCIL_EXT) {
 394          format = texObj->DepthMode;
 395       }
 396       calculate_derived_texenv(&texUnit->_EnvMode, texUnit->EnvMode, format);
 397       texUnit->_CurrentCombine = & texUnit->_EnvMode;
 398    }
 399
 400    combine = texUnit->_CurrentCombine;
 401
 402    /* Determine number of source RGB terms in the combiner function */
 403    switch (combine->ModeRGB) {
 404    case GL_REPLACE:
 405       combine->_NumArgsRGB = 1;
 406       break;
 407    case GL_ADD:
 408    case GL_ADD_SIGNED:
 409       if (texUnit->EnvMode == GL_COMBINE4_NV)
 410          combine->_NumArgsRGB = 4;
 411       else
 412          combine->_NumArgsRGB = 2;
 413       break;
 414    case GL_MODULATE:
 415    case GL_SUBTRACT:
 416    case GL_DOT3_RGB:
 417    case GL_DOT3_RGBA:
 418    case GL_DOT3_RGB_EXT:
 419    case GL_DOT3_RGBA_EXT:
 420       combine->_NumArgsRGB = 2;
 421       break;
 422    case GL_INTERPOLATE:
 423    case GL_MODULATE_ADD_ATI:
 424    case GL_MODULATE_SIGNED_ADD_ATI:
 425    case GL_MODULATE_SUBTRACT_ATI:
 426       combine->_NumArgsRGB = 3;
 427       break;
 428    case GL_BUMP_ENVMAP_ATI:
 429       /* no real arguments for this case */
 430       combine->_NumArgsRGB = 0;
 431       break;
 432    default:
 433       combine->_NumArgsRGB = 0;
 434       _mesa_problem(ctx, "invalid RGB combine mode in update_texture_state");
 435       return;
 436    }
 437
 438    /* Determine number of source Alpha terms in the combiner function */
 439    switch (combine->ModeA) {
 440    case GL_REPLACE:
 441       combine->_NumArgsA = 1;
 442       break;
 443    case GL_ADD:
 444    case GL_ADD_SIGNED:
 445       if (texUnit->EnvMode == GL_COMBINE4_NV)
 446          combine->_NumArgsA = 4;
 447       else
 448          combine->_NumArgsA = 2;
 449       break;
 450    case GL_MODULATE:
 451    case GL_SUBTRACT:
 452       combine->_NumArgsA = 2;
 453       break;
 454    case GL_INTERPOLATE:
 455    case GL_MODULATE_ADD_ATI:
 456    case GL_MODULATE_SIGNED_ADD_ATI:
 457    case GL_MODULATE_SUBTRACT_ATI:
 458       combine->_NumArgsA = 3;
 459       break;
 460    default:
 461       combine->_NumArgsA = 0;
 462       _mesa_problem(ctx, "invalid Alpha combine mode in update_texture_state");
 463       break;
 464    }
 465 }
 466
 467
 468 /**
 469  * \note This routine refers to derived texture matrix values to
 470  * compute the ENABLE_TEXMAT flags, but is only called on
 471  * _NEW_TEXTURE.  On changes to _NEW_TEXTURE_MATRIX, the ENABLE_TEXMAT
 472  * flags are updated by _mesa_update_texture_matrices, above.
 473  *
 474  * \param ctx GL context.
 475  */
 476 static void
 477 update_texture_state( GLcontext *ctx )
 478 {
 479    GLuint unit;
 480    struct gl_fragment_program *fprog = NULL;
 481    struct gl_vertex_program *vprog = NULL;
 482    GLbitfield enabledFragUnits = 0x0;
 483
 484    if (ctx->Shader.CurrentProgram &&
 485        ctx->Shader.CurrentProgram->LinkStatus) {
 486       fprog = ctx->Shader.CurrentProgram->FragmentProgram;
 487       vprog = ctx->Shader.CurrentProgram->VertexProgram;
 488    }
 489    else {
 490       if (ctx->FragmentProgram._Enabled) {
 491          fprog = ctx->FragmentProgram.Current;
 492       }
 493       if (ctx->VertexProgram._Enabled) {
 494          /* XXX enable this if/when non-shader vertex programs get
 495           * texture fetches:
 496          vprog = ctx->VertexProgram.Current;
 497          */
 498       }
 499    }
 500
 501    /* TODO: only set this if there are actual changes */
 502    ctx->NewState |= _NEW_TEXTURE;
 503
 504    ctx->Texture._EnabledUnits = 0x0;
 505    ctx->Texture._GenFlags = 0x0;
 506    ctx->Texture._TexMatEnabled = 0x0;
 507    ctx->Texture._TexGenEnabled = 0x0;
 508
 509    /*
 510     * Update texture unit state.
 511     */
 512    for (unit = 0; unit < ctx->Const.MaxTextureImageUnits; unit++) {
 513       struct gl_texture_unit *texUnit = &ctx->Texture.Unit[unit];
 514       GLbitfield enabledVertTargets = 0x0;
 515       GLbitfield enabledFragTargets = 0x0;
 516       GLbitfield enabledTargets = 0x0;
 517       GLuint texIndex;
 518
 519       /* Get the bitmask of texture target enables.
 520        * enableBits will be a mask of the TEXTURE_*_BIT flags indicating
 521        * which texture targets are enabled (fixed function) or referenced
 522        * by a fragment shader/program.  When multiple flags are set, we'll
 523        * settle on the one with highest priority (see below).
 524        */
 525       if (vprog) {
 526          enabledVertTargets |= vprog->Base.TexturesUsed[unit];
 527       }
 528
 529       if (fprog) {
 530          enabledFragTargets |= fprog->Base.TexturesUsed[unit];
 531       }
 532       else {
 533          /* fixed-function fragment program */
 534          enabledFragTargets |= texUnit->Enabled;
 535       }
 536
 537       enabledTargets = enabledVertTargets | enabledFragTargets;
 538
 539       texUnit->_ReallyEnabled = 0x0;
 540
 541       if (enabledTargets == 0x0) {
 542          /* neither vertex nor fragment processing uses this unit */
 543          continue;
 544       }
 545
 546       /* Look for the highest priority texture target that's enabled (or used
 547        * by the vert/frag shaders) and "complete".  That's the one we'll use
 548        * for texturing.  If we're using vert/frag program we're guaranteed
 549        * that bitcount(enabledBits) <= 1.
 550        * Note that the TEXTURE_x_INDEX values are in high to low priority.
 551        */
 552       for (texIndex = 0; texIndex < NUM_TEXTURE_TARGETS; texIndex++) {
 553          if (enabledTargets & (1 << texIndex)) {
 554             struct gl_texture_object *texObj = texUnit->CurrentTex[texIndex];
 555             if (!texObj->_Complete) {
 556                _mesa_test_texobj_completeness(ctx, texObj);
 557             }
 558             if (texObj->_Complete) {
 559                texUnit->_ReallyEnabled = 1 << texIndex;
 560                _mesa_reference_texobj(&texUnit->_Current, texObj);
 561                break;
 562             }
 563          }
 564       }
 565
 566       if (!texUnit->_ReallyEnabled) {
 567          if (fprog) {
 568             /* If we get here it means the shader is expecting a texture
 569              * object, but there isn't one (or it's incomplete).  Use the
 570              * fallback texture.
 571              */
 572             struct gl_texture_object *texObj = _mesa_get_fallback_texture(ctx);
 573             texUnit->_ReallyEnabled = 1 << TEXTURE_2D_INDEX;
 574             _mesa_reference_texobj(&texUnit->_Current, texObj);
 575          }
 576          else {
 577             /* fixed-function: texture unit is really disabled */
 578             continue;
 579          }
 580       }
 581
 582       /* if we get here, we know this texture unit is enabled */
 583
 584       ctx->Texture._EnabledUnits |= (1 << unit);
 585
 586       if (enabledFragTargets)
 587          enabledFragUnits |= (1 << unit);
 588
 589       update_tex_combine(ctx, texUnit);
 590    }
 591
 592
 593    /* Determine which texture coordinate sets are actually needed */
 594    if (fprog) {
 595       const GLuint coordMask = (1 << MAX_TEXTURE_COORD_UNITS) - 1;
 596       ctx->Texture._EnabledCoordUnits
 597          = (fprog->Base.InputsRead >> FRAG_ATTRIB_TEX0) & coordMask;
 598    }
 599    else {
 600       ctx->Texture._EnabledCoordUnits = enabledFragUnits;
 601    }
 602
 603    /* Setup texgen for those texture coordinate sets that are in use */
 604    for (unit = 0; unit < ctx->Const.MaxTextureCoordUnits; unit++) {
 605       struct gl_texture_unit *texUnit = &ctx->Texture.Unit[unit];
 606
 607       texUnit->_GenFlags = 0x0;
 608
 609       if (!(ctx->Texture._EnabledCoordUnits & (1 << unit)))
 610          continue;
 611
 612       if (texUnit->TexGenEnabled) {
 613          if (texUnit->TexGenEnabled & S_BIT) {
 614             texUnit->_GenFlags |= texUnit->GenS._ModeBit;
 615          }
 616          if (texUnit->TexGenEnabled & T_BIT) {
 617             texUnit->_GenFlags |= texUnit->GenT._ModeBit;
 618          }
 619          if (texUnit->TexGenEnabled & R_BIT) {
 620             texUnit->_GenFlags |= texUnit->GenR._ModeBit;
 621          }
 622          if (texUnit->TexGenEnabled & Q_BIT) {
 623             texUnit->_GenFlags |= texUnit->GenQ._ModeBit;
 624          }
 625
 626          ctx->Texture._TexGenEnabled |= ENABLE_TEXGEN(unit);
 627          ctx->Texture._GenFlags |= texUnit->_GenFlags;
 628       }
 629
 630       if (ctx->TextureMatrixStack[unit].Top->type != MATRIX_IDENTITY)
 631          ctx->Texture._TexMatEnabled |= ENABLE_TEXMAT(unit);
 632    }
 633 }
 634
 635
 636 /**
 637  * Update texture-related derived state.
 638  */
 639 void
 640 _mesa_update_texture( GLcontext *ctx, GLuint new_state )
 641 {
 642    if (new_state & _NEW_TEXTURE_MATRIX)
 643       update_texture_matrices( ctx );
 644
 645    if (new_state & (_NEW_TEXTURE | _NEW_PROGRAM))
 646       update_texture_state( ctx );
 647 }
 648
 649
 650 /**********************************************************************/
 651 /*****                      Initialization                        *****/
 652 /**********************************************************************/
 653
 654 /**
 655  * Allocate the proxy textures for the given context.
 656  *
 657  * \param ctx the context to allocate proxies for.
 658  *
 659  * \return GL_TRUE on success, or GL_FALSE on failure
 660  *
 661  * If run out of memory part way through the allocations, clean up and return
 662  * GL_FALSE.
 663  */
 664 static GLboolean
 665 alloc_proxy_textures( GLcontext *ctx )
 666 {
 667    static const GLenum targets[] = {
 668       GL_TEXTURE_1D,
 669       GL_TEXTURE_2D,
 670       GL_TEXTURE_3D,
 671       GL_TEXTURE_CUBE_MAP_ARB,
 672       GL_TEXTURE_RECTANGLE_NV,
 673       GL_TEXTURE_1D_ARRAY_EXT,
 674       GL_TEXTURE_2D_ARRAY_EXT
 675    };
 676    GLint tgt;
 677
 678    ASSERT(Elements(targets) == NUM_TEXTURE_TARGETS);
 679
 680    for (tgt = 0; tgt < NUM_TEXTURE_TARGETS; tgt++) {
 681       if (!(ctx->Texture.ProxyTex[tgt]
 682             = ctx->Driver.NewTextureObject(ctx, 0, targets[tgt]))) {
 683          /* out of memory, free what we did allocate */
 684          while (--tgt >= 0) {
 685             ctx->Driver.DeleteTexture(ctx, ctx->Texture.ProxyTex[tgt]);
 686          }
 687          return GL_FALSE;
 688       }
 689    }
 690
 691    assert(ctx->Texture.ProxyTex[0]->RefCount == 1); /* sanity check */
 692    return GL_TRUE;
 693 }
 694
 695
 696 /**
 697  * Initialize a texture unit.
 698  *
 699  * \param ctx GL context.
 700  * \param unit texture unit number to be initialized.
 701  */
 702 static void
 703 init_texture_unit( GLcontext *ctx, GLuint unit )
 704 {
 705    struct gl_texture_unit *texUnit = &ctx->Texture.Unit[unit];
 706    GLuint tex;
 707
 708    texUnit->EnvMode = GL_MODULATE;
 709    ASSIGN_4V( texUnit->EnvColor, 0.0, 0.0, 0.0, 0.0 );
 710
 711    texUnit->Combine = default_combine_state;
 712    texUnit->_EnvMode = default_combine_state;
 713    texUnit->_CurrentCombine = & texUnit->_EnvMode;
 714    texUnit->BumpTarget = GL_TEXTURE0;
 715
 716    texUnit->TexGenEnabled = 0x0;
 717    texUnit->GenS.Mode = GL_EYE_LINEAR;
 718    texUnit->GenT.Mode = GL_EYE_LINEAR;
 719    texUnit->GenR.Mode = GL_EYE_LINEAR;
 720    texUnit->GenQ.Mode = GL_EYE_LINEAR;
 721    texUnit->GenS._ModeBit = TEXGEN_EYE_LINEAR;
 722    texUnit->GenT._ModeBit = TEXGEN_EYE_LINEAR;
 723    texUnit->GenR._ModeBit = TEXGEN_EYE_LINEAR;
 724    texUnit->GenQ._ModeBit = TEXGEN_EYE_LINEAR;
 725
 726    /* Yes, these plane coefficients are correct! */
 727    ASSIGN_4V( texUnit->GenS.ObjectPlane, 1.0, 0.0, 0.0, 0.0 );
 728    ASSIGN_4V( texUnit->GenT.ObjectPlane, 0.0, 1.0, 0.0, 0.0 );
 729    ASSIGN_4V( texUnit->GenR.ObjectPlane, 0.0, 0.0, 0.0, 0.0 );
 730    ASSIGN_4V( texUnit->GenQ.ObjectPlane, 0.0, 0.0, 0.0, 0.0 );
 731    ASSIGN_4V( texUnit->GenS.EyePlane, 1.0, 0.0, 0.0, 0.0 );
 732    ASSIGN_4V( texUnit->GenT.EyePlane, 0.0, 1.0, 0.0, 0.0 );
 733    ASSIGN_4V( texUnit->GenR.EyePlane, 0.0, 0.0, 0.0, 0.0 );
 734    ASSIGN_4V( texUnit->GenQ.EyePlane, 0.0, 0.0, 0.0, 0.0 );
 735
 736    /* no mention of this in spec, but maybe id matrix expected? */
 737    ASSIGN_4V( texUnit->RotMatrix, 1.0, 0.0, 0.0, 1.0 );
 738
 739    /* initialize current texture object ptrs to the shared default objects */
 740    for (tex = 0; tex < NUM_TEXTURE_TARGETS; tex++) {
 741       _mesa_reference_texobj(&texUnit->CurrentTex[tex],
 742                              ctx->Shared->DefaultTex[tex]);
 743    }
 744 }
 745
 746
 747 /**
 748  * Initialize texture state for the given context.
 749  */
 750 GLboolean
 751 _mesa_init_texture(GLcontext *ctx)
 752 {
 753    GLuint u;
 754
 755    /* Texture group */
 756    ctx->Texture.CurrentUnit = 0;      /* multitexture */
 757    ctx->Texture._EnabledUnits = 0x0;
 758    ctx->Texture.SharedPalette = GL_FALSE;
 759    _mesa_init_colortable(&ctx->Texture.Palette);
 760
 761    for (u = 0; u < MAX_TEXTURE_UNITS; u++)
 762       init_texture_unit(ctx, u);
 763
 764    /* After we're done initializing the context's texture state the default
 765     * texture objects' refcounts should be at least MAX_TEXTURE_UNITS + 1.
 766     */
 767    assert(ctx->Shared->DefaultTex[TEXTURE_1D_INDEX]->RefCount
 768           >= MAX_TEXTURE_UNITS + 1);
 769
 770    /* Allocate proxy textures */
 771    if (!alloc_proxy_textures( ctx ))
 772       return GL_FALSE;
 773
 774    return GL_TRUE;
 775 }
 776
 777
 778 /**
 779  * Free dynamically-allocted texture data attached to the given context.
 780  */
 781 void
 782 _mesa_free_texture_data(GLcontext *ctx)
 783 {
 784    GLuint u, tgt;
 785
 786    /* unreference current textures */
 787    for (u = 0; u < MAX_TEXTURE_IMAGE_UNITS; u++) {
 788       /* The _Current texture could account for another reference */
 789       _mesa_reference_texobj(&ctx->Texture.Unit[u]._Current, NULL);
 790
 791       for (tgt = 0; tgt < NUM_TEXTURE_TARGETS; tgt++) {
 792          _mesa_reference_texobj(&ctx->Texture.Unit[u].CurrentTex[tgt], NULL);
 793       }
 794    }
 795
 796    /* Free proxy texture objects */
 797    for (tgt = 0; tgt < NUM_TEXTURE_TARGETS; tgt++)
 798       ctx->Driver.DeleteTexture(ctx, ctx->Texture.ProxyTex[tgt]);
 799
 800    for (u = 0; u < MAX_TEXTURE_IMAGE_UNITS; u++)
 801       _mesa_free_colortable_data(&ctx->Texture.Unit[u].ColorTable);
 802 }
 803
 804
 805 /**
 806  * Update the default texture objects in the given context to reference those
 807  * specified in the shared state and release those referencing the old
 808  * shared state.
 809  */
 810 void
 811 _mesa_update_default_objects_texture(GLcontext *ctx)
 812 {
 813    GLuint u, tex;
 814
 815    for (u = 0; u < MAX_TEXTURE_UNITS; u++) {
 816       struct gl_texture_unit *texUnit = &ctx->Texture.Unit[u];
 817       for (tex = 0; tex < NUM_TEXTURE_TARGETS; tex++) {
 818          _mesa_reference_texobj(&texUnit->CurrentTex[tex],
 819                                 ctx->Shared->DefaultTex[tex]);
 820       }
 821    }
 822 }