[][src]Struct euclid::TypedTransform2D

#[repr(C)]
pub struct TypedTransform2D<T, Src, Dst> {
    pub m11: T,
    pub m12: T,
    pub m21: T,
    pub m22: T,
    pub m31: T,
    pub m32: T,
    // some fields omitted
}

A 2d transform stored as a 3 by 2 matrix in row-major order in memory.

Transforms can be parametrized over the source and destination units, to describe a transformation from a space to another. For example, TypedTransform2D<f32, WorldSpace, ScreenSpace>::transform_point4d takes a TypedPoint2D<f32, WorldSpace> and returns a TypedPoint2D<f32, ScreenSpace>.

Transforms expose a set of convenience methods for pre- and post-transformations. A pre-transformation corresponds to adding an operation that is applied before the rest of the transformation, while a post-transformation adds an operation that is applied after.

These transforms are for working with row vectors, so the matrix math for transforming a vector is v * T. If your library is using column vectors, use row_major functions when you are asked for column_major representations and vice versa.

Fields

m11: Tm12: Tm21: Tm22: Tm31: Tm32: T

Methods

impl<T: Copy, Src, Dst> TypedTransform2D<T, Src, Dst>[src]

pub fn row_major(m11: T, m12: T, m21: T, m22: T, m31: T, m32: T) -> Self[src]

Create a transform specifying its matrix elements in row-major order.

Beware: This library is written with the assumption that row vectors are being used. If your matrices use column vectors (i.e. transforming a vector is T * v), then please use column_major

pub fn column_major(m11: T, m21: T, m31: T, m12: T, m22: T, m32: T) -> Self[src]

Create a transform specifying its matrix elements in column-major order.

Beware: This library is written with the assumption that row vectors are being used. If your matrices use column vectors (i.e. transforming a vector is T * v), then please use row_major

pub fn to_row_major_array(&self) -> [T; 6][src]

Returns an array containing this transform's terms in row-major order (the order in which the transform is actually laid out in memory).

Beware: This library is written with the assumption that row vectors are being used. If your matrices use column vectors (i.e. transforming a vector is T * v), then please use to_column_major_array

pub fn to_column_major_array(&self) -> [T; 6][src]

Returns an array containing this transform's terms in column-major order.

Beware: This library is written with the assumption that row vectors are being used. If your matrices use column vectors (i.e. transforming a vector is T * v), then please use to_row_major_array

pub fn to_row_arrays(&self) -> [[T; 2]; 3][src]

Returns an array containing this transform's 3 rows in (in row-major order) as arrays.

This is a convenience method to interface with other libraries like glium.

Beware: This library is written with the assumption that row vectors are being used. If your matrices use column vectors (i.e. transforming a vector is T * v), this will return column major arrays.

pub fn from_row_major_array(array: [T; 6]) -> Self[src]

Creates a transform from an array of 6 elements in row-major order.

Beware: This library is written with the assumption that row vectors are being used. If your matrices use column vectors (i.e. transforming a vector is T * v), please provide a column major array.

pub fn from_row_arrays(array: [[T; 2]; 3]) -> Self[src]

Creates a transform from 3 rows of 2 elements (row-major order).

Beware: This library is written with the assumption that row vectors are being used. If your matrices use column vectors (i.e. transforming a vector is T * v), please provide a column major array.

pub fn to_untyped(&self) -> Transform2D<T>[src]

Drop the units, preserving only the numeric value.

pub fn from_untyped(p: &Transform2D<T>) -> Self[src]

Tag a unitless value with units.

impl<T0: NumCast + Copy, Src, Dst> TypedTransform2D<T0, Src, Dst>[src]

pub fn cast<T1: NumCast + Copy>(&self) -> TypedTransform2D<T1, Src, Dst>[src]

Cast from one numeric representation to another, preserving the units.

pub fn try_cast<T1: NumCast + Copy>(
    &self
) -> Option<TypedTransform2D<T1, Src, Dst>>
[src]

Fallible cast from one numeric representation to another, preserving the units.

impl<T, Src, Dst> TypedTransform2D<T, Src, Dst> where
    T: Copy + PartialEq + One + Zero
[src]

pub fn identity() -> Self[src]

impl<T, Src, Dst> TypedTransform2D<T, Src, Dst> where
    T: Copy + Clone + Add<T, Output = T> + Mul<T, Output = T> + Div<T, Output = T> + Sub<T, Output = T> + Trig + PartialOrd + One + Zero
[src]

pub fn post_mul<NewDst>(
    &self,
    mat: &TypedTransform2D<T, Dst, NewDst>
) -> TypedTransform2D<T, Src, NewDst>
[src]

Returns the multiplication of the two matrices such that mat's transformation applies after self's transformation.

Assuming row vectors, this is equivalent to self * mat

pub fn pre_mul<NewSrc>(
    &self,
    mat: &TypedTransform2D<T, NewSrc, Src>
) -> TypedTransform2D<T, NewSrc, Dst>
[src]

Returns the multiplication of the two matrices such that mat's transformation applies before self's transformation.

Assuming row vectors, this is equivalent to mat * self

pub fn create_translation(x: T, y: T) -> Self[src]

Returns a translation transform.

pub fn post_translate(&self, v: TypedVector2D<T, Dst>) -> Self[src]

Applies a translation after self's transformation and returns the resulting transform.

