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 FLUSH_VERTICES(ctx
, _NEW_TEXTURE_STATE
);
312 ctx
->Texture
.CurrentUnit
= texUnit
;
313 if (ctx
->Transform
.MatrixMode
== GL_TEXTURE
) {
314 /* update current stack pointer */
315 ctx
->CurrentStack
= &ctx
->TextureMatrixStack
[texUnit
];
321 _mesa_ActiveTexture_no_error(GLenum texture
)
323 active_texture(texture
, true);
328 _mesa_ActiveTexture(GLenum texture
)
330 active_texture(texture
, false);
334 /* GL_ARB_multitexture */
336 _mesa_ClientActiveTexture(GLenum texture
)
338 GET_CURRENT_CONTEXT(ctx
);
339 GLuint texUnit
= texture
- GL_TEXTURE0
;
341 if (MESA_VERBOSE
& (VERBOSE_API
| VERBOSE_TEXTURE
))
342 _mesa_debug(ctx
, "glClientActiveTexture %s\n",
343 _mesa_enum_to_string(texture
));
345 if (ctx
->Array
.ActiveTexture
== texUnit
)
348 if (texUnit
>= ctx
->Const
.MaxTextureCoordUnits
) {
349 _mesa_error(ctx
, GL_INVALID_ENUM
, "glClientActiveTexture(texture=%s)",
350 _mesa_enum_to_string(texture
));
354 FLUSH_VERTICES(ctx
, _NEW_ARRAY
);
355 ctx
->Array
.ActiveTexture
= texUnit
;
360 /**********************************************************************/
361 /***** State management *****/
362 /**********************************************************************/
366 * \note This routine refers to derived texture attribute values to
367 * compute the ENABLE_TEXMAT flags, but is only called on
368 * _NEW_TEXTURE_MATRIX. On changes to _NEW_TEXTURE_OBJECT/STATE,
369 * the ENABLE_TEXMAT flags are updated by _mesa_update_textures(), below.
371 * \param ctx GL context.
374 _mesa_update_texture_matrices(struct gl_context
*ctx
)
378 ctx
->Texture
._TexMatEnabled
= 0x0;
380 for (u
= 0; u
< ctx
->Const
.MaxTextureCoordUnits
; u
++) {
381 assert(u
< ARRAY_SIZE(ctx
->TextureMatrixStack
));
382 if (_math_matrix_is_dirty(ctx
->TextureMatrixStack
[u
].Top
)) {
383 _math_matrix_analyse( ctx
->TextureMatrixStack
[u
].Top
);
385 if (ctx
->Texture
.Unit
[u
]._Current
&&
386 ctx
->TextureMatrixStack
[u
].Top
->type
!= MATRIX_IDENTITY
)
387 ctx
->Texture
._TexMatEnabled
|= ENABLE_TEXMAT(u
);
394 * Translate GL combiner state into a MODE_x value
397 tex_combine_translate_mode(GLenum envMode
, GLenum mode
)
400 case GL_REPLACE
: return TEXENV_MODE_REPLACE
;
401 case GL_MODULATE
: return TEXENV_MODE_MODULATE
;
403 if (envMode
== GL_COMBINE4_NV
)
404 return TEXENV_MODE_ADD_PRODUCTS_NV
;
406 return TEXENV_MODE_ADD
;
408 if (envMode
== GL_COMBINE4_NV
)
409 return TEXENV_MODE_ADD_PRODUCTS_SIGNED_NV
;
411 return TEXENV_MODE_ADD_SIGNED
;
412 case GL_INTERPOLATE
: return TEXENV_MODE_INTERPOLATE
;
413 case GL_SUBTRACT
: return TEXENV_MODE_SUBTRACT
;
414 case GL_DOT3_RGB
: return TEXENV_MODE_DOT3_RGB
;
415 case GL_DOT3_RGB_EXT
: return TEXENV_MODE_DOT3_RGB_EXT
;
416 case GL_DOT3_RGBA
: return TEXENV_MODE_DOT3_RGBA
;
417 case GL_DOT3_RGBA_EXT
: return TEXENV_MODE_DOT3_RGBA_EXT
;
418 case GL_MODULATE_ADD_ATI
: return TEXENV_MODE_MODULATE_ADD_ATI
;
419 case GL_MODULATE_SIGNED_ADD_ATI
: return TEXENV_MODE_MODULATE_SIGNED_ADD_ATI
;
420 case GL_MODULATE_SUBTRACT_ATI
: return TEXENV_MODE_MODULATE_SUBTRACT_ATI
;
422 unreachable("Invalid TexEnv Combine mode");
428 tex_combine_translate_source(GLenum src
)
438 case GL_TEXTURE7
: return TEXENV_SRC_TEXTURE0
+ (src
- GL_TEXTURE0
);
439 case GL_TEXTURE
: return TEXENV_SRC_TEXTURE
;
440 case GL_PREVIOUS
: return TEXENV_SRC_PREVIOUS
;
441 case GL_PRIMARY_COLOR
: return TEXENV_SRC_PRIMARY_COLOR
;
442 case GL_CONSTANT
: return TEXENV_SRC_CONSTANT
;
443 case GL_ZERO
: return TEXENV_SRC_ZERO
;
444 case GL_ONE
: return TEXENV_SRC_ONE
;
446 unreachable("Invalid TexEnv Combine argument source");
452 tex_combine_translate_operand(GLenum operand
)
455 case GL_SRC_COLOR
: return TEXENV_OPR_COLOR
;
456 case GL_ONE_MINUS_SRC_COLOR
: return TEXENV_OPR_ONE_MINUS_COLOR
;
457 case GL_SRC_ALPHA
: return TEXENV_OPR_ALPHA
;
458 case GL_ONE_MINUS_SRC_ALPHA
: return TEXENV_OPR_ONE_MINUS_ALPHA
;
460 unreachable("Invalid TexEnv Combine argument source");
466 pack_tex_combine(struct gl_texture_unit
*texUnit
)
468 struct gl_tex_env_combine_state
*state
= texUnit
->_CurrentCombine
;
469 struct gl_tex_env_combine_packed
*packed
= &texUnit
->_CurrentCombinePacked
;
471 memset(packed
, 0, sizeof *packed
);
473 packed
->ModeRGB
= tex_combine_translate_mode(texUnit
->EnvMode
, state
->ModeRGB
);
474 packed
->ModeA
= tex_combine_translate_mode(texUnit
->EnvMode
, state
->ModeA
);
475 packed
->ScaleShiftRGB
= state
->ScaleShiftRGB
;
476 packed
->ScaleShiftA
= state
->ScaleShiftA
;
477 packed
->NumArgsRGB
= state
->_NumArgsRGB
;
478 packed
->NumArgsA
= state
->_NumArgsA
;
480 for (int i
= 0; i
< state
->_NumArgsRGB
; ++i
)
482 packed
->ArgsRGB
[i
].Source
= tex_combine_translate_source(state
->SourceRGB
[i
]);
483 packed
->ArgsRGB
[i
].Operand
= tex_combine_translate_operand(state
->OperandRGB
[i
]);
486 for (int i
= 0; i
< state
->_NumArgsA
; ++i
)
488 packed
->ArgsA
[i
].Source
= tex_combine_translate_source(state
->SourceA
[i
]);
489 packed
->ArgsA
[i
].Operand
= tex_combine_translate_operand(state
->OperandA
[i
]);
495 * Examine texture unit's combine/env state to update derived state.
498 update_tex_combine(struct gl_context
*ctx
, struct gl_texture_unit
*texUnit
)
500 struct gl_tex_env_combine_state
*combine
;
502 /* No combiners will apply to this. */
503 if (texUnit
->_Current
->Target
== GL_TEXTURE_BUFFER
)
506 /* Set the texUnit->_CurrentCombine field to point to the user's combiner
507 * state, or the combiner state which is derived from traditional texenv
510 if (texUnit
->EnvMode
== GL_COMBINE
||
511 texUnit
->EnvMode
== GL_COMBINE4_NV
) {
512 texUnit
->_CurrentCombine
= & texUnit
->Combine
;
515 const struct gl_texture_object
*texObj
= texUnit
->_Current
;
516 GLenum format
= texObj
->Image
[0][texObj
->BaseLevel
]->_BaseFormat
;
518 if (format
== GL_DEPTH_COMPONENT
|| format
== GL_DEPTH_STENCIL_EXT
) {
519 format
= texObj
->DepthMode
;
521 calculate_derived_texenv(&texUnit
->_EnvMode
, texUnit
->EnvMode
, format
);
522 texUnit
->_CurrentCombine
= & texUnit
->_EnvMode
;
525 combine
= texUnit
->_CurrentCombine
;
527 /* Determine number of source RGB terms in the combiner function */
528 switch (combine
->ModeRGB
) {
530 combine
->_NumArgsRGB
= 1;
534 if (texUnit
->EnvMode
== GL_COMBINE4_NV
)
535 combine
->_NumArgsRGB
= 4;
537 combine
->_NumArgsRGB
= 2;
543 case GL_DOT3_RGB_EXT
:
544 case GL_DOT3_RGBA_EXT
:
545 combine
->_NumArgsRGB
= 2;
548 case GL_MODULATE_ADD_ATI
:
549 case GL_MODULATE_SIGNED_ADD_ATI
:
550 case GL_MODULATE_SUBTRACT_ATI
:
551 combine
->_NumArgsRGB
= 3;
554 combine
->_NumArgsRGB
= 0;
555 _mesa_problem(ctx
, "invalid RGB combine mode in update_texture_state");
559 /* Determine number of source Alpha terms in the combiner function */
560 switch (combine
->ModeA
) {
562 combine
->_NumArgsA
= 1;
566 if (texUnit
->EnvMode
== GL_COMBINE4_NV
)
567 combine
->_NumArgsA
= 4;
569 combine
->_NumArgsA
= 2;
573 combine
->_NumArgsA
= 2;
576 case GL_MODULATE_ADD_ATI
:
577 case GL_MODULATE_SIGNED_ADD_ATI
:
578 case GL_MODULATE_SUBTRACT_ATI
:
579 combine
->_NumArgsA
= 3;
582 combine
->_NumArgsA
= 0;
583 _mesa_problem(ctx
, "invalid Alpha combine mode in update_texture_state");
587 pack_tex_combine(texUnit
);
591 update_texgen(struct gl_context
*ctx
)
595 /* Setup texgen for those texture coordinate sets that are in use */
596 for (unit
= 0; unit
< ctx
->Const
.MaxTextureCoordUnits
; unit
++) {
597 struct gl_texture_unit
*texUnit
= &ctx
->Texture
.Unit
[unit
];
599 texUnit
->_GenFlags
= 0x0;
601 if (!(ctx
->Texture
._EnabledCoordUnits
& (1 << unit
)))
604 if (texUnit
->TexGenEnabled
) {
605 if (texUnit
->TexGenEnabled
& S_BIT
) {
606 texUnit
->_GenFlags
|= texUnit
->GenS
._ModeBit
;
608 if (texUnit
->TexGenEnabled
& T_BIT
) {
609 texUnit
->_GenFlags
|= texUnit
->GenT
._ModeBit
;
611 if (texUnit
->TexGenEnabled
& R_BIT
) {
612 texUnit
->_GenFlags
|= texUnit
->GenR
._ModeBit
;
614 if (texUnit
->TexGenEnabled
& Q_BIT
) {
615 texUnit
->_GenFlags
|= texUnit
->GenQ
._ModeBit
;
618 ctx
->Texture
._TexGenEnabled
|= ENABLE_TEXGEN(unit
);
619 ctx
->Texture
._GenFlags
|= texUnit
->_GenFlags
;
622 assert(unit
< ARRAY_SIZE(ctx
->TextureMatrixStack
));
623 if (ctx
->TextureMatrixStack
[unit
].Top
->type
!= MATRIX_IDENTITY
)
624 ctx
->Texture
._TexMatEnabled
|= ENABLE_TEXMAT(unit
);
628 static struct gl_texture_object
*
629 update_single_program_texture(struct gl_context
*ctx
, struct gl_program
*prog
,
632 gl_texture_index target_index
;
633 struct gl_texture_unit
*texUnit
;
634 struct gl_texture_object
*texObj
;
635 struct gl_sampler_object
*sampler
;
637 texUnit
= &ctx
->Texture
.Unit
[unit
];
639 /* Note: If more than one bit was set in TexturesUsed[unit], then we should
640 * have had the draw call rejected already. From the GL 4.4 specification,
641 * section 7.10 ("Samplers"):
643 * "It is not allowed to have variables of different sampler types
644 * pointing to the same texture image unit within a program
645 * object. This situation can only be detected at the next rendering
646 * command issued which triggers shader invocations, and an
647 * INVALID_OPERATION error will then be generated."
649 target_index
= ffs(prog
->TexturesUsed
[unit
]) - 1;
650 texObj
= texUnit
->CurrentTex
[target_index
];
652 sampler
= texUnit
->Sampler
?
653 texUnit
->Sampler
: &texObj
->Sampler
;
655 if (likely(texObj
)) {
656 if (_mesa_is_texture_complete(texObj
, sampler
))
659 _mesa_test_texobj_completeness(ctx
, texObj
);
660 if (_mesa_is_texture_complete(texObj
, sampler
))
664 /* If we've reached this point, we didn't find a complete texture of the
665 * shader's target. From the GL 4.4 core specification, section 11.1.3.5
666 * ("Texture Access"):
668 * "If a sampler is used in a shader and the sampler’s associated
669 * texture is not complete, as defined in section 8.17, (0, 0, 0, 1)
670 * will be returned for a non-shadow sampler and 0 for a shadow
673 * Mesa implements this by creating a hidden texture object with a pixel of
676 texObj
= _mesa_get_fallback_texture(ctx
, target_index
);
683 update_single_program_texture_state(struct gl_context
*ctx
,
684 struct gl_program
*prog
,
686 BITSET_WORD
*enabled_texture_units
)
688 struct gl_texture_object
*texObj
;
690 texObj
= update_single_program_texture(ctx
, prog
, unit
);
694 _mesa_reference_texobj(&ctx
->Texture
.Unit
[unit
]._Current
, texObj
);
695 BITSET_SET(enabled_texture_units
, unit
);
696 ctx
->Texture
._MaxEnabledTexImageUnit
=
697 MAX2(ctx
->Texture
._MaxEnabledTexImageUnit
, (int)unit
);
701 update_program_texture_state(struct gl_context
*ctx
, struct gl_program
**prog
,
702 BITSET_WORD
*enabled_texture_units
)
706 for (i
= 0; i
< MESA_SHADER_STAGES
; i
++) {
713 mask
= prog
[i
]->SamplersUsed
;
716 s
= u_bit_scan(&mask
);
718 update_single_program_texture_state(ctx
, prog
[i
],
719 prog
[i
]->SamplerUnits
[s
],
720 enabled_texture_units
);
723 if (unlikely(prog
[i
]->sh
.HasBoundBindlessSampler
)) {
724 /* Loop over bindless samplers bound to texture units.
726 for (s
= 0; s
< prog
[i
]->sh
.NumBindlessSamplers
; s
++) {
727 struct gl_bindless_sampler
*sampler
=
728 &prog
[i
]->sh
.BindlessSamplers
[s
];
733 update_single_program_texture_state(ctx
, prog
[i
], sampler
->unit
,
734 enabled_texture_units
);
739 if (prog
[MESA_SHADER_FRAGMENT
]) {
740 const GLuint coordMask
= (1 << MAX_TEXTURE_COORD_UNITS
) - 1;
741 ctx
->Texture
._EnabledCoordUnits
|=
742 (prog
[MESA_SHADER_FRAGMENT
]->info
.inputs_read
>> VARYING_SLOT_TEX0
) &
748 update_ff_texture_state(struct gl_context
*ctx
,
749 BITSET_WORD
*enabled_texture_units
)
753 for (unit
= 0; unit
< ctx
->Const
.MaxTextureUnits
; unit
++) {
754 struct gl_texture_unit
*texUnit
= &ctx
->Texture
.Unit
[unit
];
758 if (texUnit
->Enabled
== 0x0)
761 /* If a shader already dictated what texture target was used for this
762 * unit, just go along with it.
764 if (BITSET_TEST(enabled_texture_units
, unit
))
767 /* From the GL 4.4 compat specification, section 16.2 ("Texture Application"):
769 * "Texturing is enabled or disabled using the generic Enable and
770 * Disable commands, respectively, with the symbolic constants
771 * TEXTURE_1D, TEXTURE_2D, TEXTURE_RECTANGLE, TEXTURE_3D, or
772 * TEXTURE_CUBE_MAP to enable the one-, two-, rectangular,
773 * three-dimensional, or cube map texture, respectively. If more
774 * than one of these textures is enabled, the first one enabled
775 * from the following list is used:
777 * • cube map texture
778 * • three-dimensional texture
779 * • rectangular texture
780 * • two-dimensional texture
781 * • one-dimensional texture"
783 * Note that the TEXTURE_x_INDEX values are in high to low priority.
786 * "If a texture unit is disabled or has an invalid or incomplete
787 * texture (as defined in section 8.17) bound to it, then blending
788 * is disabled for that texture unit. If the texture environment
789 * for a given enabled texture unit references a disabled texture
790 * unit, or an invalid or incomplete texture that is bound to
791 * another unit, then the results of texture blending are
795 mask
= texUnit
->Enabled
;
797 const int texIndex
= u_bit_scan(&mask
);
798 struct gl_texture_object
*texObj
= texUnit
->CurrentTex
[texIndex
];
799 struct gl_sampler_object
*sampler
= texUnit
->Sampler
?
800 texUnit
->Sampler
: &texObj
->Sampler
;
802 if (!_mesa_is_texture_complete(texObj
, sampler
)) {
803 _mesa_test_texobj_completeness(ctx
, texObj
);
805 if (_mesa_is_texture_complete(texObj
, sampler
)) {
806 _mesa_reference_texobj(&texUnit
->_Current
, texObj
);
815 /* if we get here, we know this texture unit is enabled */
816 BITSET_SET(enabled_texture_units
, unit
);
817 ctx
->Texture
._MaxEnabledTexImageUnit
=
818 MAX2(ctx
->Texture
._MaxEnabledTexImageUnit
, (int)unit
);
820 ctx
->Texture
._EnabledCoordUnits
|= 1 << unit
;
822 update_tex_combine(ctx
, texUnit
);
827 * \note This routine refers to derived texture matrix values to
828 * compute the ENABLE_TEXMAT flags, but is only called on
829 * _NEW_TEXTURE_OBJECT/STATE. On changes to _NEW_TEXTURE_MATRIX,
830 * the ENABLE_TEXMAT flags are updated by _mesa_update_texture_matrices,
833 * \param ctx GL context.
836 _mesa_update_texture_state(struct gl_context
*ctx
)
838 struct gl_program
*prog
[MESA_SHADER_STAGES
];
840 int old_max_unit
= ctx
->Texture
._MaxEnabledTexImageUnit
;
841 BITSET_DECLARE(enabled_texture_units
, MAX_COMBINED_TEXTURE_IMAGE_UNITS
);
843 for (i
= 0; i
< MESA_SHADER_STAGES
; i
++) {
844 if (ctx
->_Shader
->CurrentProgram
[i
]) {
845 prog
[i
] = ctx
->_Shader
->CurrentProgram
[i
];
851 if (prog
[MESA_SHADER_FRAGMENT
] == NULL
&&
852 _mesa_arb_fragment_program_enabled(ctx
)) {
853 prog
[MESA_SHADER_FRAGMENT
] = ctx
->FragmentProgram
.Current
;
856 /* TODO: only set this if there are actual changes */
857 ctx
->NewState
|= _NEW_TEXTURE_OBJECT
| _NEW_TEXTURE_STATE
;
859 ctx
->Texture
._GenFlags
= 0x0;
860 ctx
->Texture
._TexMatEnabled
= 0x0;
861 ctx
->Texture
._TexGenEnabled
= 0x0;
862 ctx
->Texture
._MaxEnabledTexImageUnit
= -1;
863 ctx
->Texture
._EnabledCoordUnits
= 0x0;
865 memset(&enabled_texture_units
, 0, sizeof(enabled_texture_units
));
867 /* First, walk over our programs pulling in all the textures for them.
868 * Programs dictate specific texture targets to be enabled, and for a draw
869 * call to be valid they can't conflict about which texture targets are
872 update_program_texture_state(ctx
, prog
, enabled_texture_units
);
874 /* Also pull in any textures necessary for fixed function fragment shading.
876 if (!prog
[MESA_SHADER_FRAGMENT
])
877 update_ff_texture_state(ctx
, enabled_texture_units
);
879 /* Now, clear out the _Current of any disabled texture units. */
880 for (i
= 0; i
<= ctx
->Texture
._MaxEnabledTexImageUnit
; i
++) {
881 if (!BITSET_TEST(enabled_texture_units
, i
))
882 _mesa_reference_texobj(&ctx
->Texture
.Unit
[i
]._Current
, NULL
);
884 for (i
= ctx
->Texture
._MaxEnabledTexImageUnit
+ 1; i
<= old_max_unit
; i
++) {
885 _mesa_reference_texobj(&ctx
->Texture
.Unit
[i
]._Current
, NULL
);
888 if (!prog
[MESA_SHADER_FRAGMENT
] || !prog
[MESA_SHADER_VERTEX
])
893 /**********************************************************************/
894 /***** Initialization *****/
895 /**********************************************************************/
898 * Allocate the proxy textures for the given context.
900 * \param ctx the context to allocate proxies for.
902 * \return GL_TRUE on success, or GL_FALSE on failure
904 * If run out of memory part way through the allocations, clean up and return
908 alloc_proxy_textures( struct gl_context
*ctx
)
910 /* NOTE: these values must be in the same order as the TEXTURE_x_INDEX
913 static const GLenum targets
[] = {
914 GL_TEXTURE_2D_MULTISAMPLE
,
915 GL_TEXTURE_2D_MULTISAMPLE_ARRAY
,
916 GL_TEXTURE_CUBE_MAP_ARRAY
,
918 GL_TEXTURE_2D_ARRAY_EXT
,
919 GL_TEXTURE_1D_ARRAY_EXT
,
920 GL_TEXTURE_EXTERNAL_OES
,
923 GL_TEXTURE_RECTANGLE_NV
,
929 STATIC_ASSERT(ARRAY_SIZE(targets
) == NUM_TEXTURE_TARGETS
);
930 assert(targets
[TEXTURE_2D_INDEX
] == GL_TEXTURE_2D
);
931 assert(targets
[TEXTURE_CUBE_INDEX
] == GL_TEXTURE_CUBE_MAP
);
933 for (tgt
= 0; tgt
< NUM_TEXTURE_TARGETS
; tgt
++) {
934 if (!(ctx
->Texture
.ProxyTex
[tgt
]
935 = ctx
->Driver
.NewTextureObject(ctx
, 0, targets
[tgt
]))) {
936 /* out of memory, free what we did allocate */
938 ctx
->Driver
.DeleteTexture(ctx
, ctx
->Texture
.ProxyTex
[tgt
]);
944 assert(ctx
->Texture
.ProxyTex
[0]->RefCount
== 1); /* sanity check */
950 * Initialize a texture unit.
952 * \param ctx GL context.
953 * \param unit texture unit number to be initialized.
956 init_texture_unit( struct gl_context
*ctx
, GLuint unit
)
958 struct gl_texture_unit
*texUnit
= &ctx
->Texture
.Unit
[unit
];
961 texUnit
->EnvMode
= GL_MODULATE
;
962 ASSIGN_4V( texUnit
->EnvColor
, 0.0, 0.0, 0.0, 0.0 );
964 texUnit
->Combine
= default_combine_state
;
965 texUnit
->_EnvMode
= default_combine_state
;
966 texUnit
->_CurrentCombine
= & texUnit
->_EnvMode
;
968 texUnit
->TexGenEnabled
= 0x0;
969 texUnit
->GenS
.Mode
= GL_EYE_LINEAR
;
970 texUnit
->GenT
.Mode
= GL_EYE_LINEAR
;
971 texUnit
->GenR
.Mode
= GL_EYE_LINEAR
;
972 texUnit
->GenQ
.Mode
= GL_EYE_LINEAR
;
973 texUnit
->GenS
._ModeBit
= TEXGEN_EYE_LINEAR
;
974 texUnit
->GenT
._ModeBit
= TEXGEN_EYE_LINEAR
;
975 texUnit
->GenR
._ModeBit
= TEXGEN_EYE_LINEAR
;
976 texUnit
->GenQ
._ModeBit
= TEXGEN_EYE_LINEAR
;
978 /* Yes, these plane coefficients are correct! */
979 ASSIGN_4V( texUnit
->GenS
.ObjectPlane
, 1.0, 0.0, 0.0, 0.0 );
980 ASSIGN_4V( texUnit
->GenT
.ObjectPlane
, 0.0, 1.0, 0.0, 0.0 );
981 ASSIGN_4V( texUnit
->GenR
.ObjectPlane
, 0.0, 0.0, 0.0, 0.0 );
982 ASSIGN_4V( texUnit
->GenQ
.ObjectPlane
, 0.0, 0.0, 0.0, 0.0 );
983 ASSIGN_4V( texUnit
->GenS
.EyePlane
, 1.0, 0.0, 0.0, 0.0 );
984 ASSIGN_4V( texUnit
->GenT
.EyePlane
, 0.0, 1.0, 0.0, 0.0 );
985 ASSIGN_4V( texUnit
->GenR
.EyePlane
, 0.0, 0.0, 0.0, 0.0 );
986 ASSIGN_4V( texUnit
->GenQ
.EyePlane
, 0.0, 0.0, 0.0, 0.0 );
988 /* initialize current texture object ptrs to the shared default objects */
989 for (tex
= 0; tex
< NUM_TEXTURE_TARGETS
; tex
++) {
990 _mesa_reference_texobj(&texUnit
->CurrentTex
[tex
],
991 ctx
->Shared
->DefaultTex
[tex
]);
994 texUnit
->_BoundTextures
= 0;
999 * Initialize texture state for the given context.
1002 _mesa_init_texture(struct gl_context
*ctx
)
1007 ctx
->Texture
.CurrentUnit
= 0; /* multitexture */
1009 /* Appendix F.2 of the OpenGL ES 3.0 spec says:
1011 * "OpenGL ES 3.0 requires that all cube map filtering be
1012 * seamless. OpenGL ES 2.0 specified that a single cube map face be
1013 * selected and used for filtering."
1015 * Unfortunatley, a call to _mesa_is_gles3 below will only work if
1016 * the driver has already computed and set ctx->Version, however drivers
1017 * seem to call _mesa_initialize_context (which calls this) early
1018 * in the CreateContext hook and _mesa_compute_version much later (since
1019 * it needs information about available extensions). So, we will
1020 * enable seamless cubemaps by default since GLES2. This should work
1021 * for most implementations and drivers that don't support seamless
1022 * cubemaps for GLES2 can still disable it.
1024 ctx
->Texture
.CubeMapSeamless
= ctx
->API
== API_OPENGLES2
;
1026 for (u
= 0; u
< ARRAY_SIZE(ctx
->Texture
.Unit
); u
++)
1027 init_texture_unit(ctx
, u
);
1029 /* After we're done initializing the context's texture state the default
1030 * texture objects' refcounts should be at least
1031 * MAX_COMBINED_TEXTURE_IMAGE_UNITS + 1.
1033 assert(ctx
->Shared
->DefaultTex
[TEXTURE_1D_INDEX
]->RefCount
1034 >= MAX_COMBINED_TEXTURE_IMAGE_UNITS
+ 1);
1036 /* Allocate proxy textures */
1037 if (!alloc_proxy_textures( ctx
))
1040 /* GL_ARB_texture_buffer_object */
1041 _mesa_reference_buffer_object(ctx
, &ctx
->Texture
.BufferObject
,
1042 ctx
->Shared
->NullBufferObj
);
1044 ctx
->Texture
.NumCurrentTexUsed
= 0;
1051 * Free dynamically-allocted texture data attached to the given context.
1054 _mesa_free_texture_data(struct gl_context
*ctx
)
1058 /* unreference current textures */
1059 for (u
= 0; u
< ARRAY_SIZE(ctx
->Texture
.Unit
); u
++) {
1060 /* The _Current texture could account for another reference */
1061 _mesa_reference_texobj(&ctx
->Texture
.Unit
[u
]._Current
, NULL
);
1063 for (tgt
= 0; tgt
< NUM_TEXTURE_TARGETS
; tgt
++) {
1064 _mesa_reference_texobj(&ctx
->Texture
.Unit
[u
].CurrentTex
[tgt
], NULL
);
1068 /* Free proxy texture objects */
1069 for (tgt
= 0; tgt
< NUM_TEXTURE_TARGETS
; tgt
++)
1070 ctx
->Driver
.DeleteTexture(ctx
, ctx
->Texture
.ProxyTex
[tgt
]);
1072 /* GL_ARB_texture_buffer_object */
1073 _mesa_reference_buffer_object(ctx
, &ctx
->Texture
.BufferObject
, NULL
);
1075 for (u
= 0; u
< ARRAY_SIZE(ctx
->Texture
.Unit
); u
++) {
1076 _mesa_reference_sampler_object(ctx
, &ctx
->Texture
.Unit
[u
].Sampler
, NULL
);
1082 * Update the default texture objects in the given context to reference those
1083 * specified in the shared state and release those referencing the old
1087 _mesa_update_default_objects_texture(struct gl_context
*ctx
)
1091 for (u
= 0; u
< ARRAY_SIZE(ctx
->Texture
.Unit
); u
++) {
1092 struct gl_texture_unit
*texUnit
= &ctx
->Texture
.Unit
[u
];
1093 for (tex
= 0; tex
< NUM_TEXTURE_TARGETS
; tex
++) {
1094 _mesa_reference_texobj(&texUnit
->CurrentTex
[tex
],
1095 ctx
->Shared
->DefaultTex
[tex
]);