Função glDepthRange

A função glDepthRange especifica o mapeamento de valores z de coordenadas de dispositivo normalizadas para coordenadas de janela.

Sintaxe

void WINAPI glDepthRange(
   GLclampd zNear,
   GLclampd zFar
);

Parâmetros

zNear

O mapeamento do plano de recorte próximo para as coordenadas da janela. O valor padrão é zero.

zFar

O mapeamento do plano de recorte distante para as coordenadas da janela. O valor padrão é 1.

Retornar valor

Essa função não retorna um valor.

Códigos de erro

O código de erro a seguir pode ser recuperado pela função glGetError .

Nome	Significado
GL_INVALID_OPERATION	A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd.

Comentários

Após o recorte e a divisão por w, as coordenadas z variam de 0,0 a 1,0, correspondentes aos planos de recorte próximos e distantes. A função glDepthRange especifica um mapeamento linear das coordenadas z normalizadas nesse intervalo para as coordenadas z da janela. Independentemente da implementação real do buffer de profundidade, os valores de profundidade da coordenada da janela são tratados como se variassem de 0,0 a 1,0 (como componentes de cor). Assim, os valores aceitos por glDepthRange são fixados nesse intervalo antes de serem aceitos.

O mapeamento padrão de (0,1) mapeia o plano próximo para 0 e o plano distante para 1. Com esse mapeamento, o intervalo de buffers de profundidade é totalmente utilizado.

Não é necessário que zNear seja menor que zFar. Mapeamentos reversos como (1,0) são aceitáveis.

A função a seguir recupera informações relacionadas a glDepthRange:

glGet com GL_DEPTH_RANGE de argumento

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Gl.h
Biblioteca	Opengl32.lib
DLL	Opengl32.dll

Confira também

glBegin

glDepthFunc

glEnd

glGet

glViewport