Struct gdnative::common::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.

Fields

m11: T

m12: T

m21: T

m22: T

m31: T

m32: T

Methods

impl<T, Src, Dst> TypedTransform2D<T, Src, Dst> where     T: Copy,

pub fn row_major(     m11: T,     m12: T,     m21: T,     m22: T,     m31: T,     m32: T ) -> TypedTransform2D<T, Src, Dst>

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

pub fn column_major(     m11: T,     m21: T,     m31: T,     m12: T,     m22: T,     m32: T ) -> TypedTransform2D<T, Src, Dst>

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

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

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

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

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

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

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.

pub fn from_row_major_array(array: [T; 6]) -> TypedTransform2D<T, Src, Dst>

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

pub fn from_row_arrays(array: [[T; 2]; 3]) -> TypedTransform2D<T, Src, Dst>

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

pub fn to_untyped(&self) -> TypedTransform2D<T, UnknownUnit, UnknownUnit>

Drop the units, preserving only the numeric value.

pub fn from_untyped(     p: &TypedTransform2D<T, UnknownUnit, UnknownUnit> ) -> TypedTransform2D<T, Src, Dst>

Tag a unitless value with units.

impl<T0, Src, Dst> TypedTransform2D<T0, Src, Dst> where     T0: Copy + NumCast,

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

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

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

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

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

pub fn identity() -> TypedTransform2D<T, Src, Dst>

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

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

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

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

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

pub fn create_translation(x: T, y: T) -> TypedTransform2D<T, Src, Dst>

Returns a translation transform.

pub fn post_translate(     &self,     v: TypedVector2D<T, Dst> ) -> TypedTransform2D<T, Src, Dst>

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

pub fn pre_translate(     &self,     v: TypedVector2D<T, Src> ) -> TypedTransform2D<T, Src, Dst>

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

pub fn create_scale(x: T, y: T) -> TypedTransform2D<T, Src, Dst>

Returns a scale transform.

pub fn post_scale(&self, x: T, y: T) -> TypedTransform2D<T, Src, Dst>

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

pub fn pre_scale(&self, x: T, y: T) -> TypedTransform2D<T, Src, Dst>

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

pub fn create_rotation(theta: Angle<T>) -> TypedTransform2D<T, Src, Dst>

Returns a rotation transform.

pub fn post_rotate(&self, theta: Angle<T>) -> TypedTransform2D<T, Src, Dst>

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

pub fn pre_rotate(&self, theta: Angle<T>) -> TypedTransform2D<T, Src, Dst>

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

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

Returns the given point transformed by this transform.

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

Returns the given vector transformed by this matrix.

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

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

pub fn determinant(&self) -> T

Computes and returns the determinant of this transform.

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

Returns the inverse transform if possible.

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

Returns the same transform with a different destination unit.

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

Returns the same transform with a different source unit.

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

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

Create a 3D transform from the current transform

impl<T, Src, Dst> TypedTransform2D<T, Src, Dst> where     T: ApproxEq<T>,

pub fn approx_eq(&self, other: &TypedTransform2D<T, Src, Dst>) -> bool

Trait Implementations

impl<'l> From<&'l TypedTransform2D<f32, UnknownUnit, UnknownUnit>> for Variant

fn from(val: &'l TypedTransform2D<f32, UnknownUnit, UnknownUnit>) -> Variant

Performs the conversion.

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

fn eq(&self, other: &TypedTransform2D<T, Src, Dst>) -> bool

This method tests for self and other values to be equal, and is used by ==.

#[must_use] fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

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

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

fn default() -> TypedTransform2D<T, Src, Dst>

Returns the "default value" for a type.

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

fn clone(&self) -> TypedTransform2D<T, Src, Dst>

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

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

fn fmt(&self, f: &mut Formatter) -> Result<(), Error>

Formats the value using the given formatter.

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

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

fn into(self) -> TypedTransform2D<T, Src, Dst>

Performs the conversion.

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

fn hash<H>(&self, h: &mut H) where     H: Hasher,

Feeds this value into the given [Hasher].

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

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