Struct lnkit::prelude::DualQuaternion[][src]

#[repr(C)]
pub struct DualQuaternion<T> where
    T: Scalar
{ pub real: Quaternion<T>, pub dual: Quaternion<T>, }

A dual quaternion.

Indexing

DualQuaternions are stored as [..real, ..dual]. Both of the quaternion components are laid out in i, j, k, w order.


let real = Quaternion::new(1.0, 2.0, 3.0, 4.0);
let dual = Quaternion::new(5.0, 6.0, 7.0, 8.0);

let dq = DualQuaternion::from_real_and_dual(real, dual);
assert_eq!(dq[0], 2.0);
assert_eq!(dq[1], 3.0);

assert_eq!(dq[4], 6.0);
assert_eq!(dq[7], 5.0);

NOTE: As of December 2020, dual quaternion support is a work in progress. If a feature that you need is missing, feel free to open an issue or a PR. See https://github.com/dimforge/nalgebra/issues/487

Fields

real: Quaternion<T>

The real component of the quaternion

dual: Quaternion<T>

The dual component of the quaternion

Implementations

impl<T> DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

#[must_use = "Did you mean to use normalize_mut()?"]
pub fn normalize(&self) -> DualQuaternion<T>
[src]

Normalizes this quaternion.

Example

let real = Quaternion::new(1.0, 2.0, 3.0, 4.0);
let dual = Quaternion::new(5.0, 6.0, 7.0, 8.0);
let dq = DualQuaternion::from_real_and_dual(real, dual);

let dq_normalized = dq.normalize();

relative_eq!(dq_normalized.real.norm(), 1.0);

pub fn normalize_mut(&mut self) -> T[src]

Normalizes this quaternion.

Example

let real = Quaternion::new(1.0, 2.0, 3.0, 4.0);
let dual = Quaternion::new(5.0, 6.0, 7.0, 8.0);
let mut dq = DualQuaternion::from_real_and_dual(real, dual);

dq.normalize_mut();

relative_eq!(dq.real.norm(), 1.0);

#[must_use = "Did you mean to use conjugate_mut()?"]
pub fn conjugate(&self) -> DualQuaternion<T>
[src]

The conjugate of this dual quaternion, containing the conjugate of the real and imaginary parts..

Example

let real = Quaternion::new(1.0, 2.0, 3.0, 4.0);
let dual = Quaternion::new(5.0, 6.0, 7.0, 8.0);
let dq = DualQuaternion::from_real_and_dual(real, dual);

let conj = dq.conjugate();
assert!(conj.real.i == -2.0 && conj.real.j == -3.0 && conj.real.k == -4.0);
assert!(conj.real.w == 1.0);
assert!(conj.dual.i == -6.0 && conj.dual.j == -7.0 && conj.dual.k == -8.0);
assert!(conj.dual.w == 5.0);

pub fn conjugate_mut(&mut self)[src]

Replaces this quaternion by its conjugate.

Example

let real = Quaternion::new(1.0, 2.0, 3.0, 4.0);
let dual = Quaternion::new(5.0, 6.0, 7.0, 8.0);
let mut dq = DualQuaternion::from_real_and_dual(real, dual);

dq.conjugate_mut();
assert!(dq.real.i == -2.0 && dq.real.j == -3.0 && dq.real.k == -4.0);
assert!(dq.real.w == 1.0);
assert!(dq.dual.i == -6.0 && dq.dual.j == -7.0 && dq.dual.k == -8.0);
assert!(dq.dual.w == 5.0);

#[must_use = "Did you mean to use try_inverse_mut()?"]
pub fn try_inverse(&self) -> Option<DualQuaternion<T>> where
    T: RealField
[src]

Inverts this dual quaternion if it is not zero.

Example

let real = Quaternion::new(1.0, 2.0, 3.0, 4.0);
let dual = Quaternion::new(5.0, 6.0, 7.0, 8.0);
let dq = DualQuaternion::from_real_and_dual(real, dual);
let inverse = dq.try_inverse();

