D3DMXMatrixRotationYawPitchRoll

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function builds a matrix in floating point format that represents a yaw, pitch, and roll transformation.

Syntax

D3DMXMATRIX* WINAPI D3DMXMatrixRotationYawPitchRoll(
  D3DMXMATRIX* pOut,
  FLOAT        Yaw,
  FLOAT        Pitch,
  FLOAT        Roll
);

Parameters

• pOut
  [in, out] Pointer to the D3DMXMATRIX structure that is the result of the operation.

• Yaw
  [in] Yaw around the y-axis, in radians.

• Pitch
  [in] Pitch around the x-axis, in radians.

• Roll
  [in] Roll around the z-axis, in radians.

Return Value

Pointer to a D3DMXMATRIX 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 D3DMXMatrixRotationYawPitchRoll function can be used as a parameter for another function.

The order of transformations is roll first, then pitch, then yaw. Relative to the object's local coordinate axis, this is equivalent to rotation around the z-axis, followed by rotation around the x-axis, followed by rotation around the y-axis.

Requirements

See Also

Reference

D3DMX Functions
D3DMXMATRIX
D3DMXMatrixRotationYawPitchRollFxd