名称
glCompressedTexSubImage2D - 以压缩格式指定二维纹理子图像
C规范
void glCompressedTexSubImage2D( GLenum target,
GLint level,
GLint xoffset,
GLint yoffset,
GLsizei width,
GLsizei height,
GLenum format,
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缩小图像。
xoffset
指定纹理数组中x方向的纹素偏移。
yoffset
指定纹理数组内y方向的纹素偏移量。
width
指定纹理子图像的宽度。
height
指定纹理子图像的高度。
format
指定存储在地址数据中的压缩图像数据的格式。
imageSize
指定从data指定的地址开始的图像数据的无符号字节数。
data
指定指向内存中压缩图像数据的指针。
描述
纹理将指定纹理图像的一部分映射到纹理处于活动状态的每个图形基元上。当前片段着色器或顶点着色器使用内置纹理查找功能时,纹理处于活动状态。
glCompressedTexSubImage2D重新定义了现有二维纹理图像的连续子区域。数据引用的纹素将现有纹理数组的部分替换为x索引xoffset和xoffset + width - 1,以及y索引yoffset和yoffset + height - 1(包括0和yoffset)。该区域可能不包括纹理数组范围之外的任何纹素,如最初指定的那样。指定宽度为0的子纹理不是错误,但这样的规范没有效果。
format必须与glCompressedTexImage2D先前指定的扩展名指定的压缩纹理格式相同。
注意
glCompressedTexSubImage2D指定使用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:xoffset <0,xoffset + width> w,yoffset <0或yoffset + height> h,其中w是宽度,h是要修改的纹理图像的高度。
GL_INVALID_VALUE:宽度或高度小于0。
GL_INVALID_VALUE:imageSize与指定的压缩图像数据的格式,尺寸和内容不一致。
GL_INVALID_OPERATION:纹理数组尚未由之前的glCompressedTexImage2D操作定义,其内部格式与glCompressedTexSubImage2D的格式匹配。
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,glCompressedTexImage2D,glCopyTexImage2D,glCopyTexSubImage2D,glTexImage2D,glTexSubImage2D,glTexParameter
版权
https://www.khronos.org/registry/OpenGL-Refpages/es2.0/xhtml/glCompressedTexSubImage2D.xml
https://blog.csdn.net/flycatdeng
Copyright © 1991-2006 Silicon Graphics, Inc.本文档的许可是根据SGI Free Software B License.详见http://oss.sgi.com/projects/FreeB/.
![](https://i-blog.csdnimg.cn/blog_migrate/b61b18ac35ef755ca70fdb04fbb7539f.png)