Spec-Zone.ru › Web APIs

WebGLRenderingContext: метод clear()

Базовая Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна во всех браузерах с июля 2015 года.

  • Подробнее
  • Полная совместимость
  • Отправить отзыв

Примечание: Эта функция доступна в Потоках веб-работ.

Метод WebGLRenderingContext.clear() API WebGL очищает буферы до предопределённых значений.

Предопределённые значения могут быть установлены с помощью clearColor(), clearDepth() или clearStencil().

Область обрезки, дithering и маски записи буфера могут повлиять на работу метода clear().

Синтаксис

clear(mask)

Параметры

mask

Побитовая маска, указывающая буферы, которые необходимо очистить. Возможные значения:

  • gl.COLOR_BUFFER_BIT
  • gl.DEPTH_BUFFER_BIT
  • gl.STENCIL_BUFFER_BIT

Возвращаемое значение

Ничего (undefined).

Исключения

Если mask не соответствует одному из перечисленных значений, будет брошено исключение gl.INVALID_ENUM.

Примеры

Метод clear() принимает несколько значений.

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.

gl.getParameter(gl.COLOR_CLEAR_VALUE);
gl.getParameter(gl.DEPTH_CLEAR_VALUE);
gl.getParameter(gl.STENCIL_CLEAR_VALUE);

Спецификации

Спецификация
Спецификация WebGL
# 5.14.11

Совместимость с браузерами

Рабочие столы Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android
clear 9 12 4 12 5.1 25 4 12 8 1.5 4.4.3

См. также

  • WebGLRenderingContext.clearColor()
  • WebGLRenderingContext.clearDepth()
  • WebGLRenderingContext.clearStencil()

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/WebGLRenderingContext/clear

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API