WebGLRenderingContext: clear() 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 in Web Workers.
The WebGLRenderingContext.clear() method of the WebGL API clears buffers to preset values.
The preset values can be set by clearColor(), clearDepth() or clearStencil().
The scissor box, dithering, and buffer writemasks can affect the clear() method. For example, if buffer writing is disabled via colorMask(), depthMask(), or stencilMask(), clear() has no effect on the corresponding buffer.
Syntax
clear(mask)
Parameters
mask-
A
GLbitfieldbitwise OR mask that indicates the buffers to be cleared. Possible values are:gl.COLOR_BUFFER_BITgl.DEPTH_BUFFER_BITgl.STENCIL_BUFFER_BIT
Return value
None (undefined).
Exceptions
If mask is not one of the listed possible values, a
gl.INVALID_ENUM error is thrown.
Examples
The clear() method accepts multiple values.
gl.clear(gl.DEPTH_BUFFER_BIT);
gl.clear(gl.DEPTH_BUFFER_BIT | gl.COLOR_BUFFER_BIT);
To get the current clear values, query the COLOR_CLEAR_VALUE,
DEPTH_CLEAR_VALUE, and STENCIL_CLEAR_VALUE constants.
gl.getParameter(gl.COLOR_CLEAR_VALUE);
gl.getParameter(gl.DEPTH_CLEAR_VALUE);
gl.getParameter(gl.STENCIL_CLEAR_VALUE);
Specifications
| Specification |
|---|
| WebGL Specification # 5.14.11 |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
clear
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support