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
GL _ INVALID _ ENUM
mode war ein anderer Wert als GL _ SMOOTHT oder _ GL SMOOTH.
UNGÜLTIGER _ _ GL-VORGANG
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
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Siehe auch

glBegin

glColor

glEnd

glLight

glLightModel