Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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 D3DMXMATRIXstructure 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 D3DMXMATRIXstructure with the specified yaw, pitch, and roll.

Remarks

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

Header d3dmx.h
Library D3dmx.lib
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also