Skip to main content

AffineTransform

Struct AffineTransform 

Source
pub struct AffineTransform { /* private fields */ }
Expand description

A 2D affine transformation (translate, rotate, scale, skew).

Stored as a 3×2 matrix internally via glam::Affine2, which gives us SIMD-optimized operations on supported platforms. The matrix layout:

| a  c  tx |
| b  d  ty |
| 0  0  1  |

Use this for standard 2D UI work — CSS transforms, canvas drawing, element positioning. For 3D perspective and rotations around X/Y axes, use Transform3D instead.

Implementations§

Source§

impl AffineTransform

Source

pub const IDENTITY: Self

Source

pub fn new(a: f32, b: f32, c: f32, d: f32, tx: f32, ty: f32) -> Self

Construct from the six matrix components directly.

Source

pub fn translate(tx: f32, ty: f32) -> Self

Source

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

Source

pub fn uniform_scale(s: f32) -> Self

Source

pub fn rotate(angle: f32) -> Self

Counter-clockwise rotation by angle radians.

Source

pub fn is_identity(&self) -> bool

Source

pub fn is_translation_only(&self) -> bool

True when the transform only translates (no rotation, scale, or skew).

Source

pub fn preserves_axis_alignment(&self) -> bool

True when axis-aligned rectangles stay axis-aligned after transformation (no rotation or skew — only scale and translation).

Source

pub fn then(&self, other: &Self) -> Self

Compose: apply self first, then other.

Source

pub fn pre_translate(&self, tx: f32, ty: f32) -> Self

Prepend a translation to this transform.

Source

pub fn pre_scale(&self, sx: f32, sy: f32) -> Self

Prepend a scale to this transform.

Source

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

Compute the inverse. Returns None for singular (degenerate) transforms where the determinant is zero.

Source

pub fn determinant(&self) -> f32

Source

pub fn transform_point(&self, p: Point) -> Point

Source

pub fn transform_rect(&self, r: &Rect) -> Rect

Transform a rectangle. When the transform involves rotation or skew, the result is the axis-aligned bounding box of the transformed corners.

Source

pub fn as_raw(&self) -> &Affine2

Access the underlying glam::Affine2 for interop with rendering libraries that accept glam types directly.

Trait Implementations§

Source§

impl Clone for AffineTransform

Source§

fn clone(&self) -> AffineTransform

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for AffineTransform

Source§

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

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

impl Default for AffineTransform

Source§

fn default() -> Self

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

impl Mul for AffineTransform

Source§

fn mul(self, rhs: Self) -> Self

a * b means “apply b first, then a”.

Source§

type Output = AffineTransform

The resulting type after applying the * operator.
Source§

impl PartialEq for AffineTransform

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl Copy for AffineTransform

Source§

impl StructuralPartialEq for AffineTransform

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<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 = Infallible

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

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

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.