glShadeModel-Funktion
Die glShadeModel-Funktion wählt flache oder glatte Schattierung aus.
Syntax
void WINAPI glShadeModel(
GLenum mode
);
Parameter
-
mode
-
Ein symbolischer Wert, der eine Schattierungstechnik darstellt. Akzeptierte Werte werden GL_FLAT und GL_SMOOTH. Der Standardwert ist GL_SMOOTH.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Fehlercodes
Die folgenden Fehlercodes können von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
der Modus war ein anderer Wert als GL_GLAT oder GL_SMOOTH. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Bemerkungen
OpenGL-Grundtypen können entweder flache oder glatte Schattierung aufweisen. Die Standardeinstellung "Smooth Schatding" bewirkt, dass die berechneten Farben von Scheitelpunkten interpoliert werden, wenn das Grundelement gerastert wird. In der Regel werden jedem resultierenden Pixelfragment unterschiedliche Farben zugewiesen. Flat Schattierung wählt die berechnete Farbe von nur einem Scheitelpunkt aus und weist sie allen Pixelfragmenten zu, die durch Rastern eines einzelnen Grundtyps generiert werden. In beiden Fällen ist die berechnete Farbe eines Scheitelpunkts das Ergebnis der Beleuchtung, wenn die Beleuchtung aktiviert ist, oder es ist die aktuelle Farbe zum Zeitpunkt der Angabe des Scheitelpunkts, wenn die Beleuchtung deaktiviert ist.
Flache und glatte Schattierung sind für Punkte nicht zu unterscheiden. Beim Zählen von Scheitelpunkten und Grundtypen aus 1 erhält jedes flach schattierte Liniensegment i die berechnete Farbe von Vertex i + 1, seinem zweiten Scheitelpunkt. Jedes flach schattierte Polygon erhält die berechnete Farbe des Scheitelpunkts, der in der folgenden Tabelle aufgeführt ist. Dies ist der letzte Scheitelpunkt, der das Polygon in allen Fällen mit Ausnahme einzelner Polygone angibt, wobei der erste Scheitelpunkt die flach schattierte Farbe angibt.
| Primitiver Typ des Polygons i | Scheitelpunkt |
|---|---|
| Einzelnes Polygon (I=1) | 1 |
| Dreiecksstreifen | i + 2 |
| Dreieckslümung | i + 2 |
| Unabhängiges Dreieck | 3I |
| Quad-Streifen | 2i + 2 |
| Unabhängiges Quad | 4I |
Flache und glatte Schattierung werden von glShadeModel angegeben, wobei der Modus auf GL_FLAT bzw. GL_SMOOTH festgelegt ist.
Die folgende Funktion ruft Informationen im Zusammenhang mit glShadeModel ab:
glGet mit Argument GL_SHADE_MODEL
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 |
|