glFrustum fonction)

La fonction glFrustum multiplie la matrice actuelle par une matrice de perspective.

Syntaxe

void WINAPI glFrustum(
   GLdouble left,
   GLdouble right,
   GLdouble bottom,
   GLdouble top,
   GLdouble zNear,
   GLdouble zFar
);

Paramètres

gauche

Coordonnée du plan de découpage vertical gauche.

Oui

Coordonnée du plan de découpage vertical à droite.

ballon

Coordonnée du plan de découpage inférieur horizontal.

top

Coordonnée du plan de découpage inférieur horizontal.

zNear

Les distances par le plan de découpage près de profondeur. Doit être positif.

zFar

Distances avec les plans de découpage de profondeur lointaine. Doit être positif.

Valeur renvoyée

Cette fonction ne retourne pas de valeur.

Codes d’erreur

Les codes d’erreur suivants peuvent être récupérés par la fonction glGetError .

Nom Signification
_enum GL non valide _
zNear ou zFar n’était pas postitive.
_opération non valide du GL _
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Remarques

La fonction glFrustum décrit une matrice de perspective qui produit une projection de perspective. Les paramètres (gauche, bas, zNear) et (Right, Top, zNear) spécifient les points sur le plan de découpage proche qui sont mappés aux angles inférieur gauche et supérieur droit de la fenêtre, respectivement, en supposant que l’œil se trouve à (0, 0,0). Le paramètre zFar spécifie l’emplacement du plan de découpage Far. ZNear et zFar doivent être positifs. La matrice correspondante est présentée dans l’image suivante.

Diagramme montrant la matrice de perspective qui produit une projection de perspective.Équations présentant la fonction glFrustum qui décrit une matrice de perspective.

La fonction glFrustum multiplie la matrice actuelle par cette matrice, avec le résultat qui remplace la matrice actuelle. Autrement dit, si M est la matrice actuelle et que F est la matrice de perspective frustum, glFrustum remplace M par m F.

Utilisez glPushMatrix et glPopMatrix pour enregistrer et restaurer la pile de matrice actuelle.

La précision de la mémoire tampon de profondeur est affectée par les valeurs spécifiées pour zNear et zFar. Plus le rapport entre zFar et zNear est élevé, moins le tampon de profondeur est en effet à distinguer les surfaces proches les unes des autres. Si

Équation qui indique le rapport entre le haut et le bas.

le Journal 2 (r) bits de précision du tampon de profondeur est perdu. Étant donné que r approche l’infini comme zNear approche de zéro, vous ne devez jamais définir zNear à zéro.

Les fonctions suivantes récupèrent des informations sur glFrustum:

glGet avec l’argument _ mode de matrice GL _

glGet avec argument GL _ MODELVIEW _ Matrix

glGet avec argument _ matrice de projection de la comptabilité _

matrice de texture glGet avec argument GL _ _

Configuration requise

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

glEnd

glGet

glMatrixMode

glMultMatrix

glOrtho

glPopMatrix

glPushMatrix

glViewport