glDepthRange-Funktion
Die glDepthRange-Funktion gibt die Zuordnung von z-Werten aus normalisierten Gerätekoordinaten zu Fensterkoordinaten an.
Syntax
void WINAPI glDepthRange(
GLclampd zNear,
GLclampd zFar
);
Parameter
-
zNear
-
Die Zuordnung der Nahausschnittsebene zu Fensterkoordinaten. Der Standardwert ist 0 (null).
-
zFar
-
Die Zuordnung der fernen Abschneideebene zu Fensterkoordinaten. Der Standardwert ist 1.
Rückgabewert
Diese Funktion gibt keinen Wert zurück.
Fehlercodes
Der folgende Fehlercode kann von der glGetError-Funktion abgerufen werden.
| Name | Bedeutung |
|---|---|
|
Die Funktion wurde zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen. |
Bemerkungen
Nach dem Clipping und division by w liegen die z-Koordinaten zwischen 0,0 und 1,0, was den nahen und fernen Abschneidebenen entspricht. Die glDepthRange-Funktion gibt eine lineare Zuordnung der normalisierten Z-Koordinaten in diesem Bereich zu Fenster-Z-Koordinaten an. Unabhängig von der tatsächlichen Tiefenpufferimplementierung werden Die Werte der Fensterkoordinatentiefe so behandelt, als ob sie zwischen 0,0 und 1,0 liegen (wie Farbkomponenten). Daher werden die von glDepthRange akzeptierten Werte beide an diesen Bereich geklemmt, bevor sie akzeptiert werden.
Die Standardzuordnung von (0,1) ordnet die nahe Ebene auf 0 und die ferne Ebene auf 1 zu. Mit dieser Zuordnung wird der Tiefenpufferbereich voll ausgelastet.
Es ist nicht erforderlich, dass zNear kleiner als zFar sein muss. Umgekehrte Zuordnungen wie (1,0) sind akzeptabel.
Die folgende Funktion ruft Informationen im Zusammenhang mit glDepthRange ab:
glGet mit Argument GL_DEPTH_RANGE
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 |
|