assert!(inverse.is_some());
assert_relative_eq!(inverse.unwrap() * dq, DualQuaternion::identity());

//Non-invertible case
let zero = Quaternion::new(0.0, 0.0, 0.0, 0.0);
let dq = DualQuaternion::from_real_and_dual(zero, zero);
let inverse = dq.try_inverse();

assert!(inverse.is_none());

pub fn try_inverse_mut(&mut self) -> bool where
    T: RealField
[src]

Inverts this dual quaternion in-place if it is not zero.

Example

let real = Quaternion::new(1.0, 2.0, 3.0, 4.0);
let dual = Quaternion::new(5.0, 6.0, 7.0, 8.0);
let dq = DualQuaternion::from_real_and_dual(real, dual);
let mut dq_inverse = dq;
dq_inverse.try_inverse_mut();

assert_relative_eq!(dq_inverse * dq, DualQuaternion::identity());

//Non-invertible case
let zero = Quaternion::new(0.0, 0.0, 0.0, 0.0);
let mut dq = DualQuaternion::from_real_and_dual(zero, zero);
assert!(!dq.try_inverse_mut());

pub fn lerp(&self, other: &DualQuaternion<T>, t: T) -> DualQuaternion<T>[src]

Linear interpolation between two dual quaternions.

Computes self * (1 - t) + other * t.

Example

let dq1 = DualQuaternion::from_real_and_dual(
    Quaternion::new(1.0, 0.0, 0.0, 4.0),
    Quaternion::new(0.0, 2.0, 0.0, 0.0)
);
let dq2 = DualQuaternion::from_real_and_dual(
    Quaternion::new(2.0, 0.0, 1.0, 0.0),
    Quaternion::new(0.0, 2.0, 0.0, 0.0)
);
assert_eq!(dq1.lerp(&dq2, 0.25), DualQuaternion::from_real_and_dual(
    Quaternion::new(1.25, 0.0, 0.25, 3.0),
    Quaternion::new(0.0, 2.0, 0.0, 0.0)
));

impl<T> DualQuaternion<T> where
    T: Scalar
[src]

pub fn from_real_and_dual(
    real: Quaternion<T>,
    dual: Quaternion<T>
) -> DualQuaternion<T>
[src]

Creates a dual quaternion from its rotation and translation components.

Example

let rot = Quaternion::new(1.0, 2.0, 3.0, 4.0);
let trans = Quaternion::new(5.0, 6.0, 7.0, 8.0);

let dq = DualQuaternion::from_real_and_dual(rot, trans);
assert_eq!(dq.real.w, 1.0);

pub fn identity() -> DualQuaternion<T> where
    T: SimdRealField
[src]

The dual quaternion multiplicative identity.

Example


let dq1 = DualQuaternion::identity();
let dq2 = DualQuaternion::from_real_and_dual(
    Quaternion::new(1.,2.,3.,4.),
    Quaternion::new(5.,6.,7.,8.)
);

assert_eq!(dq1 * dq2, dq2);
assert_eq!(dq2 * dq1, dq2);

pub fn cast<To>(self) -> DualQuaternion<To> where
    To: Scalar,
    DualQuaternion<To>: SupersetOf<DualQuaternion<T>>, 
[src]

Cast the components of self to another type.

Example

let q = DualQuaternion::from_real(Quaternion::new(1.0f64, 2.0, 3.0, 4.0));
let q2 = q.cast::<f32>();
assert_eq!(q2, DualQuaternion::from_real(Quaternion::new(1.0f32, 2.0, 3.0, 4.0)));

impl<T> DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

pub fn from_real(real: Quaternion<T>) -> DualQuaternion<T>[src]

Creates a dual quaternion from only its real part, with no translation component.

Example

let rot = Quaternion::new(1.0, 2.0, 3.0, 4.0);

let dq = DualQuaternion::from_real(rot);
assert_eq!(dq.real.w, 1.0);
assert_eq!(dq.dual.w, 0.0);

Trait Implementations

