glHint-Funktion

Die glHint-Funktion gibt implementierungsspezifische Hinweise an.

Syntax

void WINAPI glHint(
   GLenum target,
   GLenum mode
);

Parameter

Ziel

Eine symbolische Konstante, die das zu steuernde Verhalten angibt. Die folgenden symbolischen Konstanten werden zusammen mit der vorgeschlagenen Semantik akzeptiert.

Wert	Bedeutung
GL_FOG_HINT	Gibt die Genauigkeit der Nebelberechnung an. Wenn die Berechnung von Nebel pro Pixel von der OpenGL-Implementierung nicht effizient unterstützt wird, können Hinweise GL_DONT_CARE oder GL_FASTEST zu einer Vertexberechnung von Nebeleffekten führen.
GL_LINE_SMOOTH_HINT	Gibt die Stichprobenqualität von antialiasierten Linien an. Hinweis GL_NICEST kann dazu führen, dass während der Rasterung mehr Pixelfragmente generiert werden, wenn eine größere Filterfunktion angewendet wird.
GL_PERSPECTIVE_CORRECTION_HINT	Gibt die Qualität der Farb- und Texturkoordinateninterpolation an. Wenn die perspektivisch korrigierte Parameterinterpolation von der OpenGL-Implementierung nicht effizient unterstützt wird, können Hinweise GL_DONT_CARE oder GL_FASTEST zu einer einfachen linearen Interpolation von Farben und/oder Texturkoordinaten führen.
GL_POINT_SMOOTH_HINT	Gibt die Stichprobenqualität von Antialiased-Punkten an. Hinweis GL_NICEST kann dazu führen, dass während der Rasterung mehr Pixelfragmente generiert werden, wenn eine größere Filterfunktion angewendet wird.
GL_POLYGON_SMOOTH_HINT	Gibt die Stichprobenqualität von Antialiased-Polygonen an. Hinweis GL_NICEST kann dazu führen, dass während der Rasterung mehr Pixelfragmente generiert werden, wenn eine größere Filterfunktion angewendet wird.

mode

Eine symbolische Konstante, die das gewünschte Verhalten angibt. Die folgenden symbolischen Konstanten werden akzeptiert.

Wert	Bedeutung
GL_FASTEST	Die effizienteste Option sollte gewählt werden.
GL_NICEST	Die richtige oder höchste Qualität sollte gewählt werden.
GL_DONT_CARE	Der Client hat keine Einstellung.

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	Ziel oder Modus war kein akzeptierter Wert.
GL_INVALID_OPERATION	Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen.

Bemerkungen

Wenn Raum für Interpretationen vorhanden ist, können Sie bestimmte Aspekte des OpenGL-Verhaltens mit Hinweisen steuern. Sie geben einen Hinweis mit zwei Argumenten an. Der Zielparameter ist eine symbolische Konstante, die das zu steuernde Verhalten angibt, und der Modus ist eine weitere symbolische Konstante, die das gewünschte Verhalten angibt.

Obwohl die Implementierungsaspekte, die angedeutet werden können, gut definiert sind, hängt die Interpretation der Hinweise von der Implementierung ab.

Die glHint-Funktion kann ignoriert werden.

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

glEnd