Skip to main content

TransformationMatrix

Struct TransformationMatrix 

Source
#[repr(C)]
pub struct TransformationMatrix { pub rotation_scale: [[f32; 2]; 2], pub translation: [f32; 2], }
Expand description

A data type representing a 2 dimensional transformation that can be applied to an element.

Fields§

§rotation_scale: [[f32; 2]; 2]

2x2 matrix containing rotation and scale, stored row-major

§translation: [f32; 2]

translation vector

Implementations§

Source§

impl TransformationMatrix

Source

pub fn unit() -> Self

The unit matrix, has no effect.

Source

pub fn translate(self, point: Point<ScaledPixels>) -> Self

Move the origin by a given point

Source

pub fn rotate(self, angle: Radians) -> Self

Clockwise rotation in radians around the origin

Source

pub fn scale(self, size: Size<f32>) -> Self

Scale around the origin

Source

pub fn compose(self, other: TransformationMatrix) -> TransformationMatrix

Perform matrix multiplication with another transformation to produce a new transformation that is the result of applying both transformations: first, other, then self.

Source

pub fn apply(&self, point: Point<Pixels>) -> Point<Pixels>

Apply transformation to a point, mainly useful for debugging

Source

pub fn inverse(&self) -> Option<TransformationMatrix>

The inverse transformation, or None when the matrix is singular (scale(0) collapses the element to nothing, and nothing has no interior to map a point back into).

This is what hit-testing needs: a hitbox stores its untransformed bounds, so testing a pointer against a transformed element means mapping the pointer back into the element’s own frame rather than mapping four corners forward and testing a polygon.

Source

pub fn is_unit(&self) -> bool

Is this the identity — i.e. is there nothing to apply?

Worth asking before every push, because the whole point of the paint path is that an untransformed element costs exactly what it did before transforms existed.

Trait Implementations§

Source§

impl Clone for TransformationMatrix

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Copy for TransformationMatrix

Source§

impl Debug for TransformationMatrix

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for TransformationMatrix

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl Eq for TransformationMatrix

Source§

impl PartialEq for TransformationMatrix

Source§

fn eq(&self, other: &Self) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for TransformationMatrix

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> ErasedDestructor for T
where T: 'static,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

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

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

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

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more