pub fn pre_translate(&self, v: TypedVector2D<T, Src>) -> Self[src]

Applies a translation before self's transformation and returns the resulting transform.

pub fn create_scale(x: T, y: T) -> Self[src]

Returns a scale transform.

pub fn post_scale(&self, x: T, y: T) -> Self[src]

Applies a scale after self's transformation and returns the resulting transform.

pub fn pre_scale(&self, x: T, y: T) -> Self[src]

Applies a scale before self's transformation and returns the resulting transform.

pub fn create_rotation(theta: Angle<T>) -> Self[src]

Returns a rotation transform.

pub fn post_rotate(&self, theta: Angle<T>) -> Self[src]

Applies a rotation after self's transformation and returns the resulting transform.

pub fn pre_rotate(&self, theta: Angle<T>) -> Self[src]

Applies a rotation after self's transformation and returns the resulting transform.

pub fn transform_point(
    &self,
    point: &TypedPoint2D<T, Src>
) -> TypedPoint2D<T, Dst>
[src]

Returns the given point transformed by this transform.

Assuming row vectors, this is equivalent to p * self

pub fn transform_vector(
    &self,
    vec: &TypedVector2D<T, Src>
) -> TypedVector2D<T, Dst>
[src]

Returns the given vector transformed by this matrix.

Assuming row vectors, this is equivalent to v * self

pub fn transform_rect(&self, rect: &TypedRect<T, Src>) -> TypedRect<T, Dst>[src]

Returns a rectangle that encompasses the result of transforming the given rectangle by this transform.

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

Computes and returns the determinant of this transform.

pub fn inverse(&self) -> Option<TypedTransform2D<T, Dst, Src>>[src]

Returns the inverse transform if possible.

pub fn with_destination<NewDst>(&self) -> TypedTransform2D<T, Src, NewDst>[src]

Returns the same transform with a different destination unit.

pub fn with_source<NewSrc>(&self) -> TypedTransform2D<T, NewSrc, Dst>[src]

Returns the same transform with a different source unit.

impl<T, Src, Dst> TypedTransform2D<T, Src, Dst> where
    T: Copy + Clone + Add<T, Output = T> + Sub<T, Output = T> + Mul<T, Output = T> + Div<T, Output = T> + Neg<Output = T> + PartialOrd + Trig + One + Zero
[src]

pub fn to_3d(&self) -> TypedTransform3D<T, Src, Dst>[src]

Create a 3D transform from the current transform

impl<T: ApproxEq<T>, Src, Dst> TypedTransform2D<T, Src, Dst>[src]

pub fn approx_eq(&self, other: &Self) -> bool[src]

Trait Implementations

impl<T, Src, Dst> PartialEq<TypedTransform2D<T, Src, Dst>> for TypedTransform2D<T, Src, Dst> where
    T: PartialEq
[src]

#[must_use] fn ne(&self, other: &Rhs) -> bool1.0.0[src]

This method tests for !=.

impl<T, Src, Dst> Eq for TypedTransform2D<T, Src, Dst> where
    T: Eq
[src]

impl<T, Src, Dst> Hash for TypedTransform2D<T, Src, Dst> where
    T: Hash
[src]

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher
1.3.0[src]

Feeds a slice of this type into the given [Hasher]. Read more

impl<T: Copy + Debug, Src, Dst> Debug for TypedTransform2D<T, Src, Dst> where
    T: Copy + Debug + PartialEq + One + Zero
[src]

impl<T, Src, Dst> Copy for TypedTransform2D<T, Src, Dst> where
    T: Copy
[src]

impl<T, Src, Dst> Into<TypedTransform2D<T, Src, Dst>> for TypedTranslation2D<T, Src, Dst> where
    T: Copy + Clone + Add<T, Output = T> + Mul<T, Output = T> + Div<T, Output = T> + Sub<T, Output = T> + Trig + PartialOrd + One + Zero
[src]

impl<T, Src, Dst> Clone for TypedTransform2D<T, Src, Dst> where
    T: Clone
[src]

fn clone_from(&mut self, source: &Self)1.0.0[src]

Performs copy-assignment from source. Read more

impl<T, Src, Dst> Default for TypedTransform2D<T, Src, Dst> where
    T: Copy + PartialEq + One + Zero
[src]

Auto Trait Implementations

impl<T, Src, Dst> Unpin for TypedTransform2D<T, Src, Dst> where
    Dst: Unpin,
    Src: Unpin,
    T: Unpin

impl<T, Src, Dst> Send for TypedTransform2D<T, Src, Dst> where
    Dst: Send,
    Src: Send,
    T: Send

impl<T, Src, Dst> Sync for TypedTransform2D<T, Src, Dst> where
    Dst: Sync,
    Src: Sync,
    T: Sync

impl<T, Src, Dst> UnwindSafe for TypedTransform2D<T, Src, Dst> where
    Dst: UnwindSafe,
    Src: UnwindSafe,
    T: UnwindSafe

impl<T, Src, Dst> RefUnwindSafe for TypedTransform2D<T, Src, Dst> where
    Dst: RefUnwindSafe,
    Src: RefUnwindSafe,
    T: RefUnwindSafe

Blanket Implementations

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> Into<U> for T where
    U: From<T>, 
[src]

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

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<T> Borrow<T> for T where
    T: ?Sized
[src]

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

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

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

type Owned = T

The resulting type after obtaining ownership.