WebGLRenderingContext: метод stencilFuncSeparate()

Метод WebGLRenderingContext.stencilFuncSeparate() из WebGL API устанавливает функцию и значение ссылки для тестирования штампов для передней и/или задней части.

Штампы позволяют включать и отключать отрисовку на основе каждого пикселя. Обычно они используются в многопроходной отрисовке для достижения специальных эффектов.

face

Значение типа GLenum, определяющее, обновляется ли состояние штампа для передней и/или задней части. Возможные значения:

• gl.FRONT
• gl.BACK
• gl.FRONT_AND_BACK

func

Значение типа GLenum, определяющее функцию тестирования. По умолчанию используется функция gl.ALWAYS. Возможные значения:

• gl.NEVER: Никогда не пропускать.
• gl.LESS: Пропустить, если (ref & mask) < (stencil & mask).
• gl.EQUAL: Пропустить, если (ref & mask) = (stencil & mask).
• gl.LEQUAL: Пропустить, если (ref & mask) <= (stencil & mask).
• gl.GREATER: Пропустить, если (ref & mask) > (stencil & mask).
• gl.NOTEQUAL: Пропустить, если (ref & mask) !== (stencil & mask).
• gl.GEQUAL: Пропустить, если (ref & mask) >= (stencil & mask).
• gl.ALWAYS: Всегда пропускать.

ref

Значение типа GLint, определяющее значение ссылки для тестирования штампов. Это значение ограничено диапазоном от 0 до 2^n - 1, где n — количество битовых плоскостей в буфере штампов. По умолчанию равно 0.

mask

Значение типа GLuint, определяющее битовую маску, которая используется для выполнения побитового И между значением ссылки и сохранённым значением штампа при выполнении теста. По умолчанию — все 1.

None (undefined).

Тестирование штампов отключено по умолчанию. Чтобы включить или отключить тестирование штампов, используйте методы enable() и disable() с аргументом gl.STENCIL_TEST.

gl.enable(gl.STENCIL_TEST);
gl.stencilFuncSeparate(gl.FRONT, gl.LESS, 0.2, 1110011);

Чтобы получить текущую функцию штампа, значение ссылки или другую информацию о штампе, обратитесь к соответствующим константам с помощью getParameter().

gl.getParameter(gl.STENCIL_FUNC);
gl.getParameter(gl.STENCIL_VALUE_MASK);
gl.getParameter(gl.STENCIL_REF);
gl.getParameter(gl.STENCIL_BACK_FUNC);
gl.getParameter(gl.STENCIL_BACK_VALUE_MASK);
gl.getParameter(gl.STENCIL_BACK_REF);
gl.getParameter(gl.STENCIL_BITS);

• WebGLRenderingContext.stencilFunc()
• WebGLRenderingContext.stencilMask()
• WebGLRenderingContext.stencilMaskSeparate()
• WebGLRenderingContext.stencilOp()
• WebGLRenderingContext.stencilOpSeparate()