/* * Mesa 3-D graphics library * * Copyright (C) 2013 LunarG, Inc. * * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the "Software"), * to deal in the Software without restriction, including without limitation * the rights to use, copy, modify, merge, publish, distribute, sublicense, * and/or sell copies of the Software, and to permit persons to whom the * Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included * in all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER * DEALINGS IN THE SOFTWARE. * * Authors: * Courtney Goeltzenleuchter */ /** * \file textureview.c * GL_ARB_texture_view functions */ #include "glheader.h" #include "context.h" #include "enums.h" #include "imports.h" #include "macros.h" #include "teximage.h" #include "texobj.h" #include "mipmap.h" #include "texstorage.h" #include "textureview.h" #include "stdbool.h" #include "mtypes.h" /* Table 3.X.2 (Compatible internal formats for TextureView) --------------------------------------------------------------------------- | Class | Internal formats | --------------------------------------------------------------------------- | VIEW_CLASS_128_BITS | RGBA32F, RGBA32UI, RGBA32I | --------------------------------------------------------------------------- | VIEW_CLASS_96_BITS | RGB32F, RGB32UI, RGB32I | --------------------------------------------------------------------------- | VIEW_CLASS_64_BITS | RGBA16F, RG32F, RGBA16UI, RG32UI, RGBA16I, | | | RG32I, RGBA16, RGBA16_SNORM | --------------------------------------------------------------------------- | VIEW_CLASS_48_BITS | RGB16, RGB16_SNORM, RGB16F, RGB16UI, RGB16I | --------------------------------------------------------------------------- | VIEW_CLASS_32_BITS | RG16F, R11F_G11F_B10F, R32F, | | | RGB10_A2UI, RGBA8UI, RG16UI, R32UI, | | | RGBA8I, RG16I, R32I, RGB10_A2, RGBA8, RG16, | | | RGBA8_SNORM, RG16_SNORM, SRGB8_ALPHA8, RGB9_E5 | --------------------------------------------------------------------------- | VIEW_CLASS_24_BITS | RGB8, RGB8_SNORM, SRGB8, RGB8UI, RGB8I | --------------------------------------------------------------------------- | VIEW_CLASS_16_BITS | R16F, RG8UI, R16UI, RG8I, R16I, RG8, R16, | | | RG8_SNORM, R16_SNORM | --------------------------------------------------------------------------- | VIEW_CLASS_8_BITS | R8UI, R8I, R8, R8_SNORM | --------------------------------------------------------------------------- | VIEW_CLASS_RGTC1_RED | COMPRESSED_RED_RGTC1, | | | COMPRESSED_SIGNED_RED_RGTC1 | --------------------------------------------------------------------------- | VIEW_CLASS_RGTC2_RG | COMPRESSED_RG_RGTC2, | | | COMPRESSED_SIGNED_RG_RGTC2 | --------------------------------------------------------------------------- | VIEW_CLASS_BPTC_UNORM | COMPRESSED_RGBA_BPTC_UNORM, | | | COMPRESSED_SRGB_ALPHA_BPTC_UNORM | --------------------------------------------------------------------------- | VIEW_CLASS_BPTC_FLOAT | COMPRESSED_RGB_BPTC_SIGNED_FLOAT, | | | COMPRESSED_RGB_BPTC_UNSIGNED_FLOAT | --------------------------------------------------------------------------- */ #define VIEW_CLASS_GLES(x) (GL_VIEW_CLASS_BPTC_FLOAT + 1 + x) #define VIEW_CLASS_EAC_R11 VIEW_CLASS_GLES(0) #define VIEW_CLASS_EAC_RG11 VIEW_CLASS_GLES(1) #define VIEW_CLASS_ETC2_RGB VIEW_CLASS_GLES(2) #define VIEW_CLASS_ETC2_RGBA VIEW_CLASS_GLES(3) #define VIEW_CLASS_ETC2_EAC_RGBA VIEW_CLASS_GLES(4) #define VIEW_CLASS_ASTC_4x4_RGBA VIEW_CLASS_GLES(5) #define VIEW_CLASS_ASTC_5x4_RGBA VIEW_CLASS_GLES(6) #define VIEW_CLASS_ASTC_5x5_RGBA VIEW_CLASS_GLES(7) #define VIEW_CLASS_ASTC_6x5_RGBA VIEW_CLASS_GLES(8) #define VIEW_CLASS_ASTC_6x6_RGBA VIEW_CLASS_GLES(9) #define VIEW_CLASS_ASTC_8x5_RGBA VIEW_CLASS_GLES(10) #define VIEW_CLASS_ASTC_8x6_RGBA VIEW_CLASS_GLES(11) #define VIEW_CLASS_ASTC_8x8_RGBA VIEW_CLASS_GLES(12) #define VIEW_CLASS_ASTC_10x5_RGBA VIEW_CLASS_GLES(13) #define VIEW_CLASS_ASTC_10x6_RGBA VIEW_CLASS_GLES(14) #define VIEW_CLASS_ASTC_10x8_RGBA VIEW_CLASS_GLES(15) #define VIEW_CLASS_ASTC_10x10_RGBA VIEW_CLASS_GLES(16) #define VIEW_CLASS_ASTC_12x10_RGBA VIEW_CLASS_GLES(17) #define VIEW_CLASS_ASTC_12x12_RGBA VIEW_CLASS_GLES(18) #define VIEW_CLASS_ASTC_3x3x3_RGBA VIEW_CLASS_GLES(19) #define VIEW_CLASS_ASTC_4x3x3_RGBA VIEW_CLASS_GLES(20) #define VIEW_CLASS_ASTC_4x4x3_RGBA VIEW_CLASS_GLES(21) #define VIEW_CLASS_ASTC_4x4x4_RGBA VIEW_CLASS_GLES(22) #define VIEW_CLASS_ASTC_5x4x4_RGBA VIEW_CLASS_GLES(23) #define VIEW_CLASS_ASTC_5x5x4_RGBA VIEW_CLASS_GLES(24) #define VIEW_CLASS_ASTC_5x5x5_RGBA VIEW_CLASS_GLES(25) #define VIEW_CLASS_ASTC_6x5x5_RGBA VIEW_CLASS_GLES(26) #define VIEW_CLASS_ASTC_6x6x5_RGBA VIEW_CLASS_GLES(27) #define VIEW_CLASS_ASTC_6x6x6_RGBA VIEW_CLASS_GLES(28) struct internal_format_class_info { GLenum view_class; GLenum internal_format; }; static const struct internal_format_class_info compatible_internal_formats[] = { {GL_VIEW_CLASS_128_BITS, GL_RGBA32F}, {GL_VIEW_CLASS_128_BITS, GL_RGBA32UI}, {GL_VIEW_CLASS_128_BITS, GL_RGBA32I}, {GL_VIEW_CLASS_96_BITS, GL_RGB32F}, {GL_VIEW_CLASS_96_BITS, GL_RGB32UI}, {GL_VIEW_CLASS_96_BITS, GL_RGB32I}, {GL_VIEW_CLASS_64_BITS, GL_RGBA16F}, {GL_VIEW_CLASS_64_BITS, GL_RG32F}, {GL_VIEW_CLASS_64_BITS, GL_RGBA16UI}, {GL_VIEW_CLASS_64_BITS, GL_RG32UI}, {GL_VIEW_CLASS_64_BITS, GL_RGBA16I}, {GL_VIEW_CLASS_64_BITS, GL_RG32I}, {GL_VIEW_CLASS_64_BITS, GL_RGBA16}, {GL_VIEW_CLASS_64_BITS, GL_RGBA16_SNORM}, {GL_VIEW_CLASS_48_BITS, GL_RGB16}, {GL_VIEW_CLASS_48_BITS, GL_RGB16_SNORM}, {GL_VIEW_CLASS_48_BITS, GL_RGB16F}, {GL_VIEW_CLASS_48_BITS, GL_RGB16UI}, {GL_VIEW_CLASS_48_BITS, GL_RGB16I}, {GL_VIEW_CLASS_32_BITS, GL_RG16F}, {GL_VIEW_CLASS_32_BITS, GL_R11F_G11F_B10F}, {GL_VIEW_CLASS_32_BITS, GL_R32F}, {GL_VIEW_CLASS_32_BITS, GL_RGB10_A2UI}, {GL_VIEW_CLASS_32_BITS, GL_RGBA8UI}, {GL_VIEW_CLASS_32_BITS, GL_RG16UI}, {GL_VIEW_CLASS_32_BITS, GL_R32UI}, {GL_VIEW_CLASS_32_BITS, GL_RGBA8I}, {GL_VIEW_CLASS_32_BITS, GL_RG16I}, {GL_VIEW_CLASS_32_BITS, GL_R32I}, {GL_VIEW_CLASS_32_BITS, GL_RGB10_A2}, {GL_VIEW_CLASS_32_BITS, GL_RGBA8}, {GL_VIEW_CLASS_32_BITS, GL_RG16}, {GL_VIEW_CLASS_32_BITS, GL_RGBA8_SNORM}, {GL_VIEW_CLASS_32_BITS, GL_RG16_SNORM}, {GL_VIEW_CLASS_32_BITS, GL_SRGB8_ALPHA8}, {GL_VIEW_CLASS_32_BITS, GL_RGB9_E5}, {GL_VIEW_CLASS_24_BITS, GL_RGB8}, {GL_VIEW_CLASS_24_BITS, GL_RGB8_SNORM}, {GL_VIEW_CLASS_24_BITS, GL_SRGB8}, {GL_VIEW_CLASS_24_BITS, GL_RGB8UI}, {GL_VIEW_CLASS_24_BITS, GL_RGB8I}, {GL_VIEW_CLASS_16_BITS, GL_R16F}, {GL_VIEW_CLASS_16_BITS, GL_RG8UI}, {GL_VIEW_CLASS_16_BITS, GL_R16UI}, {GL_VIEW_CLASS_16_BITS, GL_RG8I}, {GL_VIEW_CLASS_16_BITS, GL_R16I}, {GL_VIEW_CLASS_16_BITS, GL_RG8}, {GL_VIEW_CLASS_16_BITS, GL_R16}, {GL_VIEW_CLASS_16_BITS, GL_RG8_SNORM}, {GL_VIEW_CLASS_16_BITS, GL_R16_SNORM}, {GL_VIEW_CLASS_8_BITS, GL_R8UI}, {GL_VIEW_CLASS_8_BITS, GL_R8I}, {GL_VIEW_CLASS_8_BITS, GL_R8}, {GL_VIEW_CLASS_8_BITS, GL_R8_SNORM}, {GL_VIEW_CLASS_RGTC1_RED, GL_COMPRESSED_RED_RGTC1}, {GL_VIEW_CLASS_RGTC1_RED, GL_COMPRESSED_SIGNED_RED_RGTC1}, {GL_VIEW_CLASS_RGTC2_RG, GL_COMPRESSED_RG_RGTC2}, {GL_VIEW_CLASS_RGTC2_RG, GL_COMPRESSED_SIGNED_RG_RGTC2}, {GL_VIEW_CLASS_BPTC_UNORM, GL_COMPRESSED_RGBA_BPTC_UNORM_ARB}, {GL_VIEW_CLASS_BPTC_UNORM, GL_COMPRESSED_SRGB_ALPHA_BPTC_UNORM_ARB}, {GL_VIEW_CLASS_BPTC_FLOAT, GL_COMPRESSED_RGB_BPTC_SIGNED_FLOAT_ARB}, {GL_VIEW_CLASS_BPTC_FLOAT, GL_COMPRESSED_RGB_BPTC_UNSIGNED_FLOAT_ARB}, }; static const struct internal_format_class_info s3tc_compatible_internal_formats[] = { {GL_VIEW_CLASS_S3TC_DXT1_RGB, GL_COMPRESSED_RGB_S3TC_DXT1_EXT}, {GL_VIEW_CLASS_S3TC_DXT1_RGB, GL_COMPRESSED_SRGB_S3TC_DXT1_EXT}, {GL_VIEW_CLASS_S3TC_DXT1_RGBA, GL_COMPRESSED_RGBA_S3TC_DXT1_EXT}, {GL_VIEW_CLASS_S3TC_DXT1_RGBA, GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT1_EXT}, {GL_VIEW_CLASS_S3TC_DXT3_RGBA, GL_COMPRESSED_RGBA_S3TC_DXT3_EXT}, {GL_VIEW_CLASS_S3TC_DXT3_RGBA, GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT3_EXT}, {GL_VIEW_CLASS_S3TC_DXT5_RGBA, GL_COMPRESSED_RGBA_S3TC_DXT5_EXT}, {GL_VIEW_CLASS_S3TC_DXT5_RGBA, GL_COMPRESSED_SRGB_ALPHA_S3TC_DXT5_EXT}, }; static const struct internal_format_class_info gles_etc2_compatible_internal_formats[] = { {VIEW_CLASS_EAC_R11, GL_COMPRESSED_R11_EAC}, {VIEW_CLASS_EAC_R11, GL_COMPRESSED_SIGNED_R11_EAC}, {VIEW_CLASS_EAC_RG11, GL_COMPRESSED_RG11_EAC}, {VIEW_CLASS_EAC_RG11, GL_COMPRESSED_SIGNED_RG11_EAC}, {VIEW_CLASS_ETC2_RGB, GL_COMPRESSED_RGB8_ETC2}, {VIEW_CLASS_ETC2_RGB, GL_COMPRESSED_SRGB8_ETC2}, {VIEW_CLASS_ETC2_RGBA, GL_COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2}, {VIEW_CLASS_ETC2_RGBA, GL_COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2}, {VIEW_CLASS_ETC2_EAC_RGBA, GL_COMPRESSED_RGBA8_ETC2_EAC}, {VIEW_CLASS_ETC2_EAC_RGBA, GL_COMPRESSED_SRGB8_ALPHA8_ETC2_EAC}, }; static const struct internal_format_class_info gles_astc_compatible_internal_formats[] = { #define ASTC_FMT(size) \ {VIEW_CLASS_ASTC_##size##_RGBA, GL_COMPRESSED_RGBA_ASTC_##size##_KHR}, \ {VIEW_CLASS_ASTC_##size##_RGBA, GL_COMPRESSED_SRGB8_ALPHA8_ASTC_##size##_KHR} ASTC_FMT(4x4), ASTC_FMT(5x4), ASTC_FMT(5x5), ASTC_FMT(6x5), ASTC_FMT(6x6), ASTC_FMT(8x5), ASTC_FMT(8x6), ASTC_FMT(8x8), ASTC_FMT(10x5), ASTC_FMT(10x6), ASTC_FMT(10x8), ASTC_FMT(10x10), ASTC_FMT(12x10), ASTC_FMT(12x12), #undef ASTC_FMT }; static const struct internal_format_class_info gles_astc_3d_compatible_internal_formats[] = { #define ASTC_FMT(size) \ {VIEW_CLASS_ASTC_##size##_RGBA, GL_COMPRESSED_RGBA_ASTC_##size##_OES}, \ {VIEW_CLASS_ASTC_##size##_RGBA, GL_COMPRESSED_SRGB8_ALPHA8_ASTC_##size##_OES} ASTC_FMT(3x3x3), ASTC_FMT(4x3x3), ASTC_FMT(4x4x3), ASTC_FMT(4x4x4), ASTC_FMT(5x4x4), ASTC_FMT(5x5x4), ASTC_FMT(5x5x5), ASTC_FMT(6x5x5), ASTC_FMT(6x6x5), ASTC_FMT(6x6x6), #undef ASTC_FMT }; GLenum _mesa_texture_view_lookup_view_class(const struct gl_context *ctx, GLenum internalformat) { GLuint i; for (i = 0; i < ARRAY_SIZE(compatible_internal_formats); i++) { if (compatible_internal_formats[i].internal_format == internalformat) return compatible_internal_formats[i].view_class; } if (ctx->Extensions.EXT_texture_compression_s3tc && ctx->Extensions.EXT_texture_sRGB) { for (i = 0; i < ARRAY_SIZE(s3tc_compatible_internal_formats); i++) { if (s3tc_compatible_internal_formats[i].internal_format == internalformat) return s3tc_compatible_internal_formats[i].view_class; } } if (_mesa_is_gles3(ctx)) { for (i = 0; i < ARRAY_SIZE(gles_etc2_compatible_internal_formats); i++) { if (gles_etc2_compatible_internal_formats[i].internal_format == internalformat) return gles_etc2_compatible_internal_formats[i].view_class; } if (ctx->Extensions.KHR_texture_compression_astc_ldr) { for (i = 0; i < ARRAY_SIZE(gles_astc_compatible_internal_formats); i++) { if (gles_astc_compatible_internal_formats[i].internal_format == internalformat) return gles_astc_compatible_internal_formats[i].view_class; } } if (ctx->Extensions.OES_texture_compression_astc) { for (i = 0; i < ARRAY_SIZE(gles_astc_3d_compatible_internal_formats); i++) { if (gles_astc_3d_compatible_internal_formats[i].internal_format == internalformat) return gles_astc_3d_compatible_internal_formats[i].view_class; } } } return GL_FALSE; } /** * Initialize new texture's gl_texture_image structures. Will not call driver * to allocate new space, simply record relevant layer, face, format, etc. * \return GL_FALSE if any error, GL_TRUE otherwise. */ static GLboolean initialize_texture_fields(struct gl_context *ctx, GLenum target, struct gl_texture_object *texObj, GLint levels, GLsizei width, GLsizei height, GLsizei depth, GLenum internalFormat, mesa_format texFormat) { const GLuint numFaces = _mesa_num_tex_faces(target); GLint level, levelWidth = width, levelHeight = height, levelDepth = depth; GLuint face; /* Pretend we are bound to initialize the gl_texture_image structs */ texObj->Target = target; /* Set up all the texture object's gl_texture_images */ for (level = 0; level < levels; level++) { for (face = 0; face < numFaces; face++) { struct gl_texture_image *texImage; const GLenum faceTarget = _mesa_cube_face_target(target, face); texImage = _mesa_get_tex_image(ctx, texObj, faceTarget, level); if (!texImage) { _mesa_error(ctx, GL_OUT_OF_MEMORY, "glTexStorage"); return GL_FALSE; } _mesa_init_teximage_fields(ctx, texImage, levelWidth, levelHeight, levelDepth, 0, internalFormat, texFormat); } _mesa_next_mipmap_level_size(target, 0, levelWidth, levelHeight, levelDepth, &levelWidth, &levelHeight, &levelDepth); } /* "unbind" */ texObj->Target = 0; return GL_TRUE; } #define RETURN_IF_SUPPORTED(t) do { \ if (newTarget == GL_ ## t) \ return true; \ } while (0) /** * Check for compatible target * If an error is found, record it with _mesa_error() * \return false if any error, true otherwise. */ static bool target_valid(struct gl_context *ctx, GLenum origTarget, GLenum newTarget) { /* * From ARB_texture_view spec: --------------------------------------------------------------------------------------------------------- | Original target | Valid new targets | --------------------------------------------------------------------------------------------------------- | TEXTURE_1D | TEXTURE_1D, TEXTURE_1D_ARRAY | | ------------------------------------------------------------------------------------------------------- | | TEXTURE_2D | TEXTURE_2D, TEXTURE_2D_ARRAY | | ------------------------------------------------------------------------------------------------------- | | TEXTURE_3D | TEXTURE_3D | | ------------------------------------------------------------------------------------------------------- | | TEXTURE_CUBE_MAP | TEXTURE_CUBE_MAP, TEXTURE_2D, TEXTURE_2D_ARRAY, TEXTURE_CUBE_MAP_ARRAY | | ------------------------------------------------------------------------------------------------------- | | TEXTURE_RECTANGLE | TEXTURE_RECTANGLE | | ------------------------------------------------------------------------------------------------------- | | TEXTURE_BUFFER | | | ------------------------------------------------------------------------------------------------------- | | TEXTURE_1D_ARRAY | TEXTURE_1D_ARRAY, TEXTURE_1D | | ------------------------------------------------------------------------------------------------------- | | TEXTURE_2D_ARRAY | TEXTURE_2D_ARRAY, TEXTURE_2D, TEXTURE_CUBE_MAP, TEXTURE_CUBE_MAP_ARRAY | | ------------------------------------------------------------------------------------------------------- | | TEXTURE_CUBE_MAP_ARRAY | TEXTURE_CUBE_MAP_ARRAY, TEXTURE_2D_ARRAY, TEXTURE_2D, TEXTURE_CUBE_MAP | | ------------------------------------------------------------------------------------------------------- | | TEXTURE_2D_MULTISAMPLE | TEXTURE_2D_MULTISAMPLE, TEXTURE_2D_MULTISAMPLE_ARRAY | | ------------------------------------------------------------------------------------------------------- | | TEXTURE_2D_MULTISAMPLE_ARRAY | TEXTURE_2D_MULTISAMPLE, TEXTURE_2D_MULTISAMPLE_ARRAY | --------------------------------------------------------------------------------------------------------- */ switch (origTarget) { case GL_TEXTURE_1D: case GL_TEXTURE_1D_ARRAY: RETURN_IF_SUPPORTED(TEXTURE_1D); RETURN_IF_SUPPORTED(TEXTURE_1D_ARRAY); break; case GL_TEXTURE_2D: RETURN_IF_SUPPORTED(TEXTURE_2D); RETURN_IF_SUPPORTED(TEXTURE_2D_ARRAY); break; case GL_TEXTURE_3D: RETURN_IF_SUPPORTED(TEXTURE_3D); break; case GL_TEXTURE_RECTANGLE: RETURN_IF_SUPPORTED(TEXTURE_RECTANGLE); break; case GL_TEXTURE_CUBE_MAP: case GL_TEXTURE_2D_ARRAY: case GL_TEXTURE_CUBE_MAP_ARRAY: RETURN_IF_SUPPORTED(TEXTURE_2D); RETURN_IF_SUPPORTED(TEXTURE_2D_ARRAY); RETURN_IF_SUPPORTED(TEXTURE_CUBE_MAP); RETURN_IF_SUPPORTED(TEXTURE_CUBE_MAP_ARRAY); break; case GL_TEXTURE_2D_MULTISAMPLE: case GL_TEXTURE_2D_MULTISAMPLE_ARRAY: RETURN_IF_SUPPORTED(TEXTURE_2D_MULTISAMPLE); RETURN_IF_SUPPORTED(TEXTURE_2D_MULTISAMPLE_ARRAY); break; } _mesa_error(ctx, GL_INVALID_OPERATION, "glTextureView(illegal target=%s)", _mesa_enum_to_string(newTarget)); return false; } #undef RETURN_IF_SUPPORTED /** * Check for compatible format * If an error is found, record it with _mesa_error() * \return false if any error, true otherwise. */ bool _mesa_texture_view_compatible_format(const struct gl_context *ctx, GLenum origInternalFormat, GLenum newInternalFormat) { unsigned int origViewClass, newViewClass; /* The two textures' internal formats must be compatible according to * Table 3.X.2 (Compatible internal formats for TextureView) * if the internal format exists in that table the view class must match. * The internal formats must be identical if not in that table, * or an INVALID_OPERATION error is generated. */ if (origInternalFormat == newInternalFormat) return true; origViewClass = _mesa_texture_view_lookup_view_class(ctx, origInternalFormat); newViewClass = _mesa_texture_view_lookup_view_class(ctx, newInternalFormat); if ((origViewClass == newViewClass) && origViewClass != false) return true; return false; } /** * Helper function for TexStorage and teximagemultisample to set immutable * texture state needed by ARB_texture_view. */ void _mesa_set_texture_view_state(struct gl_context *ctx, struct gl_texture_object *texObj, GLenum target, GLuint levels) { struct gl_texture_image *texImage; /* Get a reference to what will become this View's base level */ texImage = _mesa_select_tex_image(texObj, target, 0); /* When an immutable texture is created via glTexStorage or * glTexImageMultisample, * TEXTURE_IMMUTABLE_FORMAT becomes TRUE. * TEXTURE_IMMUTABLE_LEVELS and TEXTURE_VIEW_NUM_LEVELS become levels. * If the texture target is TEXTURE_1D_ARRAY then * TEXTURE_VIEW_NUM_LAYERS becomes height. * If the texture target is TEXTURE_2D_ARRAY, TEXTURE_CUBE_MAP_ARRAY, * or TEXTURE_2D_MULTISAMPLE_ARRAY then TEXTURE_VIEW_NUM_LAYERS becomes * depth. * If the texture target is TEXTURE_CUBE_MAP, then * TEXTURE_VIEW_NUM_LAYERS becomes 6. * For any other texture target, TEXTURE_VIEW_NUM_LAYERS becomes 1. * * ARB_texture_multisample: Multisample textures do * not have multiple image levels. */ texObj->Immutable = GL_TRUE; texObj->ImmutableLevels = levels; texObj->MinLevel = 0; texObj->NumLevels = levels; texObj->MinLayer = 0; texObj->NumLayers = 1; switch (target) { case GL_TEXTURE_1D_ARRAY: texObj->NumLayers = texImage->Height; break; case GL_TEXTURE_2D_MULTISAMPLE: texObj->NumLevels = 1; texObj->ImmutableLevels = 1; break; case GL_TEXTURE_2D_MULTISAMPLE_ARRAY: texObj->NumLevels = 1; texObj->ImmutableLevels = 1; /* fall through to set NumLayers */ case GL_TEXTURE_2D_ARRAY: case GL_TEXTURE_CUBE_MAP_ARRAY: texObj->NumLayers = texImage->Depth; break; case GL_TEXTURE_CUBE_MAP: texObj->NumLayers = 6; break; } } /** * glTextureView (ARB_texture_view) * If an error is found, record it with _mesa_error() * \return none. */ void GLAPIENTRY _mesa_TextureView(GLuint texture, GLenum target, GLuint origtexture, GLenum internalformat, GLuint minlevel, GLuint numlevels, GLuint minlayer, GLuint numlayers) { struct gl_texture_object *texObj; struct gl_texture_object *origTexObj; struct gl_texture_image *origTexImage; GLuint newViewMinLevel, newViewMinLayer; GLuint newViewNumLevels, newViewNumLayers; GLsizei width, height, depth; mesa_format texFormat; GLboolean sizeOK, dimensionsOK; GLenum faceTarget; GET_CURRENT_CONTEXT(ctx); if (MESA_VERBOSE & (VERBOSE_API | VERBOSE_TEXTURE)) _mesa_debug(ctx, "glTextureView %d %s %d %s %d %d %d %d\n", texture, _mesa_enum_to_string(target), origtexture, _mesa_enum_to_string(internalformat), minlevel, numlevels, minlayer, numlayers); if (origtexture == 0) { _mesa_error(ctx, GL_INVALID_VALUE, "glTextureView(origtexture = %u)", origtexture); return; } /* Need original texture information to validate arguments */ origTexObj = _mesa_lookup_texture(ctx, origtexture); /* If is not the name of a texture, INVALID_VALUE * is generated. */ if (!origTexObj) { _mesa_error(ctx, GL_INVALID_VALUE, "glTextureView(origtexture = %u)", origtexture); return; } /* If 's TEXTURE_IMMUTABLE_FORMAT value is not TRUE, * INVALID_OPERATION is generated. */ if (!origTexObj->Immutable) { _mesa_error(ctx, GL_INVALID_OPERATION, "glTextureView(origtexture not immutable)"); return; } /* If is 0, INVALID_VALUE is generated. */ if (texture == 0) { _mesa_error(ctx, GL_INVALID_VALUE, "glTextureView(texture = 0)"); return; } /* If is not a valid name returned by GenTextures, * the error INVALID_OPERATION is generated. */ texObj = _mesa_lookup_texture(ctx, texture); if (texObj == NULL) { _mesa_error(ctx, GL_INVALID_OPERATION, "glTextureView(texture = %u non-gen name)", texture); return; } /* If has already been bound and given a target, then * the error INVALID_OPERATION is generated. */ if (texObj->Target) { _mesa_error(ctx, GL_INVALID_OPERATION, "glTextureView(texture = %u already bound)", texture); return; } /* Check for compatible target */ if (!target_valid(ctx, origTexObj->Target, target)) { return; /* error was recorded */ } /* minlevel and minlayer are relative to the view of origtexture. * If minlevel or minlayer is greater than level or layer, respectively, * return INVALID_VALUE. */ newViewMinLevel = origTexObj->MinLevel + minlevel; newViewMinLayer = origTexObj->MinLayer + minlayer; if (newViewMinLevel >= (origTexObj->MinLevel + origTexObj->NumLevels)) { _mesa_error(ctx, GL_INVALID_VALUE, "glTextureView(new minlevel (%d) > orig minlevel (%d)" " + orig numlevels (%d))", newViewMinLevel, origTexObj->MinLevel, origTexObj->NumLevels); return; } if (newViewMinLayer >= (origTexObj->MinLayer + origTexObj->NumLayers)) { _mesa_error(ctx, GL_INVALID_VALUE, "glTextureView(new minlayer (%d) > orig minlayer (%d)" " + orig numlayers (%d))", newViewMinLayer, origTexObj->MinLayer, origTexObj->NumLayers); return; } if (!_mesa_texture_view_compatible_format(ctx, origTexObj->Image[0][0]->InternalFormat, internalformat)) { _mesa_error(ctx, GL_INVALID_OPERATION, "glTextureView(internalformat %s not compatible with origtexture %s)", _mesa_enum_to_string(internalformat), _mesa_enum_to_string(origTexObj->Image[0][0]->InternalFormat)); return; } texFormat = _mesa_choose_texture_format(ctx, texObj, target, 0, internalformat, GL_NONE, GL_NONE); if (texFormat == MESA_FORMAT_NONE) return; newViewNumLevels = MIN2(numlevels, origTexObj->NumLevels - minlevel); newViewNumLayers = MIN2(numlayers, origTexObj->NumLayers - minlayer); faceTarget = _mesa_cube_face_target(origTexObj->Target, minlayer); /* Get a reference to what will become this View's base level */ origTexImage = _mesa_select_tex_image(origTexObj, faceTarget, minlevel); width = origTexImage->Width; height = origTexImage->Height; depth = origTexImage->Depth; /* Adjust width, height, depth to be appropriate for new target */ switch (target) { case GL_TEXTURE_1D: height = 1; break; case GL_TEXTURE_3D: break; case GL_TEXTURE_1D_ARRAY: height = (GLsizei) newViewNumLayers; break; case GL_TEXTURE_2D: case GL_TEXTURE_2D_MULTISAMPLE: case GL_TEXTURE_RECTANGLE: depth = 1; break; case GL_TEXTURE_CUBE_MAP: /* If the new texture's target is TEXTURE_CUBE_MAP, the clamped * must be equal to 6. */ if (newViewNumLayers != 6) { _mesa_error(ctx, GL_INVALID_VALUE, "glTextureView(clamped numlayers %d != 6)", newViewNumLayers); return; } depth = 1; break; case GL_TEXTURE_2D_ARRAY: case GL_TEXTURE_2D_MULTISAMPLE_ARRAY: depth = newViewNumLayers; break; case GL_TEXTURE_CUBE_MAP_ARRAY: /* If the new texture's target is TEXTURE_CUBE_MAP_ARRAY, * then counts layer-faces rather than layers, * and the clamped must be a multiple of 6. * Otherwise, the error INVALID_VALUE is generated. */ if ((newViewNumLayers % 6) != 0) { _mesa_error(ctx, GL_INVALID_VALUE, "glTextureView(clamped numlayers %d is not" " a multiple of 6)", newViewNumLayers); return; } depth = newViewNumLayers; break; } /* If the dimensions of the original texture are larger than the maximum * supported dimensions of the new target, the error INVALID_OPERATION is * generated. For example, if the original texture has a TEXTURE_2D_ARRAY * target and its width is greater than MAX_CUBE_MAP_TEXTURE_SIZE, an error * will be generated if TextureView is called to create a TEXTURE_CUBE_MAP * view. */ dimensionsOK = _mesa_legal_texture_dimensions(ctx, target, 0, width, height, depth, 0); if (!dimensionsOK) { _mesa_error(ctx, GL_INVALID_OPERATION, "glTextureView(invalid width or height or depth)"); return; } sizeOK = ctx->Driver.TestProxyTexImage(ctx, target, 1, 0, texFormat, origTexImage->NumSamples, width, height, depth); if (!sizeOK) { _mesa_error(ctx, GL_INVALID_OPERATION, "glTextureView(invalid texture size)"); return; } /* If is TEXTURE_1D, TEXTURE_2D, TEXTURE_3D, TEXTURE_RECTANGLE, * or TEXTURE_2D_MULTISAMPLE and does not equal 1, the error * INVALID_VALUE is generated. */ switch (target) { case GL_TEXTURE_1D: case GL_TEXTURE_2D: case GL_TEXTURE_3D: case GL_TEXTURE_RECTANGLE: case GL_TEXTURE_2D_MULTISAMPLE: if (numlayers != 1) { _mesa_error(ctx, GL_INVALID_VALUE, "glTextureView(numlayers %d != 1)", numlayers); return; } break; case GL_TEXTURE_CUBE_MAP: break; case GL_TEXTURE_CUBE_MAP_ARRAY: break; } /* If the new texture's target is TEXTURE_CUBE_MAP or * TEXTURE_CUBE_MAP_ARRAY, the width and height of the original texture's * levels must be equal otherwise the error INVALID_OPERATION is generated. */ if ((target == GL_TEXTURE_CUBE_MAP || target == GL_TEXTURE_CUBE_MAP_ARRAY) && (origTexImage->Width != origTexImage->Height)) { _mesa_error(ctx, GL_INVALID_OPERATION, "glTextureView(origtexture width (%d) != height (%d))", origTexImage->Width, origTexImage->Height); return; } /* When the original texture's target is TEXTURE_CUBE_MAP, the layer * parameters are interpreted in the same order as if it were a * TEXTURE_CUBE_MAP_ARRAY with 6 layer-faces. */ /* If the internal format does not exactly match the internal format of the * original texture, the contents of the memory are reinterpreted in the * same manner as for image bindings described in * section 3.9.20 (Texture Image Loads and Stores). */ /* TEXTURE_BASE_LEVEL and TEXTURE_MAX_LEVEL are interpreted * relative to the view and not relative to the original data store. */ if (!initialize_texture_fields(ctx, target, texObj, newViewNumLevels, width, height, depth, internalformat, texFormat)) { return; /* Already recorded error */ } texObj->MinLevel = newViewMinLevel; texObj->MinLayer = newViewMinLayer; texObj->NumLevels = newViewNumLevels; texObj->NumLayers = newViewNumLayers; texObj->Immutable = GL_TRUE; texObj->ImmutableLevels = origTexObj->ImmutableLevels; texObj->Target = target; texObj->TargetIndex = _mesa_tex_target_to_index(ctx, target); assert(texObj->TargetIndex < NUM_TEXTURE_TARGETS); if (ctx->Driver.TextureView != NULL && !ctx->Driver.TextureView(ctx, texObj, origTexObj)) { return; /* driver recorded error */ } }