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 vorn gerichtete Polygone, GL BACK für nach hinten gerichtete Polygone oder GL FRONT AND BACK für polygone nach vorne und zurück _ _ _ _ _ sein.

mode

Die Art und Weise, wie Polygone rastert werden. Die folgenden Modi sind definiert und können im Modus angegeben werden. Der Standardwert ist GL _ FILL sowohl für front- als auch für back-facing polygons.

Wert Bedeutung
GL _ POINT
Polygonvertices, die als Anfang eines Begrenzungsrands gekennzeichnet sind, werden als Punkte gezeichnet. Punktattribute wie GL _ POINT SIZE und GL POINT SMOOTH steuern die _ _ _ Rasterung der Punkte. Andere Polygonrasterungsattribute als GL _ POLYGON MODE haben keine _ Auswirkungen.
GL _ LINE
Begrenzungsränder des Polygons werden als Liniensegmente gezeichnet. Sie werden als verbundene Liniensegmente für Zeilenausschnitte behandelt. Der Zeilenausschnittzähler und das Muster werden nicht zwischen Segmenten zurückgesetzt (siehe glLineStipple). Linienattribute wie GL _ LINE WIDTH und GL LINE SMOOTH steuern die _ _ _ Rasterung der Linien. Andere Polygonrasterungsattribute 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 face oder mode war kein akzeptierter Wert.
UNGÜLTIGER _ _ GL-VORGANG
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 Face-Parameter beschreibt, für welche Polygone der Modus gilt: Frontpolygone (GL FRONT), rückgesichtige Polygone _ (GL BACK) oder _ beides (GL _ FRONT UND _ _ BACK). Der Polygonmodus wirkt sich nur auf die endgültige Rasterung von Polygonen aus. Insbesondere werden die Scheitelungen eines Polygons beleuchtet, und das Polygon wird abgeschnitten und möglicherweise gecullt, bevor diese Modi angewendet werden.

Rufen Sie auf, um eine Oberfläche mit flächengefüllten, nach vorne gerichteten Polygonen und umrissenen Polygonen zu zeichnen.

glPolygonMode(GL _ FRONT, GL _ LINE);

Scheitelzeichen werden mit einem Edgeflag als begrenzungs- oder nicht eingehend gekennzeichnet. Edgeflags werden intern von OpenGL generiert, wenn Polygone zersetzt werden, und sie können explizit mit glEdgeFlag festgelegt werden.

Die folgende Funktion ruft Informationen im Zusammenhang mit glPolygonMode ab:

glGet mit Argument GL _ POLYGON _ MODE

Requirements (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

glEdgeFlag

glEnd

glLineStipple

glLineWidth

glPointSize

glPolygonStipple