glShadeModel-Funktion
Die glShadeModel-Funktion wählt flache oder flache Schattierung aus.
Syntax
void WINAPI glShadeModel(
GLenum mode
);
Parameter
-
mode
-
Ein symbolischer Wert, der eine Schattierungstechnik darstellt. Akzeptierte Werte sind 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 |
|---|---|
|
mode war ein anderer Wert als GL _ SMOOTHT oder _ GL SMOOTH. |
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Hinweise
OpenGL-Primitive können entweder flache oder flache Schattierung haben. Die schattierte Schattierung (Standardeinstellung) bewirkt, dass die berechneten Farben von Scheitelpunkts interpoliert werden, während das Primitiv rastert, wodurch jedem resultierenden Pixelfragment in der Regel unterschiedliche Farben zugewiesen werden. Flache Schattierung wählt die berechnete Farbe nur eines Scheitelpunkts aus und weist sie allen Pixelfragmenten zu, die durch Rastern eines einzelnen Primitiven generiert werden. In beiden Fällen ist die berechnete Farbe eines Scheitelpunkts das Ergebnis der Beleuchtung, wenn die Beleuchtung aktiviert ist, oder die aktuelle Farbe zum Zeitpunkt der Angabe des Scheitelpunkts, wenn die Beleuchtung deaktiviert ist.
Flache und gleichmäßige Schattierung sind für Punkte nicht zu unterscheiden. Beim Zählen von Scheitelpunkte und Primitiven von 1 erhält jedes flach schattierte Liniensegment i ab der Zählung von glBegin die berechnete Farbe des Scheitelpunkts i + 1, seines zweiten Scheitelpunkts. Auf ähnliche Weise wird jedem flach schattierten Polygon die berechnete Farbe des scheitelpunkts in der folgenden Tabelle gegeben. 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 Polygontyp i | Scheitelpunkt |
|---|---|
| Einzelnes Polygon (I=1) | 1 |
| Dreiecksstreifen | i + 2 |
| Dreiecksfächer | i + 2 |
| Unabhängiges Dreieck | 3 I |
| Quad-Strip | 2 i + 2 |
| Unabhängiges Quad | 4 I |
Flache und gleichmäßige Schattierung werden von glShadeModel angegeben, und der Modus ist auf GL FLAT bzw. GL _ SMOOTH _ festgelegt.
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 |
|