DirectX SDK

D3DXQuaternionRotationYawPitchRoll

The D3DXQuaternionRotationYawPitchRoll function builds a quaternion with the given yaw, pitch, and roll.

D3DXQUATERNION* D3DXQuaternionRotationYawPitchRoll(
  D3DXQUATERNION* pOut,
  float yaw,
  float pitch,
  float roll
); 

Parameters

pOut
A pointer to the D3DXQUATERNION structure that is the result of the operation.
yaw
The yaw around the y-axis in radians.
pitch
The pitch around the x-axis in radians.
roll
The roll around the z-axis in radians.

Return Values

A pointer to a D3DXQUATERNION structure with the specified yaw, pitch, and roll.

Remarks

The return value for this function is the same value returned in the pOut parameter. In this way, the D3DXQuaternionRotationYawPitchRoll 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

D3DXQuaternionRotationAxis, D3DXQuaternionRotationMatrix