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
GL_INVALID_OPERATION	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	Gl.h
Bibliothek	Opengl32.lib
DLL	Opengl32.dll

Siehe auch

glBegin

glDepthFunc

glEnd

glGet

glViewport