GLAPI/glCullFace: Difference between revisions
< GLAPI
m Renaming category: 'API Reference 4' to 'Core API Reference'. |
JeffKhronos (talk | contribs) |
||
| (3 intermediate revisions by one other user not shown) | |||
| Line 8: | Line 8: | ||
== Function Definition == | == Function Definition == | ||
void '''glCullFace'''(GLenum | void '''glCullFace'''(GLenum {{param|mode}}); | ||
; mode | ; mode | ||
: Specifies whether front- or back-facing facets are candidates for culling. Symbolic constants {{ | : Specifies whether front- or back-facing facets are candidates for culling. Symbolic constants {{enum|GL_FRONT}}, {{enum|GL_BACK}}, and {{enum|GL_FRONT_AND_BACK}} are accepted. The initial value is {{enum|GL_BACK}}. | ||
== Description == | == Description == | ||
'''glCullFace''' specifies whether front- or back-facing facets are culled (as specified by ''mode'') when facet culling is enabled. Facet culling is initially disabled. To enable and disable facet culling, call the | '''glCullFace''' specifies whether front- or back-facing facets are culled (as specified by ''mode'') when facet culling is enabled. Facet culling is initially disabled. To enable and disable facet culling, call the {{apifunc|glEnable}} and {{apifunc|glDisable}} commands with the argument {{enum|GL_CULL_FACE}}. Facets include triangles, quadrilaterals, polygons, and rectangles. | ||
{{apifunc|glFrontFace}} specifies which of the clockwise and counterclockwise facets are front-facing and back-facing. See {{apifunc|glFrontFace}}. | |||
== Notes == | == Notes == | ||
If | If {{param|mode}} is {{enum|GL_FRONT_AND_BACK}}, no facets are drawn, but other primitives such as points and lines are drawn. | ||
== Errors == | == Errors == | ||
{{ | {{enum|GL_INVALID_ENUM}} is generated if {{param|mode}} is not an accepted value. | ||
== Associated Gets == | == Associated Gets == | ||
{{apifunc|glIsEnabled}} with argument {{enum|GL_CULL_FACE}} | |||
{{apifunc|glGet}} with argument {{enum|GL_CULL_FACE_MODE}} | |||
== See Also == | == See Also == | ||
{{apifunc|glEnable|(GL_CULL_FACE)}}, {{apifunc|glFrontFace}} | |||
== 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:Core API Ref Rasterization|CullFace]] | [[Category:Core API Ref Rasterization|CullFace]] | ||
[[Category:Core API Reference|CullFace]] | [[Category:Core API Reference|CullFace]] | ||
Latest revision as of 22:02, 5 February 2021
| Core in version | 4.6 | |
|---|---|---|
| Core since version | 1.0 | |
glCullFace: specify whether front- or back-facing facets can be culled
Function Definition
void glCullFace(GLenum mode);
- mode
- Specifies whether front- or back-facing facets are candidates for culling. Symbolic constants GL_FRONT, GL_BACK, and GL_FRONT_AND_BACK are accepted. The initial value is GL_BACK.
Description
glCullFace specifies whether front- or back-facing facets are culled (as specified by mode) when facet culling is enabled. Facet culling is initially disabled. To enable and disable facet culling, call the glEnable and glDisable commands with the argument GL_CULL_FACE. Facets include triangles, quadrilaterals, polygons, and rectangles.
glFrontFace specifies which of the clockwise and counterclockwise facets are front-facing and back-facing. See glFrontFace.
Notes
If mode is GL_FRONT_AND_BACK, no facets are drawn, but other primitives such as points and lines are drawn.
Errors
GL_INVALID_ENUM is generated if mode is not an accepted value.
Associated Gets
glIsEnabled with argument GL_CULL_FACE
glGet with argument GL_CULL_FACE_MODE
See Also
glEnable(GL_CULL_FACE), glFrontFace
Copyright
Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see LicenseRef-FreeB.