Quaternion.Multiply Method

Language:

Multiplies two quaternions.

Definition

Visual Basic Public Shared Function Multiply( _
    ByVal m1 As Quaternion, _
    ByVal m2 As Quaternion _
) As Quaternion

C# public static Quaternion Multiply(
    Quaternion m1,
    Quaternion m2
);

C++ public:
static Quaternion Multiply(
    Quaternion m1,
    Quaternion m2
);

JScript public static function Multiply(
    m1 : Quaternion,
    m2 : Quaternion
) : Quaternion;

Visual Basic	Public Shared Function Multiply( _ ByVal m1 As Quaternion, _ ByVal m2 As Quaternion _ ) As Quaternion
C#	public static Quaternion Multiply( Quaternion m1, Quaternion m2 );
C++	public: static Quaternion Multiply( Quaternion m1, Quaternion m2 );
JScript	public static function Multiply( m1 : Quaternion, m2 : Quaternion ) : Quaternion;

Parameters

m1 Microsoft.DirectX.Quaternion
Source Quaternion structure.

m2 Microsoft.DirectX.Quaternion
Source Quaternion structure.

Return Value

Microsoft.DirectX.Quaternion
A Quaternion structure that is the product of two quaternions.

Remarks

The result represents the rotation m1 followed by the rotation m2 (return value = m1 * m2). This is done so that Multiply maintains the same semantics as Matrix, because unit quaternions can be considered as another way of representing rotation matrices.

Transformations are concatenated in the same order for the Quaternion.Multiply and Matrix.Multiply methods. In the following C# code example, assuming that mX and mY represent the same rotations as qX and qY, both m and q represent the same rotations.
[C#]

m = Matrix.Multiply(mX, mY);

q = Quaternion.Multiply(qX, qY);
The multiplication of quaternions is not commutative; that is, the order in which they are multiplied is important.

m1	Microsoft.DirectX.Quaternion Source Quaternion structure.
m2	Microsoft.DirectX.Quaternion Source Quaternion structure.