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