glCullFace-Funktion

Die glCullFace-Funktion gibt an, ob frontseitige oder nach hinten gerichtete Facetten gekullt werden können.

Syntax

void WINAPI glCullFace(
   GLenum mode
);

Parameter

mode

Gibt an, ob gesichternde oder nach hinten gerichtete Facetten kandidaten für das Culling sind. Die symbolischen Konstanten GL_FRONT, GL_BACK und GL_FRONT_AND_BACK werden akzeptiert. Der Standardwert ist GL_BACK.

Rückgabewert

Diese Funktion gibt keinen Wert zurück.

Fehlercodes

Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.

Name	Bedeutung
GL_INVALID_ENUM	mode war kein akzeptierter Wert.
GL_INVALID_OPERATION	Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glCullFace-Funktion gibt an, ob frontseitige oder nach hinten gerichtete Facetten (wie im Modus angegeben) gekullt werden, wenn die Facet-Culling-Funktion aktiviert ist. Sie aktivieren und deaktivieren facet culling mithilfe von glEnable und glDisable mit dem Argument GL_CULL_FACE. Zu den Facetten gehören Dreiecke, Vierecks, Polygone und Rechtecke.

Die glFrontFace-Funktion gibt an, welche der Facetten im Uhrzeigersinn und gegen den Uhrzeigersinn nach vorne und nach hinten gerichtet sind.

Wenn der Modus GL_FRONT_AND_BACK ist, werden keine Facetten gezeichnet, aber andere Grundtypen wie Punkte und Linien werden gezeichnet.

Die folgenden Funktionen rufen Informationen im Zusammenhang mit glCullFace ab:

glGet mit argument GL_CULL_FACE_MODE

glIsEnabled mit Argument GL_CULL_FACE

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Gl.h
Bibliothek	Opengl32.lib
DLL	Opengl32.dll

Siehe auch

glBegin

glDisable

glEnable

glEnd

glFrontFace

glGet

glIsEnabled