Spec-Zone.ru › Web APIs

WebGLRenderingContext: метод scissor()

Базовая линия Широко поддерживается

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

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

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

Метод WebGLRenderingContext.scissor() API WebGL устанавливает область обрезки, которая ограничивает отрисовку заданным прямоугольником.

Синтаксис

scissor(x, y, width, height)

Параметры

x

Значение GLint, определяющее горизонтальную координату левого нижнего угла прямоугольника. Значение по умолчанию: 0.

y

Значение GLint, определяющее вертикальную координату левого нижнего угла прямоугольника. Значение по умолчанию: 0.

width

Неотрицательное значение GLsizei, определяющее ширину области обрезки. Значение по умолчанию: ширина холста.

height

Неотрицательное значение GLsizei, определяющее высоту области обрезки. Значение по умолчанию: высота холста.

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

None (undefined).

Исключения

Если width или height имеют отрицательное значение, выбрасывается ошибка gl.INVALID_VALUE.

Примеры

При включенном тесте обрезки, командами отрисовки могут быть изменены только пиксели, находящиеся внутри области обрезки.

// turn on scissor test
gl.enable(gl.SCISSOR_TEST);

// set the scissor rectangle
gl.scissor(x, y, width, height);

// execute drawing commands in the scissor box (e.g. clear)

// turn off scissor test again
gl.disable(gl.SCISSOR_TEST);

Чтобы получить текущие размеры области обрезки, запросите константу SCISSOR_BOX, которая возвращает Int32Array.

gl.scissor(0, 0, 200, 200);
gl.getParameter(gl.SCISSOR_BOX);
// Int32Array[0, 0, 200, 200]

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

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

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

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

См. также

  • WebGLRenderingContext.viewport()
  • WebGLRenderingContext.enable()
  • WebGLRenderingContext.disable()

© 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/scissor

Spec-Zone.ru

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