Fonction D3DXMatrixOrthoOffCenterLH (D3dx9math.h)

  • Article

Notes

La bibliothèque d’utilitaireS D3DX est déconseillée. Nous vous recommandons d’utiliser DirectXMath à la place.

Crée une matrice de projection orthographique gauche personnalisée.

Syntaxe

D3DXMATRIX* D3DXMatrixOrthoOffCenterLH(
  _Inout_ D3DXMATRIX *pOut,
  _In_    FLOAT      l,
  _In_    FLOAT      r,
  _In_    FLOAT      b,
  _In_    FLOAT      t,
  _In_    FLOAT      zn,
  _In_    FLOAT      zf
);

Paramètres

pOut [in, out]

Type : D3DXMATRIX*

Pointeur vers le D3DXMATRIX résultant.

l [in]

Type : FLOAT

Valeur x minimale du volume d’affichage.

r [in]

Type : FLOAT

Valeur x maximale du volume d’affichage.

b [in]

Type : FLOAT

Valeur y minimale du volume d’affichage.

t [in]

Type : FLOAT

Valeur y maximale du volume d’affichage.

zn [in]

Type : FLOAT

Valeur z minimale du volume d’affichage.

zf [in]

Type : FLOAT

Valeur z maximale du volume d’affichage.

Valeur retournée

Type : D3DXMATRIX*

Pointeur vers le D3DXMATRIX résultant.

Notes

La fonction D3DXMatrixOrthoLH est un cas particulier de la fonction D3DXMatrixOrthoOffCenterLH . Pour créer la même projection à l’aide de D3DXMatrixOrthoOffCenterLH, utilisez les valeurs suivantes : l = -w/2, r = w/2, b = -h/2 et t = h/2.

Tous les paramètres de la fonction D3DXMatrixOrthoOffCenterLH sont des distances dans l’espace de la caméra. Les paramètres décrivent les dimensions du volume d’affichage.

La valeur de retour de cette fonction est la même valeur retournée dans le paramètre pOut . De cette façon, la fonction D3DXMatrixOrthoOffCenterLH peut être utilisée comme paramètre pour une autre fonction.

Cette fonction utilise la formule suivante pour calculer la matrice retournée.

2/(r-l)      0            0           0
0            2/(t-b)      0           0
0            0            1/(zf-zn)   0
(l+r)/(l-r)  (t+b)/(b-t)  zn/(zn-zf)  1

Spécifications

Condition requise Valeur
En-tête
D3dx9math.h
Bibliothèque
D3dx9.lib

Voir aussi

Fonctions mathématiques

D3DXMatrixOrthoRH

D3DXMatrixOrthoLH

D3DXMatrixOrthoOffCenterRH