GLAPI/glStencilMask: Difference between revisions
4.0 API. |
JeffKhronos (talk | contribs) |
||
| (7 intermediate revisions by 2 users not shown) | |||
| Line 8: | Line 8: | ||
== Function Definition == | == Function Definition == | ||
void '''glStencilMask'''(GLuint | void '''glStencilMask'''(GLuint {{param|mask}}); | ||
; mask | ; mask | ||
| Line 15: | Line 15: | ||
== Description == | == Description == | ||
'''glStencilMask''' controls the writing of individual bits in the stencil planes. The least significant | '''glStencilMask''' controls the writing of individual bits in the stencil planes. The least significant ''n'' bits of {{param|mask}}, where ''n'' is the number of bits in the stencil buffer, specify a mask. Where a 1 appears in the mask, it's possible to write to the corresponding bit in the stencil buffer. Where a 0 appears, the corresponding bit is write-protected. Initially, all bits are enabled for writing. | ||
There can be two separate | There can be two separate {{param|mask}} writemasks; one affects back-facing polygons, and the other affects front-facing polygons as well as other non-polygon primitives. {{apifunc|glStencilMask}} sets both front and back stencil writemasks to the same values. Use {{apifunc|glStencilMaskSeparate}} to set front and back stencil writemasks to different values. | ||
== Notes == | == Notes == | ||
{{apifunc|glStencilMask}} is the same as calling {{apifunc|glStencilMaskSeparate}} with {{param|face}} set to {{enum|GL_FRONT_AND_BACK}}. | |||
== Associated Gets == | == Associated Gets == | ||
{{apifunc|glGet}} with argument {{enum|GL_STENCIL_WRITEMASK}}, {{enum|GL_STENCIL_BACK_WRITEMASK}}, or {{enum|GL_STENCIL_BITS}} | |||
== See Also == | == See Also == | ||
{{apifunc|glClear}}, {{apifunc|glClearBuffer}}, {{apifunc|glColorMask}}, {{apifunc|glDepthMask}}, {{apifunc|glStencilFunc}}, {{apifunc|glStencilFuncSeparate}}, {{apifunc|glStencilMaskSeparate}}, {{apifunc|glStencilOp}}, {{apifunc|glStencilOpSeparate}} | |||
== Copyright == | == Copyright == | ||
Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see [ | Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see [https://khronos.org/registry/OpenGL-Refpages/LICENSES/LicenseRef-FreeB.txt LicenseRef-FreeB]. | ||
[[Category:API Reference | [[Category:Core API Ref Whole Framebuffer|StencilMask]] | ||
[[Category:Core API Reference|StencilMask]] | |||
Latest revision as of 21:47, 5 February 2021
| Core in version | 4.6 | |
|---|---|---|
| Core since version | 1.0 | |
glStencilMask: control the front and back writing of individual bits in the stencil planes
Function Definition
void glStencilMask(GLuint mask);
- mask
- Specifies a bit mask to enable and disable writing of individual bits in the stencil planes. Initially, the mask is all 1's.
Description
glStencilMask controls the writing of individual bits in the stencil planes. The least significant n bits of mask, where n is the number of bits in the stencil buffer, specify a mask. Where a 1 appears in the mask, it's possible to write to the corresponding bit in the stencil buffer. Where a 0 appears, the corresponding bit is write-protected. Initially, all bits are enabled for writing.
There can be two separate mask writemasks; one affects back-facing polygons, and the other affects front-facing polygons as well as other non-polygon primitives. glStencilMask sets both front and back stencil writemasks to the same values. Use glStencilMaskSeparate to set front and back stencil writemasks to different values.
Notes
glStencilMask is the same as calling glStencilMaskSeparate with face set to GL_FRONT_AND_BACK.
Associated Gets
glGet with argument GL_STENCIL_WRITEMASK, GL_STENCIL_BACK_WRITEMASK, or GL_STENCIL_BITS
See Also
glClear, glClearBuffer, glColorMask, glDepthMask, glStencilFunc, glStencilFuncSeparate, glStencilMaskSeparate, glStencilOp, glStencilOpSeparate
Copyright
Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see LicenseRef-FreeB.