Condividi tramite


funzione glDepthRange

La funzione glDepthRange specifica il mapping dei valori z dalle coordinate del dispositivo normalizzate alle coordinate della finestra.

Sintassi

void WINAPI glDepthRange(
   GLclampd zNear,
   GLclampd zFar
);

Parametri

zNear

Mapping del piano di ritaglio vicino alle coordinate della finestra. Il valore predefinito è zero.

zFar

Mapping del piano di ritaglio da lontano alle coordinate della finestra. Il valore predefinito è 1.

Valore restituito

Questa funzione non restituisce un valore.

Codici di errore

Il codice di errore seguente può essere recuperato dalla funzione glGetError .

Nome Significato
GL_INVALID_OPERATION
La funzione è stata chiamata tra una chiamata a glBegin e la chiamata corrispondente a glEnd.

Commenti

Dopo il ritaglio e la divisione per w, z -coordinate è compreso tra 0,0 e 1,0, corrispondente ai piani di ritaglio vicino e lontano. La funzione glDepthRange specifica un mapping lineare delle coordinate z normalizzate in questo intervallo alle coordinate z della finestra. Indipendentemente dall'implementazione effettiva del buffer di profondità, i valori di profondità delle coordinate della finestra vengono considerati come se fossero compresi tra 0,0 e 1,0 (ad esempio i componenti di colore). Pertanto, i valori accettati da glDepthRange sono entrambi bloccati a questo intervallo prima che vengano accettati.

Il mapping predefinito di (0,1) esegue il mapping del piano vicino a 0 e del piano lontano a 1. Con questo mapping, l'intervallo di buffer di profondità viene completamente utilizzato.

Non è necessario che zNear sia minore di zFar. I mapping inversi, ad esempio (1,0) sono accettabili.

La funzione seguente recupera le informazioni correlate a glDepthRange:

glGet con argomento GL_DEPTH_RANGE

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional [solo app desktop]
Server minimo supportato
Windows 2000 Server [solo app desktop]
Intestazione
Gl.h
Libreria
Opengl32.lib
DLL
Opengl32.dll

Vedi anche

glBegin

glDepthFunc

glEnd

glGet

glViewport