glFrontFace-Funktion

Die glFrontFace-Funktion definiert nach vorne und hinten gerichtete Polygone.

Syntax

void WINAPI glFrontFace(
   GLenum mode
);

Parameter

mode

Die Ausrichtung von nach vorne gerichteten Polygonen. GL_CW und GL_CCW werden akzeptiert. Der Standardwert ist GL_CCW.

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

In einer Szene, die vollständig aus undurchsichtigen geschlossenen Oberflächen besteht, sind nach hinten gerichtete Polygone nie sichtbar. Das Entfernen dieser unsichtbaren Polygone hat den offensichtlichen Vorteil, dass das Rendering des Bilds beschleunigt wird. Sie aktivieren und deaktivieren die Entfernung von rückwärts gerichteten Polygonen mit glEnable und glDisable mithilfe von Argumenten GL_CULL_FACE.

Die Projektion eines Polygons zu Fensterkoordinaten soll sich im Uhrzeigersinn winden, wenn ein imaginäres Objekt dem Pfad von seinem ersten Scheitelpunkt, seinem zweiten Scheitelpunkt usw. bis zum letzten Scheitelpunkt und schließlich wieder zurück zu seinem ersten Scheitelpunkt folgt, sich im Uhrzeigersinn um das Innere des Polygons bewegt. Die Wicklung des Polygons wird als gegen den Uhrzeigersinn bezeichnet, wenn sich das imaginäre Objekt, das demselben Pfad folgt, im Inneren des Polygons in einer Gegenbewegung gegen den Uhrzeigersinn bewegt. Die glFrontFace-Funktion gibt an, ob Polygone mit Wicklung im Uhrzeigersinn in Fensterkoordinaten oder gegen den Uhrzeigersinn in Fensterkoordinaten als frontseitig betrachtet werden. Wenn GL_CCW an den Modus übergeben wird, werden Polygone gegen den Uhrzeigersinn als frontseitig markiert; GL_CW wählt Polygone im Uhrzeigersinn als frontseitig aus. Standardmäßig werden Polygone gegen den Uhrzeigersinn als frontseitig betrachtet.

Die folgende Funktion ruft Informationen zu glFrontface ab:

glGet mit argument GL_FRONT_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

Weitere Informationen

glBegin

glCullFace

glDisable

glEnable

glEnd

glGet

glLightModel