GLES2.0中文API-glCopyTexImage2D

名称

glCopyTexImage2D - 将像素复制到2D纹理图像中

C规范

void glCopyTexImage2D(   GLenum target,
    GLint level,
    GLenum internalformat,
    GLint x,
    GLint y,
    GLsizei width,
    GLsizei height,
    GLint border);

参数

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

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

x，y

指定要复制的像素矩形区域左下角的窗口坐标。

width

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

height

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

border

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

描述

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

glCopyTexImage2D定义了二维纹理图像或立方体贴图纹理图像，其中包含来自当前帧缓冲区的像素（而不是来自客户端内存，如glTexImage2D的情况）。

屏幕对齐的像素矩形，左下角为（x，y），宽度为width，高度为height，定义了由level指定的mipmap级别的纹理数组。 internalformat指定纹理数组的内部格式。

处理矩形中的像素就像调用format设置为GL_RGBA的glReadPixels一样，但是在转换RGBA值之后，该过程就会停止。后续处理与glTexImage2D描述的处理相同，首先将R，G，B和A值截断到0 1范围，然后转换为纹理的内部格式以存储在纹素阵列中。

internalformat所需的组件必须是framebuffer格式中存在的组件的子集。例如，GL_RGBA帧缓冲区可用于为任何内部格式提供组件。但是，GL_RGB帧缓冲区只能用于为GL_RGB或GL_LUMINANCE基本内部格式纹理提供组件，而不能用于GL_ALPHA，GL_LUMINANCE_ALPHA或GL_RGBA纹理。

像素排序使得较低的x和y屏幕坐标对应于较低的s和t纹理坐标。

如果指定矩形内的任何像素位于与当前渲染上下文关联的帧缓冲区之外，则为这些像素获取的值未定义。

注意

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

高度或宽度为0的图像表示NULL纹理。

glCopyTexImage2D为使用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_INVALID_VALUE：target是六个立方体贴图2D图像目标之一并且width和height参数不相等。

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：border不为0。

GL_INVALID_OPERATION：当前绑定的帧缓冲区格式不包含internalformat基本格式所需组件的超集。

GL_INVALID_FRAMEBUFFER_OPERATION：当前绑定的帧缓冲不是帧缓冲完成（即glCheckFramebufferStatus的返回值不是GL_FRAMEBUFFER_COMPLETE）

另见

glActiveTexture，glCheckFramebufferStatus，glCompressedTexImage2D，glCompressedTexSubImage2D，

版权

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

https://blog.csdn.net/flycatdeng

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

GLES2.0中文API-glTexImage2D
名称 glTexImage2D- 指定一个二维的纹理图片 C规范 void glTexImage2D(GLenum target, GLint level, GLint internalformat, ...
GLES2.0中文API-glTexParameter
名称 glTexParameter - 设置纹理参数 C规范 void glTexParameterf(GLenum target,GLenum pname,GLfloat param); void ...
GLES2.0中文API-glCopyTexSubImage2D
名称 glCopyTexSubImage2D - 复制二维纹理子图像 C规范 void glCopyTexSubImage2D( GLenum target, GLint level ...
GLES2.0中文API-glBindFramebuffer
名称 glBindFramebuffer- 绑定一个命名的帧缓冲区对象 C规范 void glBindFramebuffer(GLenum target, GLuint framebuffer); 参 ...
GLES2.0中文API-glCompressedTexSubImage2D
名称 glCompressedTexSubImage2D - 以压缩格式指定二维纹理子图像 C规范 void glCompressedTexSubImage2D( GLenum target, ...
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-glCopyTexImage2D

名称

C规范

参数

描述

注意

错误

相关Gets

另见

版权

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

最新文章

热门文章