GLES2.0中文API-glCompressedTexImage2D

名称

glCompressedTexImage2D - 以压缩格式指定二维纹理图像

C规范

void glCompressedTexImage2D(    GLenum target,
     GLint level,
     GLenum internalformat,
     GLsizei width,
     GLsizei height,
     GLint border,
     GLsizei imageSize,
     const GLvoid * data);

参数

target

指定活动纹理单元的目标纹理。必须是GL_TEXTURE_2D，GL_TEXTURE_CUBE_MAP_POSITIVE_X，GL_TEXTURE_CUBE_MAP_NEGATIVE_X，GL_TEXTURE_CUBE_MAP_POSITIVE_Y，GL_TEXTURE_CUBE_MAP_NEGATIVE_Y，GL_TEXTURE_CUBE_MAP_POSITIVE_Z或GL_TEXTURE_CUBE_MAP_NEGATIVE_Z。

level

指定详细级别。 0级是基本图像级别。级别n是第n个mipmap缩小图像。

internalformat

指定存储在地址数据中的压缩图像数据的格式。

width

指定纹理图像的宽度。所有实现都支持至少64个纹素宽的2D纹理图像和至少16个纹素宽的立方体映射纹理图像。

height

指定纹理图像的高度。所有实现都支持至少64个纹素高的2D纹理图像和至少16个纹素高的立方体映射纹理图像。

border

指定边框的宽度。必须为0。

imageSize

指定从data指定的地址开始的图像数据的无符号字节数。

data

指定指向内存中压缩图像数据的指针。

描述

纹理将指定纹理图像的一部分映射到纹理处于活动状态的每个图形基元上。当前片段着色器或顶点着色器使用内置纹理查找功能时，纹理处于活动状态。

glCompressedTexImage2D使用来自客户端内存的压缩图像数据定义二维纹理图像或立方体贴图纹理图像。根据定义指定内部格式的扩展规范来解码纹理图像。 OpenGL ES没有定义特定的压缩纹理格式，但确实提供了一种机制来获取扩展提供的这种格式的符号常量。通过查询GL_NUM_COMPRESSED_TEXTURE_FORMATS的值可以获得支持的压缩纹理格式的数量。支持的特定压缩纹理格式列表可以通过查询GL_COMPRESSED_TEXTURE_FORMATS的值来获得。

注意

GL实现可以选择以其选择的任何内部分辨率存储纹理数组。

glCompressedTexImage2D指定使用glActiveTexture指定的纹理单元的二维或立方体贴图纹理。

错误

GL_INVALID_ENUM：target不是GL_TEXTURE_2D，GL_TEXTURE_CUBE_MAP_POSITIVE_X，GL_TEXTURE_CUBE_MAP_NEGATIVE_X，GL_TEXTURE_CUBE_MAP_POSITIVE_Y，GL_TEXTURE_CUBE_MAP_NEGATIVE_Y，GL_TEXTURE_CUBE_MAP_POSITIVE_Z或GL_TEXTURE_CUBE_MAP_NEGATIVE_Z

GL_INVALID_ENUM：internalformat不是GL_COMPRESSED_TEXTURE_FORMATS中返回的受支持格式

GL_INVALID_VALUE：level小于0

GL_INVALID_VALUE：level大于log 2 max，其中max是当目标是GL_TEXTURE_2D时GL_MAX_TEXTURE_SIZE的返回值，或者当目标不是GL_TEXTURE_2D时GL_MAX_CUBE_MAP_TEXTURE_SIZE

GL_INVALID_VALUE：当target是GL_TEXTURE_2D时GL_MAX_TEXTURE_SIZE的宽度或高度小于或大于GL_MAX_TEXTURE_SIZE。

GL_INVALID_VALUE：border不为0

GL_INVALID_VALUE：imageSize与指定的压缩图像数据的格式，尺寸和内容不一致

GL_INVALID_OPERATION：特定纹理压缩扩展中指定的特定压缩内部格式不支持参数组合

如果数据的编码方式与定义内部压缩格式的扩展规范不一致，则会生成未定义的结果，包括异常的程序终止。

相关Gets

glGet 参数GL_NUM_COMPRESSED_TEXTURE_FORMATS和GL_COMPRESSED_TEXTURE_FORMATS

glGet 参数GL_MAX_TEXTURE_SIZE或GL_MAX_CUBE_MAP_TEXTURE_SIZE

另见

glActiveTexture，glCompressedTexSubImage2D，glCopyTexImage2D，glCopyTexSubImage2D，glTexImage2D，glTexSubImage2D，glTexParameter

版权

https://www.khronos.org/registry/OpenGL-Refpages/es2.0/xhtml/glCompressedTexImage2D.xml

https://blog.csdn.net/flycatdeng

Copyright © 1991-2006 Silicon Graphics, Inc.本文档的许可是根据SGI Free Software B License.详见http://oss.sgi.com/projects/FreeB/.

Android,OpenGL ES,图形学