2 * Mesa 3-D graphics library
4 * Copyright (C) 1999-2007 Brian Paul All Rights Reserved.
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the "Software"),
8 * to deal in the Software without restriction, including without limitation
9 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
10 * and/or sell copies of the Software, and to permit persons to whom the
11 * Software is furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included
14 * in all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
17 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
20 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
21 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
22 * OTHER DEALINGS IN THE SOFTWARE.
28 * Texture state handling.
33 #include "bufferobj.h"
42 #include "util/bitscan.h"
43 #include "util/bitset.h"
47 * Default texture combine environment state. This is used to initialize
48 * a context's texture units and as the basis for converting "classic"
49 * texture environmnets to ARB_texture_env_combine style values.
51 static const struct gl_tex_env_combine_state default_combine_state
= {
52 GL_MODULATE
, GL_MODULATE
,
53 { GL_TEXTURE
, GL_PREVIOUS
, GL_CONSTANT
, GL_CONSTANT
},
54 { GL_TEXTURE
, GL_PREVIOUS
, GL_CONSTANT
, GL_CONSTANT
},
55 { GL_SRC_COLOR
, GL_SRC_COLOR
, GL_SRC_ALPHA
, GL_SRC_ALPHA
},
56 { GL_SRC_ALPHA
, GL_SRC_ALPHA
, GL_SRC_ALPHA
, GL_SRC_ALPHA
},
64 * Used by glXCopyContext to copy texture state from one context to another.
67 _mesa_copy_texture_state( const struct gl_context
*src
, struct gl_context
*dst
)
74 dst
->Texture
.CurrentUnit
= src
->Texture
.CurrentUnit
;
75 dst
->Texture
._GenFlags
= src
->Texture
._GenFlags
;
76 dst
->Texture
._TexGenEnabled
= src
->Texture
._TexGenEnabled
;
77 dst
->Texture
._TexMatEnabled
= src
->Texture
._TexMatEnabled
;
80 for (u
= 0; u
< src
->Const
.MaxCombinedTextureImageUnits
; 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
;
91 /* GL_EXT_texture_env_combine */
92 dst
->Texture
.Unit
[u
].Combine
= src
->Texture
.Unit
[u
].Combine
;
95 * XXX strictly speaking, we should compare texture names/ids and
96 * bind textures in the dest context according to id. For now, only
97 * copy bindings if the contexts share the same pool of textures to
98 * avoid refcounting bugs.
100 if (dst
->Shared
== src
->Shared
) {
101 /* copy texture object bindings, not contents of texture objects */
102 _mesa_lock_context_textures(dst
);
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 if (src
->Texture
.Unit
[u
].CurrentTex
[tex
]) {
108 dst
->Texture
.NumCurrentTexUsed
=
109 MAX2(dst
->Texture
.NumCurrentTexUsed
, u
+ 1);
112 dst
->Texture
.Unit
[u
]._BoundTextures
= src
->Texture
.Unit
[u
]._BoundTextures
;
113 _mesa_unlock_context_textures(dst
);
123 _mesa_print_texunit_state( struct gl_context
*ctx
, GLuint unit
)
125 const struct gl_texture_unit
*texUnit
= ctx
->Texture
.Unit
+ unit
;
126 printf("Texture Unit %d\n", unit
);
127 printf(" GL_TEXTURE_ENV_MODE = %s\n", _mesa_enum_to_string(texUnit
->EnvMode
));
128 printf(" GL_COMBINE_RGB = %s\n", _mesa_enum_to_string(texUnit
->Combine
.ModeRGB
));
129 printf(" GL_COMBINE_ALPHA = %s\n", _mesa_enum_to_string(texUnit
->Combine
.ModeA
));
130 printf(" GL_SOURCE0_RGB = %s\n", _mesa_enum_to_string(texUnit
->Combine
.SourceRGB
[0]));
131 printf(" GL_SOURCE1_RGB = %s\n", _mesa_enum_to_string(texUnit
->Combine
.SourceRGB
[1]));
132 printf(" GL_SOURCE2_RGB = %s\n", _mesa_enum_to_string(texUnit
->Combine
.SourceRGB
[2]));
133 printf(" GL_SOURCE0_ALPHA = %s\n", _mesa_enum_to_string(texUnit
->Combine
.SourceA
[0]));
134 printf(" GL_SOURCE1_ALPHA = %s\n", _mesa_enum_to_string(texUnit
->Combine
.SourceA
[1]));
135 printf(" GL_SOURCE2_ALPHA = %s\n", _mesa_enum_to_string(texUnit
->Combine
.SourceA
[2]));
136 printf(" GL_OPERAND0_RGB = %s\n", _mesa_enum_to_string(texUnit
->Combine
.OperandRGB
[0]));
137 printf(" GL_OPERAND1_RGB = %s\n", _mesa_enum_to_string(texUnit
->Combine
.OperandRGB
[1]));
138 printf(" GL_OPERAND2_RGB = %s\n", _mesa_enum_to_string(texUnit
->Combine
.OperandRGB
[2]));
139 printf(" GL_OPERAND0_ALPHA = %s\n", _mesa_enum_to_string(texUnit
->Combine
.OperandA
[0]));
140 printf(" GL_OPERAND1_ALPHA = %s\n", _mesa_enum_to_string(texUnit
->Combine
.OperandA
[1]));
141 printf(" GL_OPERAND2_ALPHA = %s\n", _mesa_enum_to_string(texUnit
->Combine
.OperandA
[2]));
142 printf(" GL_RGB_SCALE = %d\n", 1 << texUnit
->Combine
.ScaleShiftRGB
);
143 printf(" GL_ALPHA_SCALE = %d\n", 1 << texUnit
->Combine
.ScaleShiftA
);
144 printf(" GL_TEXTURE_ENV_COLOR = (%f, %f, %f, %f)\n", texUnit
->EnvColor
[0], texUnit
->EnvColor
[1], texUnit
->EnvColor
[2], texUnit
->EnvColor
[3]);
149 /**********************************************************************/
150 /* Texture Environment */
151 /**********************************************************************/
154 * Convert "classic" texture environment to ARB_texture_env_combine style
157 * \param state texture_env_combine state vector to be filled-in.
158 * \param mode Classic texture environment mode (i.e., \c GL_REPLACE,
159 * \c GL_BLEND, \c GL_DECAL, etc.).
160 * \param texBaseFormat Base format of the texture associated with the
164 calculate_derived_texenv( struct gl_tex_env_combine_state
*state
,
165 GLenum mode
, GLenum texBaseFormat
)
170 *state
= default_combine_state
;
172 switch (texBaseFormat
) {
174 state
->SourceRGB
[0] = GL_PREVIOUS
;
177 case GL_LUMINANCE_ALPHA
:
187 state
->SourceA
[0] = GL_PREVIOUS
;
192 "Invalid texBaseFormat 0x%x in calculate_derived_texenv",
197 if (mode
== GL_REPLACE_EXT
)
203 mode_rgb
= (texBaseFormat
== GL_ALPHA
) ? GL_REPLACE
: mode
;
208 mode_rgb
= GL_INTERPOLATE
;
211 state
->SourceA
[0] = GL_PREVIOUS
;
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".
217 switch (texBaseFormat
) {
220 case GL_LUMINANCE_ALPHA
:
222 state
->SourceRGB
[0] = GL_PREVIOUS
;
228 mode_rgb
= GL_REPLACE
;
231 state
->SourceRGB
[2] = GL_TEXTURE
;
237 mode_rgb
= GL_INTERPOLATE
;
238 mode_a
= GL_MODULATE
;
240 switch (texBaseFormat
) {
242 mode_rgb
= GL_REPLACE
;
245 mode_a
= GL_INTERPOLATE
;
246 state
->SourceA
[0] = GL_CONSTANT
;
247 state
->OperandA
[2] = GL_SRC_ALPHA
;
253 case GL_LUMINANCE_ALPHA
:
256 state
->SourceRGB
[2] = GL_TEXTURE
;
257 state
->SourceA
[2] = GL_TEXTURE
;
258 state
->SourceRGB
[0] = GL_CONSTANT
;
259 state
->OperandRGB
[2] = GL_SRC_COLOR
;
265 mode_rgb
= (texBaseFormat
== GL_ALPHA
) ? GL_REPLACE
: GL_ADD
;
266 mode_a
= (texBaseFormat
== GL_INTENSITY
) ? GL_ADD
: GL_MODULATE
;
271 "Invalid texture env mode 0x%x in calculate_derived_texenv",
276 state
->ModeRGB
= (state
->SourceRGB
[0] != GL_PREVIOUS
)
277 ? mode_rgb
: GL_REPLACE
;
278 state
->ModeA
= (state
->SourceA
[0] != GL_PREVIOUS
)
279 ? mode_a
: GL_REPLACE
;
283 /* GL_ARB_multitexture */
284 static ALWAYS_INLINE
void
285 active_texture(GLenum texture
, bool no_error
)
287 const GLuint texUnit
= texture
- GL_TEXTURE0
;
289 GET_CURRENT_CONTEXT(ctx
);
291 if (MESA_VERBOSE
& (VERBOSE_API
|VERBOSE_TEXTURE
))
292 _mesa_debug(ctx
, "glActiveTexture %s\n",
293 _mesa_enum_to_string(texture
));
295 if (ctx
->Texture
.CurrentUnit
== texUnit
)
299 GLuint k
= _mesa_max_tex_unit(ctx
);
301 assert(k
<= ARRAY_SIZE(ctx
->Texture
.Unit
));
304 _mesa_error(ctx
, GL_INVALID_ENUM
, "glActiveTexture(texture=%s)",
305 _mesa_enum_to_string(texture
));
310 ctx
->Texture
.CurrentUnit
= texUnit
;
311 if (ctx
->Transform
.MatrixMode
== GL_TEXTURE
) {
312 /* update current stack pointer */
313 ctx
->CurrentStack
= &ctx
->TextureMatrixStack
[texUnit
];
319 _mesa_ActiveTexture_no_error(GLenum texture
)
321 active_texture(texture
, true);
326 _mesa_ActiveTexture(GLenum texture
)
328 active_texture(texture
, false);
332 /* GL_ARB_multitexture */
334 _mesa_ClientActiveTexture(GLenum texture
)
336 GET_CURRENT_CONTEXT(ctx
);
337 GLuint texUnit
= texture
- GL_TEXTURE0
;
339 if (MESA_VERBOSE
& (VERBOSE_API
| VERBOSE_TEXTURE
))
340 _mesa_debug(ctx
, "glClientActiveTexture %s\n",
341 _mesa_enum_to_string(texture
));
343 if (ctx
->Array
.ActiveTexture
== texUnit
)
346 if (texUnit
>= ctx
->Const
.MaxTextureCoordUnits
) {
347 _mesa_error(ctx
, GL_INVALID_ENUM
, "glClientActiveTexture(texture=%s)",
348 _mesa_enum_to_string(texture
));
352 /* Don't flush vertices. This is a "latched" state. */
353 ctx
->Array
.ActiveTexture
= texUnit
;
358 /**********************************************************************/
359 /***** State management *****/
360 /**********************************************************************/
364 * \note This routine refers to derived texture attribute values to
365 * compute the ENABLE_TEXMAT flags, but is only called on
366 * _NEW_TEXTURE_MATRIX. On changes to _NEW_TEXTURE_OBJECT/STATE,
367 * the ENABLE_TEXMAT flags are updated by _mesa_update_textures(), below.
369 * \param ctx GL context.
372 _mesa_update_texture_matrices(struct gl_context
*ctx
)
376 ctx
->Texture
._TexMatEnabled
= 0x0;
378 for (u
= 0; u
< ctx
->Const
.MaxTextureCoordUnits
; u
++) {
379 assert(u
< ARRAY_SIZE(ctx
->TextureMatrixStack
));
380 if (_math_matrix_is_dirty(ctx
->TextureMatrixStack
[u
].Top
)) {
381 _math_matrix_analyse( ctx
->TextureMatrixStack
[u
].Top
);
383 if (ctx
->Texture
.Unit
[u
]._Current
&&
384 ctx
->TextureMatrixStack
[u
].Top
->type
!= MATRIX_IDENTITY
)
385 ctx
->Texture
._TexMatEnabled
|= ENABLE_TEXMAT(u
);
392 * Translate GL combiner state into a MODE_x value
395 tex_combine_translate_mode(GLenum envMode
, GLenum mode
)
398 case GL_REPLACE
: return TEXENV_MODE_REPLACE
;
399 case GL_MODULATE
: return TEXENV_MODE_MODULATE
;
401 if (envMode
== GL_COMBINE4_NV
)
402 return TEXENV_MODE_ADD_PRODUCTS_NV
;
404 return TEXENV_MODE_ADD
;
406 if (envMode
== GL_COMBINE4_NV
)
407 return TEXENV_MODE_ADD_PRODUCTS_SIGNED_NV
;
409 return TEXENV_MODE_ADD_SIGNED
;
410 case GL_INTERPOLATE
: return TEXENV_MODE_INTERPOLATE
;
411 case GL_SUBTRACT
: return TEXENV_MODE_SUBTRACT
;
412 case GL_DOT3_RGB
: return TEXENV_MODE_DOT3_RGB
;
413 case GL_DOT3_RGB_EXT
: return TEXENV_MODE_DOT3_RGB_EXT
;
414 case GL_DOT3_RGBA
: return TEXENV_MODE_DOT3_RGBA
;
415 case GL_DOT3_RGBA_EXT
: return TEXENV_MODE_DOT3_RGBA_EXT
;
416 case GL_MODULATE_ADD_ATI
: return TEXENV_MODE_MODULATE_ADD_ATI
;
417 case GL_MODULATE_SIGNED_ADD_ATI
: return TEXENV_MODE_MODULATE_SIGNED_ADD_ATI
;
418 case GL_MODULATE_SUBTRACT_ATI
: return TEXENV_MODE_MODULATE_SUBTRACT_ATI
;
420 unreachable("Invalid TexEnv Combine mode");
426 tex_combine_translate_source(GLenum src
)
436 case GL_TEXTURE7
: return TEXENV_SRC_TEXTURE0
+ (src
- GL_TEXTURE0
);
437 case GL_TEXTURE
: return TEXENV_SRC_TEXTURE
;
438 case GL_PREVIOUS
: return TEXENV_SRC_PREVIOUS
;
439 case GL_PRIMARY_COLOR
: return TEXENV_SRC_PRIMARY_COLOR
;
440 case GL_CONSTANT
: return TEXENV_SRC_CONSTANT
;
441 case GL_ZERO
: return TEXENV_SRC_ZERO
;
442 case GL_ONE
: return TEXENV_SRC_ONE
;
444 unreachable("Invalid TexEnv Combine argument source");
450 tex_combine_translate_operand(GLenum operand
)
453 case GL_SRC_COLOR
: return TEXENV_OPR_COLOR
;
454 case GL_ONE_MINUS_SRC_COLOR
: return TEXENV_OPR_ONE_MINUS_COLOR
;
455 case GL_SRC_ALPHA
: return TEXENV_OPR_ALPHA
;
456 case GL_ONE_MINUS_SRC_ALPHA
: return TEXENV_OPR_ONE_MINUS_ALPHA
;
458 unreachable("Invalid TexEnv Combine argument source");
464 pack_tex_combine(struct gl_texture_unit
*texUnit
)
466 struct gl_tex_env_combine_state
*state
= texUnit
->_CurrentCombine
;
467 struct gl_tex_env_combine_packed
*packed
= &texUnit
->_CurrentCombinePacked
;
469 memset(packed
, 0, sizeof *packed
);
471 packed
->ModeRGB
= tex_combine_translate_mode(texUnit
->EnvMode
, state
->ModeRGB
);
472 packed
->ModeA
= tex_combine_translate_mode(texUnit
->EnvMode
, state
->ModeA
);
473 packed
->ScaleShiftRGB
= state
->ScaleShiftRGB
;
474 packed
->ScaleShiftA
= state
->ScaleShiftA
;
475 packed
->NumArgsRGB
= state
->_NumArgsRGB
;
476 packed
->NumArgsA
= state
->_NumArgsA
;
478 for (int i
= 0; i
< state
->_NumArgsRGB
; ++i
)
480 packed
->ArgsRGB
[i
].Source
= tex_combine_translate_source(state
->SourceRGB
[i
]);
481 packed
->ArgsRGB
[i
].Operand
= tex_combine_translate_operand(state
->OperandRGB
[i
]);
484 for (int i
= 0; i
< state
->_NumArgsA
; ++i
)
486 packed
->ArgsA
[i
].Source
= tex_combine_translate_source(state
->SourceA
[i
]);
487 packed
->ArgsA
[i
].Operand
= tex_combine_translate_operand(state
->OperandA
[i
]);
493 * Examine texture unit's combine/env state to update derived state.
496 update_tex_combine(struct gl_context
*ctx
, struct gl_texture_unit
*texUnit
)
498 struct gl_tex_env_combine_state
*combine
;
500 /* No combiners will apply to this. */
501 if (texUnit
->_Current
->Target
== GL_TEXTURE_BUFFER
)
504 /* Set the texUnit->_CurrentCombine field to point to the user's combiner
505 * state, or the combiner state which is derived from traditional texenv
508 if (texUnit
->EnvMode
== GL_COMBINE
||
509 texUnit
->EnvMode
== GL_COMBINE4_NV
) {
510 texUnit
->_CurrentCombine
= & texUnit
->Combine
;
513 const struct gl_texture_object
*texObj
= texUnit
->_Current
;
514 GLenum format
= texObj
->Image
[0][texObj
->BaseLevel
]->_BaseFormat
;
516 if (format
== GL_DEPTH_COMPONENT
|| format
== GL_DEPTH_STENCIL_EXT
) {
517 format
= texObj
->DepthMode
;
519 calculate_derived_texenv(&texUnit
->_EnvMode
, texUnit
->EnvMode
, format
);
520 texUnit
->_CurrentCombine
= & texUnit
->_EnvMode
;
523 combine
= texUnit
->_CurrentCombine
;
525 /* Determine number of source RGB terms in the combiner function */
526 switch (combine
->ModeRGB
) {
528 combine
->_NumArgsRGB
= 1;
532 if (texUnit
->EnvMode
== GL_COMBINE4_NV
)
533 combine
->_NumArgsRGB
= 4;
535 combine
->_NumArgsRGB
= 2;
541 case GL_DOT3_RGB_EXT
:
542 case GL_DOT3_RGBA_EXT
:
543 combine
->_NumArgsRGB
= 2;
546 case GL_MODULATE_ADD_ATI
:
547 case GL_MODULATE_SIGNED_ADD_ATI
:
548 case GL_MODULATE_SUBTRACT_ATI
:
549 combine
->_NumArgsRGB
= 3;
552 combine
->_NumArgsRGB
= 0;
553 _mesa_problem(ctx
, "invalid RGB combine mode in update_texture_state");
557 /* Determine number of source Alpha terms in the combiner function */
558 switch (combine
->ModeA
) {
560 combine
->_NumArgsA
= 1;
564 if (texUnit
->EnvMode
== GL_COMBINE4_NV
)
565 combine
->_NumArgsA
= 4;
567 combine
->_NumArgsA
= 2;
571 combine
->_NumArgsA
= 2;
574 case GL_MODULATE_ADD_ATI
:
575 case GL_MODULATE_SIGNED_ADD_ATI
:
576 case GL_MODULATE_SUBTRACT_ATI
:
577 combine
->_NumArgsA
= 3;
580 combine
->_NumArgsA
= 0;
581 _mesa_problem(ctx
, "invalid Alpha combine mode in update_texture_state");
585 pack_tex_combine(texUnit
);
589 update_texgen(struct gl_context
*ctx
)
593 /* Setup texgen for those texture coordinate sets that are in use */
594 for (unit
= 0; unit
< ctx
->Const
.MaxTextureCoordUnits
; unit
++) {
595 struct gl_texture_unit
*texUnit
= &ctx
->Texture
.Unit
[unit
];
597 texUnit
->_GenFlags
= 0x0;
599 if (!(ctx
->Texture
._EnabledCoordUnits
& (1 << unit
)))
602 if (texUnit
->TexGenEnabled
) {
603 if (texUnit
->TexGenEnabled
& S_BIT
) {
604 texUnit
->_GenFlags
|= texUnit
->GenS
._ModeBit
;
606 if (texUnit
->TexGenEnabled
& T_BIT
) {
607 texUnit
->_GenFlags
|= texUnit
->GenT
._ModeBit
;
609 if (texUnit
->TexGenEnabled
& R_BIT
) {
610 texUnit
->_GenFlags
|= texUnit
->GenR
._ModeBit
;
612 if (texUnit
->TexGenEnabled
& Q_BIT
) {
613 texUnit
->_GenFlags
|= texUnit
->GenQ
._ModeBit
;
616 ctx
->Texture
._TexGenEnabled
|= ENABLE_TEXGEN(unit
);
617 ctx
->Texture
._GenFlags
|= texUnit
->_GenFlags
;
620 assert(unit
< ARRAY_SIZE(ctx
->TextureMatrixStack
));
621 if (ctx
->TextureMatrixStack
[unit
].Top
->type
!= MATRIX_IDENTITY
)
622 ctx
->Texture
._TexMatEnabled
|= ENABLE_TEXMAT(unit
);
626 static struct gl_texture_object
*
627 update_single_program_texture(struct gl_context
*ctx
, struct gl_program
*prog
,
630 gl_texture_index target_index
;
631 struct gl_texture_unit
*texUnit
;
632 struct gl_texture_object
*texObj
;
633 struct gl_sampler_object
*sampler
;
635 texUnit
= &ctx
->Texture
.Unit
[unit
];
637 /* Note: If more than one bit was set in TexturesUsed[unit], then we should
638 * have had the draw call rejected already. From the GL 4.4 specification,
639 * section 7.10 ("Samplers"):
641 * "It is not allowed to have variables of different sampler types
642 * pointing to the same texture image unit within a program
643 * object. This situation can only be detected at the next rendering
644 * command issued which triggers shader invocations, and an
645 * INVALID_OPERATION error will then be generated."
647 target_index
= ffs(prog
->TexturesUsed
[unit
]) - 1;
648 texObj
= texUnit
->CurrentTex
[target_index
];
650 sampler
= texUnit
->Sampler
?
651 texUnit
->Sampler
: &texObj
->Sampler
;
653 if (likely(texObj
)) {
654 if (_mesa_is_texture_complete(texObj
, sampler
))
657 _mesa_test_texobj_completeness(ctx
, texObj
);
658 if (_mesa_is_texture_complete(texObj
, sampler
))
662 /* If we've reached this point, we didn't find a complete texture of the
663 * shader's target. From the GL 4.4 core specification, section 11.1.3.5
664 * ("Texture Access"):
666 * "If a sampler is used in a shader and the sampler’s associated
667 * texture is not complete, as defined in section 8.17, (0, 0, 0, 1)
668 * will be returned for a non-shadow sampler and 0 for a shadow
671 * Mesa implements this by creating a hidden texture object with a pixel of
674 texObj
= _mesa_get_fallback_texture(ctx
, target_index
);
681 update_single_program_texture_state(struct gl_context
*ctx
,
682 struct gl_program
*prog
,
684 BITSET_WORD
*enabled_texture_units
)
686 struct gl_texture_object
*texObj
;
688 texObj
= update_single_program_texture(ctx
, prog
, unit
);
692 _mesa_reference_texobj(&ctx
->Texture
.Unit
[unit
]._Current
, texObj
);
693 BITSET_SET(enabled_texture_units
, unit
);
694 ctx
->Texture
._MaxEnabledTexImageUnit
=
695 MAX2(ctx
->Texture
._MaxEnabledTexImageUnit
, (int)unit
);
699 update_program_texture_state(struct gl_context
*ctx
, struct gl_program
**prog
,
700 BITSET_WORD
*enabled_texture_units
)
704 for (i
= 0; i
< MESA_SHADER_STAGES
; i
++) {
711 mask
= prog
[i
]->SamplersUsed
;
714 s
= u_bit_scan(&mask
);
716 update_single_program_texture_state(ctx
, prog
[i
],
717 prog
[i
]->SamplerUnits
[s
],
718 enabled_texture_units
);
721 if (unlikely(prog
[i
]->sh
.HasBoundBindlessSampler
)) {
722 /* Loop over bindless samplers bound to texture units.
724 for (s
= 0; s
< prog
[i
]->sh
.NumBindlessSamplers
; s
++) {
725 struct gl_bindless_sampler
*sampler
=
726 &prog
[i
]->sh
.BindlessSamplers
[s
];
731 update_single_program_texture_state(ctx
, prog
[i
], sampler
->unit
,
732 enabled_texture_units
);
737 if (prog
[MESA_SHADER_FRAGMENT
]) {
738 const GLuint coordMask
= (1 << MAX_TEXTURE_COORD_UNITS
) - 1;
739 ctx
->Texture
._EnabledCoordUnits
|=
740 (prog
[MESA_SHADER_FRAGMENT
]->info
.inputs_read
>> VARYING_SLOT_TEX0
) &
746 update_ff_texture_state(struct gl_context
*ctx
,
747 BITSET_WORD
*enabled_texture_units
)
751 for (unit
= 0; unit
< ctx
->Const
.MaxTextureUnits
; unit
++) {
752 struct gl_texture_unit
*texUnit
= &ctx
->Texture
.Unit
[unit
];
756 if (texUnit
->Enabled
== 0x0)
759 /* If a shader already dictated what texture target was used for this
760 * unit, just go along with it.
762 if (BITSET_TEST(enabled_texture_units
, unit
))
765 /* From the GL 4.4 compat specification, section 16.2 ("Texture Application"):
767 * "Texturing is enabled or disabled using the generic Enable and
768 * Disable commands, respectively, with the symbolic constants
769 * TEXTURE_1D, TEXTURE_2D, TEXTURE_RECTANGLE, TEXTURE_3D, or
770 * TEXTURE_CUBE_MAP to enable the one-, two-, rectangular,
771 * three-dimensional, or cube map texture, respectively. If more
772 * than one of these textures is enabled, the first one enabled
773 * from the following list is used:
775 * • cube map texture
776 * • three-dimensional texture
777 * • rectangular texture
778 * • two-dimensional texture
779 * • one-dimensional texture"
781 * Note that the TEXTURE_x_INDEX values are in high to low priority.
784 * "If a texture unit is disabled or has an invalid or incomplete
785 * texture (as defined in section 8.17) bound to it, then blending
786 * is disabled for that texture unit. If the texture environment
787 * for a given enabled texture unit references a disabled texture
788 * unit, or an invalid or incomplete texture that is bound to
789 * another unit, then the results of texture blending are
793 mask
= texUnit
->Enabled
;
795 const int texIndex
= u_bit_scan(&mask
);
796 struct gl_texture_object
*texObj
= texUnit
->CurrentTex
[texIndex
];
797 struct gl_sampler_object
*sampler
= texUnit
->Sampler
?
798 texUnit
->Sampler
: &texObj
->Sampler
;
800 if (!_mesa_is_texture_complete(texObj
, sampler
)) {
801 _mesa_test_texobj_completeness(ctx
, texObj
);
803 if (_mesa_is_texture_complete(texObj
, sampler
)) {
804 _mesa_reference_texobj(&texUnit
->_Current
, texObj
);
813 /* if we get here, we know this texture unit is enabled */
814 BITSET_SET(enabled_texture_units
, unit
);
815 ctx
->Texture
._MaxEnabledTexImageUnit
=
816 MAX2(ctx
->Texture
._MaxEnabledTexImageUnit
, (int)unit
);
818 ctx
->Texture
._EnabledCoordUnits
|= 1 << unit
;
820 update_tex_combine(ctx
, texUnit
);
825 * \note This routine refers to derived texture matrix values to
826 * compute the ENABLE_TEXMAT flags, but is only called on
827 * _NEW_TEXTURE_OBJECT/STATE. On changes to _NEW_TEXTURE_MATRIX,
828 * the ENABLE_TEXMAT flags are updated by _mesa_update_texture_matrices,
831 * \param ctx GL context.
834 _mesa_update_texture_state(struct gl_context
*ctx
)
836 struct gl_program
*prog
[MESA_SHADER_STAGES
];
838 int old_max_unit
= ctx
->Texture
._MaxEnabledTexImageUnit
;
839 BITSET_DECLARE(enabled_texture_units
, MAX_COMBINED_TEXTURE_IMAGE_UNITS
);
841 memcpy(prog
, ctx
->_Shader
->CurrentProgram
, sizeof(prog
));
843 if (prog
[MESA_SHADER_FRAGMENT
] == NULL
&&
844 _mesa_arb_fragment_program_enabled(ctx
)) {
845 prog
[MESA_SHADER_FRAGMENT
] = ctx
->FragmentProgram
.Current
;
848 /* TODO: only set this if there are actual changes */
849 ctx
->NewState
|= _NEW_TEXTURE_OBJECT
| _NEW_TEXTURE_STATE
;
851 ctx
->Texture
._GenFlags
= 0x0;
852 ctx
->Texture
._TexMatEnabled
= 0x0;
853 ctx
->Texture
._TexGenEnabled
= 0x0;
854 ctx
->Texture
._MaxEnabledTexImageUnit
= -1;
855 ctx
->Texture
._EnabledCoordUnits
= 0x0;
857 memset(&enabled_texture_units
, 0, sizeof(enabled_texture_units
));
859 /* First, walk over our programs pulling in all the textures for them.
860 * Programs dictate specific texture targets to be enabled, and for a draw
861 * call to be valid they can't conflict about which texture targets are
864 update_program_texture_state(ctx
, prog
, enabled_texture_units
);
866 /* Also pull in any textures necessary for fixed function fragment shading.
868 if (!prog
[MESA_SHADER_FRAGMENT
])
869 update_ff_texture_state(ctx
, enabled_texture_units
);
871 /* Now, clear out the _Current of any disabled texture units. */
872 for (i
= 0; i
<= ctx
->Texture
._MaxEnabledTexImageUnit
; i
++) {
873 if (!BITSET_TEST(enabled_texture_units
, i
))
874 _mesa_reference_texobj(&ctx
->Texture
.Unit
[i
]._Current
, NULL
);
876 for (i
= ctx
->Texture
._MaxEnabledTexImageUnit
+ 1; i
<= old_max_unit
; i
++) {
877 _mesa_reference_texobj(&ctx
->Texture
.Unit
[i
]._Current
, NULL
);
880 if (!prog
[MESA_SHADER_FRAGMENT
] || !prog
[MESA_SHADER_VERTEX
])
885 /**********************************************************************/
886 /***** Initialization *****/
887 /**********************************************************************/
890 * Allocate the proxy textures for the given context.
892 * \param ctx the context to allocate proxies for.
894 * \return GL_TRUE on success, or GL_FALSE on failure
896 * If run out of memory part way through the allocations, clean up and return
900 alloc_proxy_textures( struct gl_context
*ctx
)
902 /* NOTE: these values must be in the same order as the TEXTURE_x_INDEX
905 static const GLenum targets
[] = {
906 GL_TEXTURE_2D_MULTISAMPLE
,
907 GL_TEXTURE_2D_MULTISAMPLE_ARRAY
,
908 GL_TEXTURE_CUBE_MAP_ARRAY
,
910 GL_TEXTURE_2D_ARRAY_EXT
,
911 GL_TEXTURE_1D_ARRAY_EXT
,
912 GL_TEXTURE_EXTERNAL_OES
,
915 GL_TEXTURE_RECTANGLE_NV
,
921 STATIC_ASSERT(ARRAY_SIZE(targets
) == NUM_TEXTURE_TARGETS
);
922 assert(targets
[TEXTURE_2D_INDEX
] == GL_TEXTURE_2D
);
923 assert(targets
[TEXTURE_CUBE_INDEX
] == GL_TEXTURE_CUBE_MAP
);
925 for (tgt
= 0; tgt
< NUM_TEXTURE_TARGETS
; tgt
++) {
926 if (!(ctx
->Texture
.ProxyTex
[tgt
]
927 = ctx
->Driver
.NewTextureObject(ctx
, 0, targets
[tgt
]))) {
928 /* out of memory, free what we did allocate */
930 ctx
->Driver
.DeleteTexture(ctx
, ctx
->Texture
.ProxyTex
[tgt
]);
936 assert(ctx
->Texture
.ProxyTex
[0]->RefCount
== 1); /* sanity check */
942 * Initialize a texture unit.
944 * \param ctx GL context.
945 * \param unit texture unit number to be initialized.
948 init_texture_unit( struct gl_context
*ctx
, GLuint unit
)
950 struct gl_texture_unit
*texUnit
= &ctx
->Texture
.Unit
[unit
];
953 texUnit
->EnvMode
= GL_MODULATE
;
954 ASSIGN_4V( texUnit
->EnvColor
, 0.0, 0.0, 0.0, 0.0 );
956 texUnit
->Combine
= default_combine_state
;
957 texUnit
->_EnvMode
= default_combine_state
;
958 texUnit
->_CurrentCombine
= & texUnit
->_EnvMode
;
960 texUnit
->TexGenEnabled
= 0x0;
961 texUnit
->GenS
.Mode
= GL_EYE_LINEAR
;
962 texUnit
->GenT
.Mode
= GL_EYE_LINEAR
;
963 texUnit
->GenR
.Mode
= GL_EYE_LINEAR
;
964 texUnit
->GenQ
.Mode
= GL_EYE_LINEAR
;
965 texUnit
->GenS
._ModeBit
= TEXGEN_EYE_LINEAR
;
966 texUnit
->GenT
._ModeBit
= TEXGEN_EYE_LINEAR
;
967 texUnit
->GenR
._ModeBit
= TEXGEN_EYE_LINEAR
;
968 texUnit
->GenQ
._ModeBit
= TEXGEN_EYE_LINEAR
;
970 /* Yes, these plane coefficients are correct! */
971 ASSIGN_4V( texUnit
->GenS
.ObjectPlane
, 1.0, 0.0, 0.0, 0.0 );
972 ASSIGN_4V( texUnit
->GenT
.ObjectPlane
, 0.0, 1.0, 0.0, 0.0 );
973 ASSIGN_4V( texUnit
->GenR
.ObjectPlane
, 0.0, 0.0, 0.0, 0.0 );
974 ASSIGN_4V( texUnit
->GenQ
.ObjectPlane
, 0.0, 0.0, 0.0, 0.0 );
975 ASSIGN_4V( texUnit
->GenS
.EyePlane
, 1.0, 0.0, 0.0, 0.0 );
976 ASSIGN_4V( texUnit
->GenT
.EyePlane
, 0.0, 1.0, 0.0, 0.0 );
977 ASSIGN_4V( texUnit
->GenR
.EyePlane
, 0.0, 0.0, 0.0, 0.0 );
978 ASSIGN_4V( texUnit
->GenQ
.EyePlane
, 0.0, 0.0, 0.0, 0.0 );
980 /* initialize current texture object ptrs to the shared default objects */
981 for (tex
= 0; tex
< NUM_TEXTURE_TARGETS
; tex
++) {
982 _mesa_reference_texobj(&texUnit
->CurrentTex
[tex
],
983 ctx
->Shared
->DefaultTex
[tex
]);
986 texUnit
->_BoundTextures
= 0;
991 * Initialize texture state for the given context.
994 _mesa_init_texture(struct gl_context
*ctx
)
999 ctx
->Texture
.CurrentUnit
= 0; /* multitexture */
1001 /* Appendix F.2 of the OpenGL ES 3.0 spec says:
1003 * "OpenGL ES 3.0 requires that all cube map filtering be
1004 * seamless. OpenGL ES 2.0 specified that a single cube map face be
1005 * selected and used for filtering."
1007 * Unfortunatley, a call to _mesa_is_gles3 below will only work if
1008 * the driver has already computed and set ctx->Version, however drivers
1009 * seem to call _mesa_initialize_context (which calls this) early
1010 * in the CreateContext hook and _mesa_compute_version much later (since
1011 * it needs information about available extensions). So, we will
1012 * enable seamless cubemaps by default since GLES2. This should work
1013 * for most implementations and drivers that don't support seamless
1014 * cubemaps for GLES2 can still disable it.
1016 ctx
->Texture
.CubeMapSeamless
= ctx
->API
== API_OPENGLES2
;
1018 for (u
= 0; u
< ARRAY_SIZE(ctx
->Texture
.Unit
); u
++)
1019 init_texture_unit(ctx
, u
);
1021 /* After we're done initializing the context's texture state the default
1022 * texture objects' refcounts should be at least
1023 * MAX_COMBINED_TEXTURE_IMAGE_UNITS + 1.
1025 assert(ctx
->Shared
->DefaultTex
[TEXTURE_1D_INDEX
]->RefCount
1026 >= MAX_COMBINED_TEXTURE_IMAGE_UNITS
+ 1);
1028 /* Allocate proxy textures */
1029 if (!alloc_proxy_textures( ctx
))
1032 /* GL_ARB_texture_buffer_object */
1033 _mesa_reference_buffer_object(ctx
, &ctx
->Texture
.BufferObject
,
1034 ctx
->Shared
->NullBufferObj
);
1036 ctx
->Texture
.NumCurrentTexUsed
= 0;
1043 * Free dynamically-allocted texture data attached to the given context.
1046 _mesa_free_texture_data(struct gl_context
*ctx
)
1050 /* unreference current textures */
1051 for (u
= 0; u
< ARRAY_SIZE(ctx
->Texture
.Unit
); u
++) {
1052 /* The _Current texture could account for another reference */
1053 _mesa_reference_texobj(&ctx
->Texture
.Unit
[u
]._Current
, NULL
);
1055 for (tgt
= 0; tgt
< NUM_TEXTURE_TARGETS
; tgt
++) {
1056 _mesa_reference_texobj(&ctx
->Texture
.Unit
[u
].CurrentTex
[tgt
], NULL
);
1060 /* Free proxy texture objects */
1061 for (tgt
= 0; tgt
< NUM_TEXTURE_TARGETS
; tgt
++)
1062 ctx
->Driver
.DeleteTexture(ctx
, ctx
->Texture
.ProxyTex
[tgt
]);
1064 /* GL_ARB_texture_buffer_object */
1065 _mesa_reference_buffer_object(ctx
, &ctx
->Texture
.BufferObject
, NULL
);
1067 for (u
= 0; u
< ARRAY_SIZE(ctx
->Texture
.Unit
); u
++) {
1068 _mesa_reference_sampler_object(ctx
, &ctx
->Texture
.Unit
[u
].Sampler
, NULL
);
1074 * Update the default texture objects in the given context to reference those
1075 * specified in the shared state and release those referencing the old
1079 _mesa_update_default_objects_texture(struct gl_context
*ctx
)
1083 for (u
= 0; u
< ARRAY_SIZE(ctx
->Texture
.Unit
); u
++) {
1084 struct gl_texture_unit
*texUnit
= &ctx
->Texture
.Unit
[u
];
1085 for (tex
= 0; tex
< NUM_TEXTURE_TARGETS
; tex
++) {
1086 _mesa_reference_texobj(&texUnit
->CurrentTex
[tex
],
1087 ctx
->Shared
->DefaultTex
[tex
]);