Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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 D3DMXMATRIXstructure 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 D3DMXMATRIXstructure 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 D3DXMatrixOrthoOffCenterLHfunction 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, the D3DXMatrixOrthoOffCenterLHfunction can be used as a parameter for another function.

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

Copy Code 
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 d3dmx.h
Library D3dmx.lib
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also