D3DXMatrixOrthoOffCenterRH-Funktion (D3DX10Math.h)

  • Artikel

Hinweis

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

Erstellt eine angepasste, rechtshändige orthographische Projektionsmatrix.

Syntax

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

Parameter

pOut [in, out]

Typ: D3DXMATRIX*

Zeiger auf die resultierende D3DXMATRIX.

l [in]

Typ: FLOAT

Minimaler x-Wert des Ansichtsvolumens.

r [in]

Typ: FLOAT

Maximaler x-Wert des Ansichtsvolumens.

b [in]

Typ: FLOAT

Minimaler y-Wert des Ansichtsvolumens.

t [in]

Typ: FLOAT

Maximaler y-Wert des Ansichtsvolumens.

zn [in]

Typ: FLOAT

Minimaler Z-Wert des Ansichtsvolumens.

zf [in]

Typ: FLOAT

Maximaler Z-Wert des Ansichtsvolumens.

Rückgabewert

Typ: D3DXMATRIX*

Zeiger auf die resultierende D3DXMATRIX.

Bemerkungen

Die D3DXMatrixOrthoRH-Funktion ist ein Sonderfall der Funktion D3DXMatrixOrthoOffCenterRH. Verwenden Sie die folgenden Werte, um dieselbe Projektion mit D3DXMatrixOrthoOffCenterRH zu erstellen:

l = -w/2,

r = w/2,

b = -h/2 und

t = h/2.

Alle Parameter der D3DXMatrixOrthoOffCenterRH-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 D3DXMatrixOrthoOffCenterRH als Parameter für eine andere Funktion verwendet werden.

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

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

Anforderungen

Anforderung Wert
Header
D3DX10Math.h
Bibliothek
D3DX10.lib

Siehe auch

Mathematische Funktionen