Gl.Frustum (gb.opengl)

Multiplie la matrice courante par une matrice de perspective

Paramètres

left, right

Spécifient les coordonnées pour les plans de découpage (clipping) verticaux gauches et droits.

bottom, top

Spécifient les coordonnées pour les plans de découpage horizontaux bas et hauts.

nearVal, farVal

Spécifient les distances pour les plans de découpage proches et lointains. Ces deux distances doivent être positives.

Description

Gl.Frustum décrit une matrice qui produit une projection en perspective.
La matrice courante (voir Gl.MatrixMode) est multipliée par cette matrice et le résultat remplace la matrice en cours, comme si Gl.MultMatrix avait été appelé avec cette matrice comme argument :

$\left.[/\begin{array}{cccc}\frac{2\mathit{nearVal}}{\mathit{right}-\mathit{left}}& 0& \mathit{A}& 0\\ 0& \frac{2\mathit{nearVal}}{\mathit{top}-\mathit{bottom}}& \mathit{B}& 0\\ 0& 0& \mathit{C}& \mathit{D}\\ 0& 0& -1& 0\end{array}\right]$

Typiquement, le mode matriciel est Gl.PROJECTION, et $\left(\mathit{left},\mathit{bottom},-\mathit{nearVal}\right)$ et $\left(\mathit{right},\mathit{top},-\mathit{nearVal}\right)$ specifient les points sur le plan de découpage proche qui seront cartofraphiés vers les coins enbas à gauche et en haut à droite de la fenêtre, en supposant que le point de vue est situé en (0, 0, 0). $-\mathit{farVal}$ spécifient les points sur le plan de découpage proche qui sont cartographiés vers les coins inférieur gauche et supérieur droit de la fenêtre, en supposant que le point de vue est situé en (0, 0, 0). $-\mathit{farVal}$ spécifie la position du plan de découpage lointain. Near et far doivent être positifs.

Utilisez Gl.PushMatrix et Gl.PopMatrix pour sauvegarder et restaurer la pile de matrice courante.

Notes

La précision du tampon de profondeur (Depth) est affectée par les valeurs spécifiées pour nearVal et farVal. Plus le rapport de farVal à nearVal est grand, moins bonne sera l’efficacité du tampon de profondeur à distinguer entre deux surfaces proches l’une de l’autre. Si $\mathit{r}<code\; style="white-space:nowrap;"></code>\; <mfrac>\; <mi\; mathvariant="italic">farVal</mi>\; <mi\; mathvariant="italic">nearVal</mi>\; </mfrac>$

grossièrement ${\mathit{log}}_2\left(\mathit{r}\right)$ bits de précision du tampon de profondeur seront perdus. Comme $\mathit{r}$ tend vers l’infini quand nearVal s’approche de zéro, nearVal ne doit jamais être mis à zéro.

Erreurs

Gl.INVALID_VALUE est généré si nearVal ou farVal ne sont pas positifs, ou si left = right, ou bottom = top, ou near = far.

Gl.INVALID_OPERATION est généré si Gl.Frustum est exécuté entre un appel à Gl.Begin et l’appel correspondant à Gl.End.

Gets Associés

Gl.Get avec l’argument Gl.MATRIX_MODE

Gl.Get avec l’argument Gl.MODELVIEW_MATRIX

Gl.Get avec l’argument Gl.PROJECTION_MATRIX

Gl.Get avec l’argument Gl.TEXTURE_MATRIX

Gl.Get avec l’argument Gl.COLOR_MATRIX

Voir aussi

Voir la documentation originale sur le site OpenGL