Función glDepthRange

La función glDepthRange especifica la asignación de valores z de coordenadas de dispositivo normalizadas a coordenadas de ventana.

Sintaxis

void WINAPI glDepthRange(
   GLclampd zNear,
   GLclampd zFar
);

Parámetros

zNear

Asignación del plano de recorte cercano a las coordenadas de la ventana. El valor predeterminado es cero.

zFar

Asignación del plano de recorte lejano a las coordenadas de la ventana. El valor predeterminado es 1.

Valor devuelto

Esta función no devuelve ningún valor.

Códigos de error

La función glGetError puede recuperar el siguiente código de error.

Nombre	Significado
GL_INVALID_OPERATION	Se llamó a la función entre una llamada a glBegin y la llamada correspondiente a glEnd.

Comentarios

Después de recortar y dividir por w, las coordenadas z oscilan entre 0,0 y 1,0, correspondientes a los planos de recorte cercanos y lejanos. La función glDepthRange especifica una asignación lineal de las coordenadas z normalizadas de este intervalo a las coordenadas z de la ventana. Independientemente de la implementación real del búfer de profundidad, los valores de profundidad de coordenadas de ventana se tratan como si oscilan entre 0,0 y 1,0 (como los componentes de color). Por lo tanto, los valores aceptados por glDepthRange se sujetan a este intervalo antes de que se acepten.

La asignación predeterminada de (0,1) asigna el plano cercano a 0 y el plano lejano a 1. Con esta asignación, el intervalo de búferes de profundidad se utiliza por completo.

No es necesario que zNear sea menor que zFar. Las asignaciones inversas, como (1,0) son aceptables.

La siguiente función recupera información relacionada con glDepthRange:

glGet con GL_DEPTH_RANGE de argumentos

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Gl.h
Biblioteca	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

glBegin

glDepthFunc

glEnd

glGet

glViewport