/*
* 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 <courtney@lunarg.com>
*/
/**
* \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 | <none> |
| ------------------------------------------------------------------------------------------------------- |
| 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 <origtexture> 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 <origtexture>'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 <texture> is 0, INVALID_VALUE is generated. */
if (texture == 0) {
_mesa_error(ctx, GL_INVALID_VALUE, "glTextureView(texture = 0)");
return;
}
/* If <texture> 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 <texture> 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);
assert(texFormat != MESA_FORMAT_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
* <numlayers> 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 <numlayers> counts layer-faces rather than layers,
* and the clamped <numlayers> 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 <target> is TEXTURE_1D, TEXTURE_2D, TEXTURE_3D, TEXTURE_RECTANGLE,
* or TEXTURE_2D_MULTISAMPLE and <numlayers> 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 */
}
}