GLES2.0中文API-glCompressedTexSubImage2D

名称

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：特定纹理压缩扩展中指定的特定压缩内部格式不支持参数组合。

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

另见

glActiveTexture，glCompressedTexImage2D，glCopyTexImage2D，glCopyTexSubImage2D，glTexImage2D，glTexSubImage2D，glTexParameter

版权

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

https://blog.csdn.net/flycatdeng

GLES2.0中文API-glCompressedTexSubImage2D相关推荐

GLES2.0中文API-glTexImage2D
名称 glTexImage2D- 指定一个二维的纹理图片 C规范 void glTexImage2D(GLenum target, GLint level, GLint internalformat, ...
GLES2.0中文API-glCopyTexImage2D
名称 glCopyTexImage2D - 将像素复制到2D纹理图像中 C规范 void glCopyTexImage2D( GLenum target, GLint level, ...
GLES2.0中文API-glCompressedTexImage2D
名称 glCompressedTexImage2D - 以压缩格式指定二维纹理图像 C规范 void glCompressedTexImage2D( GLenum target, GL ...
GLES2.0中文API-glUseProgram
名称 glUseProgram- 使用程序对象作为当前渲染状态的一部分 C规范 void glUseProgram(GLuint program); 参数 program 指定程序对象的句柄,该程序对 ...
GLES2.0中文API-glTexSubImage2D
名称 glTexSubImage2D - 指定二维纹理子图像 C规范 void glTexSubImage2D(GLenum target, GLint level, GLint xoffset, G ...
GLES2.0中文API-glGet
名称 glGet - 返回所选参数的值 C规范 void glGetBooleanv( GLenum pname, GLboolean * params); void glGetFlo ...
GLES2.0中文API-glUniform
名称 glUniform - 指定当前程序对象的统一变量的值 C规范 void glUniform1f( GLint location, GLfloat v0); void glUniform2 ...
GLES2.0中文API-glReadPixels
名称 glReadPixels - 从帧缓冲区中读取一个像素块 C规范 void glReadPixels(GLint x, GLint y, GLsizei width, GLsizei heigh ...
GLES2.0中文API-glGetActiveUniform
名称 glGetActiveUniform - 返回有关活动统一变量的信息 C规范 void glGetActiveUniform(GLuint program, GLuint index, GLsi ...

GLES2.0中文API-glCompressedTexSubImage2D

名称

C规范

参数

描述

注意

错误

相关Gets

另见

版权

GLES2.0中文API-glCompressedTexSubImage2D相关推荐

最新文章

热门文章