D3DMXMatrixPerspectiveOffCenterLHFxd (Windows Embedded CE 6.0)

1/6/2010

Builds a customized, left-handed perspective projection matrix in fixed point format.

Syntax

D3DMXMATRIXFXD* WINAPI D3DMXMatrixPerspectiveOffCenterLHFxd(
  D3DMXMATRIXFXD* pOut,
  FIXED           l,
  FIXED           r,
  FIXED           b,
  FIXED           t,
  FIXED           zn,
  FIXED           zf
);

Parameters

  • pOut
    [in, out] Pointer to the D3DMXMATRIXFXD structure that is the result of the operation.
  • l
    [in] Minimum x-value of the view volume.
  • r
    [in] Maximum x-value of the view volume.
  • b
    [in] Minimum y-value of the view volume.
  • t
    [in] Maximum y-value of the 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 D3DMXMATRIXFXD structure that is a customized, left-handed perspective projection matrix.

Remarks

All the parameters of the D3DMXMatrixPerspectiveOffCenterLHFxd 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 D3DMXMatrixPerspectiveOffCenterLHFxd function can be used as a parameter for another function.

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

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

Requirements

Header d3dmx.h
Library D3dmx.lib
Windows Embedded CE Windows Embedded CE 6.0 and later

See Also

Reference

D3DMX Functions
D3DMXMATRIXFXD
D3DMXMatrixPerspectiveOffCenterLH