D3DMXMatrixOrthoOffCenterLH

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function builds a customized, left-handed orthogonal projection matrix in floating point format.

Syntax

D3DMXMATRIX* WINAPI D3DMXMatrixOrthoOffCenterLH(
  D3DMXMATRIX* pOut,
  FLOAT        l,
  FLOAT        r,
  FLOAT        b,
  FLOAT        t,
  FLOAT        zn,
  FLOAT        zf
);

Parameters

• pOut
  [in, out] Pointer to the D3DMXMATRIX structure that is the result of the operation.

• l
  [in] Minimum x-value of view volume.

• r
  [in] Maximum x-value of view volume.

• b
  [in] Minimum y-value of view volume.

• t
  [in] Maximum y-value of view volume.

• zn
  [in] Minimum z-value of the view volume.

• zf
  [in] Maximum z-value of the view volume.

Return Value

Pointer to a D3DMXMATRIX structure that is a customized, left-handed orthogonal projection matrix.

Remarks

An orthogonal matrix is an invertible matrix for which the inverse of the matrix is equal to the transpose of the matrix.

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

See Also

Reference

D3DMX Functions
D3DMXMATRIX
D3DMXMatrixOrthoOffCenterLHFxd