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 |
|---|---|
|
Entweder die Gesichtserkennung oder der Modus war kein akzeptierter Wert. |
|
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 |
|
| Bibliothek |
|
| DLL |
|