Platform SDK: DirectX

D3DXVec3TransformCoord

The D3DXVec3TransformCoord function transforms a 3-D vector by a given matrix, projecting the result back into w = 1.

D3DXVECTOR3* D3DXVec3TransformCoord(
  D3DXVECTOR3* pOut,
  const D3DXVECTOR3* pV,
  const D3DXMATRIX* pM
); 

Parameters

pOut
A pointer to the D3DXVECTOR3 structure that is the result of the operation.
pV
A pointer to the source D3DXVECTOR3 structure.
pM
The pointer to the source D3DXMATRIX structure.

Return Values

A pointer to a D3DXVECTOR3 structure that is the transformed vector.

Remarks

This function transform the given vector, pV (x, y, z, 1), by the given matrix, pM, projecting the result back into w=1.

The return value for this function is the same value returned in the pOut parameter. In this way, the D3DXVec3TransformCoord 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.
  Version: Requires DirectX 7.0.
  Header: Declared in d3dxmath.h.
  Library: Use d3dx.lib.

See Also

D3DXVec3Transform, D3DXVec3TransformNormal