D3DXMatrixOrthoLH-Funktion (D3dx9math.h)

Hinweis

Die D3DX-Hilfsprogrammbibliothek ist veraltet. Es wird empfohlen, stattdessen DirectXMath zu verwenden.

Erstellt eine linkshändige orthografische Projektionsmatrix.

Syntax

D3DXMATRIX* D3DXMatrixOrthoLH(
  _Inout_ D3DXMATRIX *pOut,
  _In_    FLOAT      w,
  _In_    FLOAT      h,
  _In_    FLOAT      zn,
  _In_    FLOAT      zf
);

Parameter

pOut [ein, aus]

Typ: D3DXMATRIX*

Zeiger auf die resultierende D3DXMATRIX.

w [in]

Typ: FLOAT

Breite des Ansichtsvolumes.

h [in]

Typ: FLOAT

Höhe des Ansichtsvolumes.

zn [in]

Typ: FLOAT

Minimaler z-Wert des Ansichtsvolumes, das als z-near bezeichnet wird.

zf [in]

Typ: FLOAT

Maximaler z-Wert des Ansichtsvolumes, das als z-far bezeichnet wird.

Rückgabewert

Typ: D3DXMATRIX*

Zeiger auf die resultierende D3DXMATRIX.

Bemerkungen

Alle Parameter der D3DXMatrixOrthoLH-Funktion sind Entfernungen im Kameraraum. Die Parameter beschreiben die Dimensionen des Ansichtsvolumes.

Der Rückgabewert für diese Funktion ist derselbe Wert, der im pOut-Parameter zurückgegeben wird. Auf diese Weise kann die D3DXMatrixOrthoLH-Funktion als Parameter für eine andere Funktion verwendet werden.

Diese Funktion verwendet die folgende Formel, um die zurückgegebene Matrix zu berechnen.

2/w  0    0           0
0    2/h  0           0
0    0    1/(zf-zn)   0
0    0   -zn/(zf-zn)  1

Anforderungen

Anforderung Wert
Header
D3dx9math.h
Bibliothek
D3dx9.lib

Siehe auch

Mathematische Funktionen

D3DXMatrixOrthoRH

D3DXMatrixOrthoOffCenterRH

D3DXMatrixOrthoOffCenterLH