glDepthRange-Funktion
Die glDepthRange-Funktion gibt die Zuordnung von Z-Werten von normalisierten Gerätekoordinaten zu Fensterkoordinaten an.
Syntax
void WINAPI glDepthRange(
GLclampd zNear,
GLclampd zFar
);
Parameter
-
zNear
-
Die Zuordnung der Nahezu-Clippingebene zu Fensterkoordinaten. Der Standardwert ist 0 (null).
-
zFar
-
Die Zuordnung der fernen Clippingebene 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 glEndaufgerufen. |
Bemerkungen
Nach dem Clipping und der Division durch w liegen die Z-Koordinaten zwischen 0,0 und 1,0, was den mittleren und fernen Clippingebenen entspricht. Die glDepthRange-Funktion gibt eine lineare Zuordnung der normalisierten z-Koordinaten in diesem Bereich zum Fenster z-coordinates an. Unabhängig von der tatsächlichen Implementierung des Tiefenpuffers werden Die Tiefenwerte der Fensterkoordinaten so behandelt, als ob sie zwischen 0,0 und 1,0 liegen (z. B. Farbkomponenten). Daher werden die von glDepthRange akzeptierten Werte an diesen Bereich gebunden, bevor sie akzeptiert werden.
Die Standardzuordnung von (0,1) ordnet die Nahebene 0 und die ferne Ebene 1 zu. Mit dieser Zuordnung wird der Tiefenpufferbereich vollständig ausgelastet.
Es ist nicht erforderlich, dass zNear kleiner als zFar ist. Umgekehrte Zuordnungen wie (1,0) sind akzeptabel.
Die folgende Funktion ruft Informationen im Zusammenhang mit glDepthRange ab:
glGet mit argument GL _ DEPTH _ RANGE
Requirements (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 |
|