glPolygonMode-Funktion

Die glPolygonMode-Funktion wählt einen Polygonrastermodus aus.

Syntax

void WINAPI glPolygonMode(
   GLenum face,
   GLenum mode
);

Parameter

Gesicht

Die Polygone, für die der Modus gilt. Muss GL_FRONT für nach vorne gerichtete Polygone, GL_BACK für hintere Polygone oder GL_FRONT_AND_BACK für nach vorne und hinten ausgerichtete Polygone sein.

mode

Die Art und Weise, wie Polygone gerastert werden. Die folgenden Modi sind definiert und können im Modus angegeben werden. Die Standardeinstellung ist GL_FILL sowohl für front- als auch nach hinten ausgerichtete Polygone.

Wert	Bedeutung
GL_POINT	Polygonvertices, die als Anfang einer Begrenzungskante markiert sind, werden als Punkte gezeichnet. Punktattribute wie GL_POINT_SIZE und GL_POINT_SMOOTH steuern die Rasterung der Punkte. Andere Polygonrasterattribute als GL_POLYGON_MODE haben keine Auswirkungen.
GL_LINE	Begrenzungsränder des Polygons werden als Liniensegmente gezeichnet. Sie werden als verbundene Leitungssegmente für die Leitungsstippung behandelt; Der Linienstipplezähler und das Muster werden zwischen Segmenten nicht zurückgesetzt (siehe glLineStipple). Linienattribute wie GL_LINE_WIDTH und GL_LINE_SMOOTH steuern die Rasterung der Linien. Andere Polygonrasterattribute als GL_POLYGON_MODE haben keine Auswirkungen.
GL_FILL	Das Innere des Polygons ist gefüllt. Polygonattribute wie GL_POLYGON_STIPPLE und GL_POLYGON_SMOOTH steuern die Rasterung des Polygons.

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	Entweder die Gesichtserkennung oder der Modus war kein akzeptierter Wert.
GL_INVALID_OPERATION	Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Die glPolygonMode-Funktion steuert die Interpretation von Polygonen für die Rasterung. Der Gesichtserkennungsparameter beschreibt, für welchen Polygonmodus gilt: nach vorne gerichtete Polygone (GL_FRONT), nach hinten gerichtete Polygone (GL_BACK) oder beides (GL_FRONT_AND_BACK). Der Polygonmodus wirkt sich nur auf die endgültige Rasterung von Polygonen aus. Insbesondere werden die Scheitelpunkte eines Polygons beleuchtet, und das Polygon wird abgeschnitten und möglicherweise gekullt, bevor diese Modi angewendet werden.

Rufen Sie auf, um eine Oberfläche mit ausgefüllten nach hinten gerichteten Polygonen und konturierten Polygonen nach vorne zu zeichnen.

glPolygonMode(GL_FRONT, GL_LINE);

Scheitelpunkte werden als Grenze oder nicht grenzenhaft mit einem Edgeflag markiert. Edgeflags werden intern von OpenGL generiert, wenn Polygone zerlegt werden, und sie können explizit mithilfe von glEdgeFlag festgelegt werden.

Die folgende Funktion ruft Informationen im Zusammenhang mit glPolygonMode ab:

glGet mit argument GL_POLYGON_MODE

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

glEdgeFlag

glEnd

glLineStipple

glLineWidth

glPointSize

glPolygonStipple