GL_OES_stencil_wrap#

Supported Hardware#

Series5, Series5XT, Series6, Series6XE, Series6XT

Valid APIs#

OpenGL ES 1.x

Description#

Core OpenGL ES 1.0 stencil buffers require that when a value is incremented to the maximum value or decreased to the minimum, further operations will clamp that value. However, a number of algorithms use this buffer as a counter, calculating the difference between the total number of increments and the total number of decrements. This extension adds two new stencil operations: INCR_WRAP and DECR_WRAP. These allow the value to wrap round when the value changes and give more flexibility to the stencil buffer.

Note#

This extension is part of the OpenGL ES 1.x Extension Pack Specification and is core functionality in OpenGL ES 2.0 and 3.0.

Example#

// Change the stencil operations to decrease and wrap when failing the depth or stencil test,
// and increase and wrap when succeeding
glStencilOp(GL_DECR_WRAP, GL_DECR_WRAP, GL_INCR_WRAP);