WebGLRenderingContext.clear()
Метод WebGLRenderingContext.clear()
из библиотеки WebGL API очищает буфер заданными значениями.
Заданные значения могут быть установлены clearColor()
, clearDepth()
(en-US) или clearStencil()
(en-US).
The scissor box, dithering, and buffer writemasks can affect the clear()
method.
Синтаксис
void gl.clear(mask);
Параметры
mask
-
Побитовая маска ИЛИ
GLbitfield
(en-US) указывает какие конкретно буферы нужно очистить. Возможные значения:gl.COLOR_BUFFER_BIT
gl.DEPTH_BUFFER_BIT
gl.STENCIL_BUFFER_BIT
Возвращаемое значение
Ничего.
Исключения
Если mask не является ни одним из перечисленных значений, то генерируется ошибка gl.INVALID_ENUM
.
Примеры
Метод clear()
принимает несколько значений.
js
gl.clear(gl.DEPTH_BUFFER_BIT);
gl.clear(gl.DEPTH_BUFFER_BIT | gl.COLOR_BUFFER_BIT);
Чтобы получить текущее значение очистки буфера, нужно воспользоваться следующими константами: COLOR_CLEAR_VALUE
, DEPTH_CLEAR_VALUE
, и STENCIL_CLEAR_VALUE
.
js
gl.getParameter(gl.COLOR_CLEAR_VALUE);
gl.getParameter(gl.DEPTH_CLEAR_VALUE);
gl.getParameter(gl.STENCIL_CLEAR_VALUE);
Спецификации
Specification |
---|
WebGL Specification # 5.14.11 |
Совместимость с браузерами
BCD tables only load in the browser