WebGLRenderingContext：copyTexImage2D() 方法

基线 广泛可用

此功能已得到良好建立，并且可在许多设备和浏览器版本上运行。自以下日期起，它已在各浏览器中可用： 2015 年 7 月.

WebGLRenderingContext.copyTexImage2D() 方法是 WebGL API 的一部分，它将当前 WebGLFramebuffer 中的像素复制到二维纹理图像中。

语法

js
copyTexImage2D(target, level, internalformat, x, y, width, height, border)

参数

target

指定活动纹理绑定点（目标）的 GLenum。可能的值

  • gl.TEXTURE_2D：二维纹理。
  • gl.TEXTURE_CUBE_MAP_POSITIVE_X：立方体贴图纹理的正 X 面。
  • gl.TEXTURE_CUBE_MAP_NEGATIVE_X：立方体贴图纹理的负 X 面。
  • gl.TEXTURE_CUBE_MAP_POSITIVE_Y：立方体贴图纹理的正 Y 面。
  • gl.TEXTURE_CUBE_MAP_NEGATIVE_Y：立方体贴图纹理的负 Y 面。
  • gl.TEXTURE_CUBE_MAP_POSITIVE_Z：立方体贴图纹理的正 Z 面。
  • gl.TEXTURE_CUBE_MAP_NEGATIVE_Z：立方体贴图纹理的负 Z 面。
level

指定详细程度的 GLint。级别 0 是基本图像级别，级别 n 是第 n 个 mipmap 缩减级别。

internalformat

指定纹理中颜色分量的 GLenum。可能的值

  • gl.ALPHA：丢弃红色、绿色和蓝色分量，并读取 alpha 分量。
  • gl.RGB：丢弃 alpha 分量，并读取红色、绿色和蓝色分量。
  • gl.RGBA：从颜色缓冲区读取红色、绿色、蓝色和 alpha 分量。
  • gl.LUMINANCE：每个颜色分量都是亮度分量，alpha 为 1.0。
  • gl.LUMINANCE_ALPHA：每个分量都是亮度/alpha 分量。
x

指定开始复制的左下角的 x 坐标的 GLint。

y

指定开始复制的左下角的 y 坐标的 GLint。

width

指定纹理宽度的 GLsizei。

height

指定纹理高度的 GLsizei。

border

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

返回值

无 (undefined)。

示例

js
gl.copyTexImage2D(gl.TEXTURE_2D, 0, gl.RGBA, 0, 0, 512, 512, 0);

规范

规范
WebGL 规范
# 5.14.8

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