Microsoft DirectX 8.1 (Visual Basic)

D3DXQuaternionExp

Calculates the exponential.

D3DXQuaternionExp( _ 
    QOut As D3DQUATERNION, _ 
    Q As D3DQUATERNION)

Parameters

QOut
D3DQUATERNION type that is the result of the operation, the exponential.
Q
The source D3DQUATERNION type.

Error Codes

If the function fails, an error is raised and Err.Number can be set to one of the following values.

D3DERR_INVALIDCALL
D3DERR_OUTOFVIDEOMEMORY

For information on trapping errors, see the Microsoft® Visual Basic® Error Handling topic.

Remarks

This method converts a pure quaternion to a unit quaternion. D3DXQuaternionExp expects a pure quaternion, where w is ignored in the calculation (w == 0).

Given a pure quaternion defined by:
q = (0, theta * v); 

This method calculates the exponential result.
exp(Q) = (cos(theta), sin(theta) * v)

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

The D3DXQuaternionSquadSetup method can also be used to set up the control points of a quaternion.

See Also

D3DXQuaternionLn, D3DXQuaternionSquad