This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The WebGL2RenderingContext.framebufferTextureLayer()
method of the WebGL 2 API attaches a single layer of a texture to a framebuffer.
This method is similar to WebGLRenderingContext.framebufferTexture2D()
, but only a given single layer of the texture level is attached to the attachment point.
Syntax
void gl.framebufferTextureLayer(target, attachment, texture, level, layer);
Parameters
target
- A
GLenum
specifying the binding point (target). Possible values:gl.FRAMEBUFFER
: Collection buffer data storage of color, alpha, depth and stencil buffers used to render an image.gl.DRAW_FRAMEBUFFER
: Equivalent togl.FRAMEBUFFER
.gl.READ_FRAMEBUFFER
: Used as a source for reading operations.
attachment
- A
GLenum
specifying the attachment point for thetexture
. Possible values:gl.COLOR_ATTACHMENT{0-15}
: Attaches the texture to one of the framebuffer's color buffers.gl.DEPTH_ATTACHMENT
: Attaches the texture to the framebuffer's depth buffer.gl.STENCIL_ATTACHMENT
: Attaches the texture to the framebuffer's stencil buffer.gl.DEPTH_STENCIL_ATTACHMENT
: depth and stencil buffer.
texture
- A
WebGLTexture
object whose image to attach. level
- A
GLint
specifying the mipmap level of the texture image to attach. layer
- A
GLint
specifying the layer of the texture image to attach.
Return value
None.
Examples
gl.framebufferTextureLayer(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, texture, 0, 8);
Specifications
Specification | Status | Comment |
---|---|---|
WebGL 2.0 The definition of 'framebufferTextureLayer' in that specification. |
Editor's Draft | Initial definition for WebGL. |
OpenGL ES 3.0 The definition of 'glFramebufferTextureLayer' in that specification. |
Standard | Man page of the (similar) OpenGL API. |
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
framebufferTextureLayer | Chrome Full support 56 | Edge Full support 79 | Firefox Full support 51 | IE No support No | Opera Full support 43 | Safari No support No | WebView Android Full support 58 | Chrome Android Full support 58 | Firefox Android Full support 51 | Opera Android Full support 43 | Safari iOS No support No | Samsung Internet Android Full support 7.0 |
Legend
- Full support
- Full support
- No support
- No support