WebGLRenderingContext: copyTexSubImage2D() method
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Note: This feature is available inWeb Workers.
ThecopyTexSubImage2D() method of theWebGLRenderingContext interface of theWebGL API copies pixels from the currentWebGLFramebuffer into a 2D texture sub-image.
Syntax
copyTexSubImage2D(target, level, xoffset, yoffset, x, y, width, height)Parameters
targetA
GLenumspecifying the binding point (target) of the active texture. Possible values:gl.TEXTURE_2D: A two-dimensional texture.gl.TEXTURE_CUBE_MAP_POSITIVE_X: Positive X face for a cube-mapped texture.gl.TEXTURE_CUBE_MAP_NEGATIVE_X: Negative X face for a cube-mapped texture.gl.TEXTURE_CUBE_MAP_POSITIVE_Y: Positive Y face for a cube-mapped texture.gl.TEXTURE_CUBE_MAP_NEGATIVE_Y: Negative Y face for a cube-mapped texture.gl.TEXTURE_CUBE_MAP_POSITIVE_Z: Positive Z face for a cube-mapped texture.gl.TEXTURE_CUBE_MAP_NEGATIVE_Z: Negative Z face for a cube-mapped texture.
levelA
GLintspecifying the level of detail. Level 0 is the base image level and leveln is the n-th mipmap reduction level.xoffsetA
GLintspecifying the horizontal offset within the texture image.yoffsetA
GLintspecifying the vertical offset within the texture image.xA
GLintspecifying the x coordinate of the lower left corner where to start copying.yA
GLintspecifying the y coordinate of the lower left corner where to start copying.widthA
GLsizeispecifying the width of the texture in texels.heightA
GLsizeispecifying the height of the texture in texels.
Return value
None (undefined).
Examples
gl.copyTexSubImage2D(gl.TEXTURE_2D, 0, 0, 0, 0, 0, 16, 16);Specifications
| Specification |
|---|
| WebGL Specification # 5.14.8 |