WebGL2RenderingContext: copyTexSubImage3D() method
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.
Note: This feature is available in Web Workers.
The WebGL2RenderingContext.copyTexSubImage3D() method of
the WebGL API copies pixels from the current
WebGLFramebuffer into an existing 3D texture sub-image.
Syntax
copyTexSubImage3D(target, level, xoffset, yoffset, zoffset, x, y, width, height)
Parameters
target-
A
GLenumspecifying the binding point (target) of the active texture. Possible values:gl.TEXTURE_3D: A three-dimensional texture.gl.TEXTURE_2D_ARRAY: A two-dimensional array texture.
level-
A
GLintspecifying the level of detail. Level 0 is the base image level and level n is the n-th mipmap reduction level. xoffset-
A
GLintspecifying the x offset within the texture image. yoffset-
A
GLintspecifying the y offset within the texture image. zoffset-
A
GLintspecifying the z offset within the texture image. x-
A
GLintspecifying the x coordinate of the lower left corner where to start copying. y-
A
GLintspecifying the y coordinate of the lower left corner where to start copying. width-
A
GLsizeispecifying the width of the texture. height-
A
GLsizeispecifying the height of the texture.
Return value
None (undefined).
Examples
gl.copyTexSubImage3D(gl.TEXTURE_3D, 0, 0, 0, 0, 0, 0, 16, 16);
Specifications
| Specification |
|---|
| WebGL 2.0 Specification # 3.7.6 |
Browser compatibility
BCD tables only load in the browser