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