impl<T> AbsDiffEq<DualQuaternion<T>> for DualQuaternion<T> where
    T: RealField<Epsilon = T> + AbsDiffEq<T>, 
[src]

type Epsilon = T

Used for specifying relative comparisons.

impl<'a, 'b, T> Add<&'b DualQuaternion<T>> for &'a DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the + operator.

impl<'b, T> Add<&'b DualQuaternion<T>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the + operator.

impl<'a, T> Add<DualQuaternion<T>> for &'a DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the + operator.

impl<T> Add<DualQuaternion<T>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the + operator.

impl<'b, T> AddAssign<&'b DualQuaternion<T>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

impl<T> AddAssign<DualQuaternion<T>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

impl<T> AsMut<[T; 8]> for DualQuaternion<T> where
    T: SimdRealField
[src]

impl<T> AsRef<[T; 8]> for DualQuaternion<T> where
    T: SimdRealField
[src]

impl<T> Clone for DualQuaternion<T> where
    T: Clone + Scalar
[src]

impl<T> Copy for DualQuaternion<T> where
    T: Copy + Scalar
[src]

impl<T> Debug for DualQuaternion<T> where
    T: Debug + Scalar
[src]

impl<T> Default for DualQuaternion<T> where
    T: Scalar + Zero
[src]

impl<'a, T> Deserialize<'a> for DualQuaternion<T> where
    T: SimdRealField + Deserialize<'a>, 
[src]

impl<'a, 'b, T> Div<&'b Unit<DualQuaternion<T>>> for &'a DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the / operator.

impl<'b, T> Div<&'b Unit<DualQuaternion<T>>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the / operator.

impl<'a, T> Div<T> for &'a DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the / operator.

impl<T> Div<T> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the / operator.

impl<T> Div<Unit<DualQuaternion<T>>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the / operator.

impl<'a, T> Div<Unit<DualQuaternion<T>>> for &'a DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the / operator.

impl<'b, T> DivAssign<&'b Unit<DualQuaternion<T>>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

impl<T> DivAssign<T> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

impl<T> DivAssign<Unit<DualQuaternion<T>>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

impl<T> Eq for DualQuaternion<T> where
    T: Eq + Scalar
[src]

impl<T> Index<usize> for DualQuaternion<T> where
    T: SimdRealField
[src]

type Output = T

The returned type after indexing.

impl<T> IndexMut<usize> for DualQuaternion<T> where
    T: SimdRealField
[src]

impl<'a, 'b, T> Mul<&'b DualQuaternion<T>> for &'a Unit<DualQuaternion<T>> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the * operator.

impl<'b, T> Mul<&'b DualQuaternion<T>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the * operator.

impl<'b, T> Mul<&'b DualQuaternion<T>> for Unit<DualQuaternion<T>> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the * operator.

impl<'a, 'b, T> Mul<&'b DualQuaternion<T>> for &'a DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the * operator.

impl<'b, T> Mul<&'b Unit<DualQuaternion<T>>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the * operator.

impl<'a, 'b, T> Mul<&'b Unit<DualQuaternion<T>>> for &'a DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the * operator.

impl<'a, T> Mul<DualQuaternion<T>> for &'a DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the * operator.

impl<T> Mul<DualQuaternion<T>> for Unit<DualQuaternion<T>> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the * operator.

impl<T> Mul<DualQuaternion<T>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the * operator.

impl<'a, T> Mul<DualQuaternion<T>> for &'a Unit<DualQuaternion<T>> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the * operator.

impl<'a, T> Mul<T> for &'a DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the * operator.

impl<T> Mul<T> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the * operator.

impl<'a, T> Mul<Unit<DualQuaternion<T>>> for &'a DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the * operator.

impl<T> Mul<Unit<DualQuaternion<T>>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the * operator.

impl<'b, T> MulAssign<&'b DualQuaternion<T>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

impl<'b, T> MulAssign<&'b Unit<DualQuaternion<T>>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

impl<T> MulAssign<DualQuaternion<T>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

impl<T> MulAssign<T> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

impl<T> MulAssign<Unit<DualQuaternion<T>>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

