The WebGL2RenderingContext.drawBuffers() method of the WebGL 2 API defines draw buffers to which fragment colors are written into. The draw buffer settings are part of the state of the currently bound framebuffer or the drawingbuffer if no framebuffer is bound.
On this page
WebGL2RenderingContext: drawBuffers() method
Syntax
js
drawBuffers(buffers)
Parameters
-
buffers -
An
ArrayofGLenumspecifying the buffers into which fragment colors will be written. Possible values are:-
gl.NONE -
Fragment shader output is not written into any color buffer.
-
gl.BACK -
Fragment shader output is written into the back color buffer.
-
gl.COLOR_ATTACHMENT{0-15} -
Fragment shader output is written in the nth color attachment of the current framebuffer.
-
Return value
None (undefined).
Exceptions
- If
bufferscontains not one of the accepted values, agl.INVALID_ENUMerror is thrown.
Examples
js
gl.drawBuffers([gl.NONE, gl.COLOR_ATTACHMENT1]);
Specifications
| Specification |
|---|
| WebGL 2.0 Specification # 3.7.11 |
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
drawBuffers |
56 | 79 | 51 | No | 43 | 15 | 58 | 58 | 51 | 43 | 15 | 7.0 |
See also
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WebGL2RenderingContext/drawBuffers