D3DXMatrixRotationQuaternion function (D3dx9math.h)

Note

The D3DX utility library is deprecated. We recommend that you use DirectXMath instead.

Builds a rotation matrix from a quaternion.

Syntax

D3DXMATRIX* D3DXMatrixRotationQuaternion(
  _Inout_       D3DXMATRIX     *pOut,
  _In_    const D3DXQUATERNION *pQ
);

Parameters

pOut [in, out]

Type: D3DXMATRIX*

Pointer to the D3DXMATRIX structure that is the result of the operation.

pQ [in]

Type: const D3DXQUATERNION*

Pointer to the source D3DXQUATERNION structure.

Return value

Type: D3DXMATRIX*

Pointer to a D3DXMATRIX structure built from the source quaternion.

Remarks

The return value for this function is the same value returned in the pOut parameter. In this way, the D3DXMatrixRotationQuaternion function can be used as a parameter for another function.

For information about how to calculate quaternion values from a direction vector ( x, y, z ) and an angle of rotation, see D3DXQUATERNION.

Requirements

Requirement Value
Header
D3dx9math.h
Library
D3dx9.lib

See also

Math Functions

D3DXMatrixRotationAxis

D3DXMatrixRotationX

D3DXMatrixRotationY

D3DXMatrixRotationYawPitchRoll

D3DXMatrixRotationZ