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）

相关Gets

glGet 参数GL_MAX_TEXTURE_SIZE或GL_MAX_CUBE_MAP_TEXTURE_SIZE

另见

glActiveTexture，glCheckFramebufferStatus，glCompressedTexImage2D，glCompressedTexSubImage2D，

版权

https://www.khronos.org/registry/OpenGL-Refpages/es2.0/xhtml/glCopyTexImage2D.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,图形学