Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
D3DXMatrixOrthoOffCenterLH
Collapse the table of content
Expand the table of content

D3DXMatrixOrthoOffCenterLH function

Builds a customized, left-handed orthographic projection matrix.

Syntax


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

Parameters

pOut [in, out]

Type: D3DXMATRIX*

Pointer to the resulting D3DXMATRIX.

l [in]

Type: FLOAT

Minimum x-value of view volume.

r [in]

Type: FLOAT

Maximum x-value of view volume.

b [in]

Type: FLOAT

Minimum y-value of view volume.

t [in]

Type: FLOAT

Maximum y-value of view volume.

zn [in]

Type: FLOAT

Minimum z-value of the view volume.

zf [in]

Type: FLOAT

Maximum z-value of the view volume.

Return value

Type: D3DXMATRIX*

Pointer to the resulting D3DXMATRIX.

Remarks

The D3DXMatrixOrthoLH function is a special case of the D3DXMatrixOrthoOffCenterLH function. To create the same projection using D3DXMatrixOrthoOffCenterLH, use the following values: l = -w/2, r = w/2, b = -h/2, and t = h/2.

All the parameters of the D3DXMatrixOrthoOffCenterLH function are distances in camera space. The parameters describe the dimensions of the view volume.

The return value for this function is the same value returned in the pOut parameter. In this way, the D3DXMatrixOrthoOffCenterLH function can be used as a parameter for another function.

This function uses the following formula to compute the returned matrix.



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


Requirements

Header

D3dx9math.h

Library

D3dx9.lib

See also

D3DXMatrixOrthoRH
D3DXMatrixOrthoLH
D3DXMatrixOrthoOffCenterRH

 

 

Community Additions

ADD
Show:
© 2015 Microsoft