?/TD> |

Microsoft DirectX 9.0 |

Builds a left-handed orthogonal projection matrix.

Syntax

D3DXMATRIX *D3DXMatrixOrthoLH(

D3DXMATRIX *pOut, FLOATw, FLOATh, FLOATzn, FLOATzf);

Parameters

pOut- [in, out] Pointer to the D3DXMATRIX structure that contains the resulting matrix.
w- [in] Width of the view volume.
h- [in] Height of the view volume.
zn- [in] Minimum z-value of the view volume which is referred to as z-near.
zf- [in] Maximum z-value of the view volume which is referred to as z-far.

Return Value

Pointer to a

D3DXMATRIXstructure that is a 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

D3DXMatrixOrthoLHfunction 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

pOutparameter. In this way, theD3DXMatrixOrthoLHfunction can be used as a parameter for another function.This function uses the following formula to compute the returned matrix.

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

Function Information

Header d3dx9math.h Import library d3dx9.lib Minimum operating systems Windows 98

See Also

D3DXMatrixOrthoRH, D3DXMatrixOrthoOffCenterRH, D3DXMatrixOrthoOffCenterLH