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
GL _ INVALID _ OPERATION
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
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Weitere Informationen

glBegin

glDepthFunc

glEnd

glGet

glViewport