D3DXMatrixOrthoLH-Funktion (D3DX10Math.h)

  • Artikel

Hinweis

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

Erstellt eine linkshändige orthographische Projektionsmatrix.

Syntax

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

Parameter

pOut [in, out]

Typ: D3DXMATRIX*

Zeiger auf die resultierende D3DXMATRIX.

w [in]

Typ: FLOAT

Breite des Ansichtsvolumes.

h [in]

Typ: FLOAT

Höhe des Ansichtsvolumens.

zn [in]

Typ: FLOAT

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

zf [in]

Typ: FLOAT

Maximaler z-Wert des Ansichtsvolumens, 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 Funktion D3DXMatrixOrthoLH 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/(zn-zf)  1

Anforderungen

Anforderung Wert
Header
D3DX10Math.h
Bibliothek
D3DX10.lib

Siehe auch

Mathematische Funktionen