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