DirectX SDK

D3DXMatrixLookAt

The D3DXMatrixLookAt function builds a right-handed, look-at matrix.

D3DXMATRIX* D3DXMatrixLookAt(
  D3DXMATRIX* pOut,
  const D3DXVECTOR3* pEye,
  const D3DXVECTOR3* pAt,
  const D3DXVECTOR3* pUp
); 

Parameters

pOut
A pointer to the D3DXMATRIX structure that is the result of the operation.
pEye
A pointer to the D3DXVECTOR3 structure that defines the eye point. This value is used in translation.
pAt
A pointer to the D3DXVECTOR3 structure that defines the camera look-at target.
pUp
A pointer to the D3DXVECTOR3 structure that defines the current world's up, usually [0, 1, 0].

Return Values

A pointer to a D3DXMATRIX structure that is a right-handed, look-at matrix.

Remarks

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

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Windows CE: Unsupported.
  Version: Requires DirectX 7.0.
  Header: Declared in d3dxmath.h.
  Library: Use d3dx.lib.

See Also

D3DXMatrixLookAtLH