| description | ms.assetid | title | ms.topic | ms.date | topic_type | api_name | api_type | api_location | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
D3DXQuaternionLn function (D3DX10Math.h) - Calculates the natural logarithm. |
576cf676-bb42-45ec-8e45-4612a7cdb167 |
D3DXQuaternionLn function (D3DX10Math.h) |
reference |
05/31/2018 |
|
|
|
|
Note
The D3DX10 utility library is deprecated. We recommend that you use DirectXMath instead.
Calculates the natural logarithm.
D3DXQUATERNION* D3DXQuaternionLn(
_Inout_ D3DXQUATERNION *pOut,
_In_ const D3DXQUATERNION *pQ
);-
pOut [in, out]
-
Type: D3DXQUATERNION*
Pointer to the D3DXQUATERNION that is the result of the operation.
-
pQ [in]
-
Type: const D3DXQUATERNION*
Pointer to the source D3DXQUATERNION structure.
Type: D3DXQUATERNION*
Pointer to a D3DXQUATERNION structure that is the natural logarithm.
The D3DXQuaternionLn function works only for unit quaternions.
A unit quaternion, is defined by:
Q == (cos(theta), sin(theta) * v) where |v| = 1
The natural logarithm of Q is, ln(Q) = (0, theta * v)
The return value for this function is the same value returned in the pOut parameter. In this way, the D3DXQuaternionLn function can be used as a parameter for another function.
Use D3DXQuaternionNormalize for any quaternion input that is not already normalized.
| Requirement | Value |
|---|---|
| Header |
|
| Library |
|