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
GL_INVALID_ENUM	der Modus war ein anderer Wert als GL_GLAT oder GL_SMOOTH.
GL_INVALID_OPERATION	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	Gl.h
Bibliothek	Opengl32.lib
DLL	Opengl32.dll

Siehe auch

glBegin

glColor

glEnd

glLight

glLightModel