Skip to main content

Affine

Struct Affine 

Source
pub struct Affine {
    pub m: [f32; 6],
}
Expand description

A 2D affine transform (a 2×3 matrix). A point (x, y) becomes (a·x + c·y + e, b·x + d·y + f): a 2×2 linear part [[a, c], [b, d]] (scale, rotation, shear) plus a translation (e, f).

Compositions read “right to left”: a.then(b) applies a then b. This is the unified representation of a crate::LayerTransform’s paint transforms: translation, scale (uniform or per axis) and rotation all fold into a single matrix, with no approximation introduced by composing them.

Fields§

§m: [f32; 6]

[a, b, c, d, e, f]: x' = a·x + c·y + e, y' = b·x + d·y + f.

Implementations§

Source§

impl Affine

Source

pub const IDENTITY: Affine

The identity — no transform at all.

Source

pub const fn translation(tx: f32, ty: f32) -> Affine

A pure translation by (tx, ty).

Source

pub const fn scale(sx: f32, sy: f32) -> Affine

A per-axis scale, about the origin.

Source

pub fn rotation(angle: f32) -> Affine

A rotation of angle radians (clockwise, with y pointing down), about the origin.

Source

pub fn then(self, next: Affine) -> Affine

Composition: self.then(next) applies self then next.

Source

pub fn about(self, pivot: Point) -> Affine

The same transform, but about pivot, which stays fixed: T(pivot) ∘ self ∘ T(-pivot).

Source

pub fn apply(self, p: Point) -> Point

Applies the transform to a point.

Source

pub fn is_axis_aligned(self) -> bool

true when the transform is axis-aligned: its linear part is diagonal (scale and/or translation, with no rotation and no shear), so the image of a rectangle is still a rectangle.

Source

pub fn apply_rect(self, r: Rect) -> Rect

The image of a rectangle under the transform. Exact when the matrix is axis-aligned (Affine::is_axis_aligned); otherwise it returns the image’s bounding box, since a rectangle cannot represent a rotated shape.

Source

pub fn inverse(self) -> Affine

The inverse transform — the identity if the matrix is degenerate.

Trait Implementations§

Source§

impl Clone for Affine

Source§

fn clone(&self) -> Affine

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 Affine

Source§

impl Debug for Affine

Source§

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

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

impl Default for Affine

Source§

fn default() -> Affine

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

impl PartialEq for Affine

Source§

fn eq(&self, other: &Affine) -> 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 Affine

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<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

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<Msg> IntoMsg<Msg> for Msg

Source§

fn defer(work: impl Fn() -> Msg + 'static) -> Msg

The message that stands for work’s result.
Source§

impl<T> MaybeSend for T
where T: Send,

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.