impl<T> Neg for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the - operator.

impl<'a, T> Neg for &'a DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the - operator.

impl<T> Normed for DualQuaternion<T> where
    T: SimdRealField
[src]

type Norm = <T as SimdComplexField>::SimdRealField

The type of the norm.

impl<T> One for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

impl<T> PartialEq<DualQuaternion<T>> for DualQuaternion<T> where
    T: PartialEq<T> + Scalar
[src]

impl<T> RelativeEq<DualQuaternion<T>> for DualQuaternion<T> where
    T: RealField<Epsilon = T> + RelativeEq<T>, 
[src]

impl<T> Serialize for DualQuaternion<T> where
    T: SimdRealField + Serialize
[src]

impl<T> StructuralEq for DualQuaternion<T> where
    T: Scalar
[src]

impl<T> StructuralPartialEq for DualQuaternion<T> where
    T: Scalar
[src]

impl<'b, T> Sub<&'b DualQuaternion<T>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the - operator.

impl<'a, 'b, T> Sub<&'b DualQuaternion<T>> for &'a DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the - operator.

impl<'a, T> Sub<DualQuaternion<T>> for &'a DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the - operator.

impl<T> Sub<DualQuaternion<T>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

type Output = DualQuaternion<T>

The resulting type after applying the - operator.

impl<'b, T> SubAssign<&'b DualQuaternion<T>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

impl<T> SubAssign<DualQuaternion<T>> for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

impl<T1, T2> SubsetOf<DualQuaternion<T2>> for DualQuaternion<T1> where
    T1: SimdRealField,
    T2: SimdRealField + SupersetOf<T1>, 
[src]

impl<T> UlpsEq<DualQuaternion<T>> for DualQuaternion<T> where
    T: RealField<Epsilon = T> + UlpsEq<T>, 
[src]

impl<T> Zero for DualQuaternion<T> where
    T: SimdRealField,
    <T as SimdValue>::Element: SimdRealField
[src]

Auto Trait Implementations

impl<T> RefUnwindSafe for DualQuaternion<T> where
    T: RefUnwindSafe

impl<T> Send for DualQuaternion<T> where
    T: Send

impl<T> Sync for DualQuaternion<T> where
    T: Sync

impl<T> Unpin for DualQuaternion<T> where
    T: Unpin

impl<T> UnwindSafe for DualQuaternion<T> where
    T: UnwindSafe

Blanket Implementations

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T, U> Cast<U> for T where
    U: FromCast<T>, 

impl<T, Right> ClosedAdd<Right> for T where
    T: Add<Right, Output = T> + AddAssign<Right>, 

impl<T, Right> ClosedDiv<Right> for T where
    T: Div<Right, Output = T> + DivAssign<Right>, 

impl<T, Right> ClosedMul<Right> for T where
    T: Mul<Right, Output = T> + MulAssign<Right>, 

impl<T> ClosedNeg for T where
    T: Neg<Output = T>, 

impl<T, Right> ClosedSub<Right> for T where
    T: Sub<Right, Output = T> + SubAssign<Right>, 

impl<T> DeserializeOwned for T where
    T: for<'de> Deserialize<'de>, 
[src]

impl<T> Downcast for T where
    T: Any

impl<T> DowncastSync for T where
    T: Any + Send + Sync

impl<T> From<T> for T[src]

impl<T> FromBits<T> for T

impl<T> FromCast<T> for T

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T, U> IntoBits<U> for T where
    U: FromBits<T>, 

impl<T> Pointable for T

type Init = T

The type for initializers.

impl<T> Same<T> for T

type Output = T

Should always be Self

impl<T> Scalar for T where
    T: Copy + PartialEq<T> + Debug + Any
[src]

impl<SS, SP> SupersetOf<SS> for SP where
    SS: SubsetOf<SP>, 

impl<T> ToOwned for T where
    T: Clone
[src]

type Owned = T

The resulting type after obtaining ownership.

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<V, T> VZip<V> for T where
    V: MultiLane<T>,