fonction glDepthRange

La fonction glDepthRange spécifie le mappage des valeurs z des coordonnées d’appareil normalisées aux coordonnées de fenêtre.

Syntaxe

void WINAPI glDepthRange(
   GLclampd zNear,
   GLclampd zFar
);

Paramètres

zNear

Mappage du plan de découpage proche aux coordonnées de la fenêtre. La valeur par défaut est zéro.

zFar

Mappage du plan de découpage lointain aux coordonnées de fenêtre. La valeur par défaut est 1.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Codes d’erreur

Le code d’erreur suivant peut être récupéré par la fonction glGetError .

Nom	Signification
GL_INVALID_OPERATION	La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

Après découpage et division par w, les coordonnées z sont comprises entre 0,0 et 1,0, ce qui correspond aux plans de découpage proches et lointains. La fonction glDepthRange spécifie un mappage linéaire des coordonnées z normalisées de cette plage aux coordonnées z de fenêtre. Quelle que soit l’implémentation réelle de la mémoire tampon de profondeur, les valeurs de profondeur des coordonnées de fenêtre sont traitées comme si elles sont comprises entre 0,0 et 1,0 (comme les composants de couleur). Ainsi, les valeurs acceptées par glDepthRange sont toutes deux limitées à cette plage avant d’être acceptées.

Le mappage par défaut de (0,1) mappe le plan proche à 0 et le plan lointain à 1. Avec ce mappage, la plage de mémoires tampons de profondeur est entièrement utilisée.

Il n’est pas nécessaire que zNear soit inférieur à zFar. Les mappages inversés tels que (1,0) sont acceptables.

La fonction suivante récupère les informations relatives à glDepthRange :

glGet avec argument GL_DEPTH_RANGE

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Gl.h
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll

Voir aussi

glBegin

glDepthFunc

glEnd

glGet

glViewport