D3DXMatrixRotationYawPitchRoll
Microsoft DirectX 9.0 SDK Update (October 2004)

D3DXMatrixRotationYawPitchRoll Function


Builds a matrix with a specified yaw, pitch, and roll.

Syntax

D3DXMATRIX *WINAPI D3DXMatrixRotationYawPitchRoll(      

    D3DXMATRIX *pOut,     FLOAT Yaw,     FLOAT Pitch,     FLOAT Roll );

Parameters

pOut
[in, out] Pointer to the D3DXMATRIX 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 D3DXMATRIX 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 D3DXMatrixRotationYawPitchRoll 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.

Roll, pitch, yaw diagram

Function Information

Headerd3dx9math.h
Import libraryd3dx9.lib
Minimum operating systems Windows 98

See Also

D3DXMatrixRotationAxis, D3DXMatrixRotationQuaternion, D3DXMatrixRotationX, D3DXMatrixRotationY, D3DXMatrixRotationZ


© 2004 Microsoft Corporation. All rights reserved.
Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center.