Struct Transform

pub struct Transform(/* private fields */);

A 3x2 transformation matrix representing an affine transform.

In other words, it is a 2x2 transformation matrix with a translation component, or a 3x3 homogenous transform matrix.

Implementations

impl Transform

pub const IDENTITY: Transform = _

pub const fn new( m00: f32, m01: f32, m10: f32, m11: f32, tx: f32, ty: f32, ) -> Transform

Creates a matrix from each individual element.

The matrix is in column-major order, that is:

$$ \begin{bmatrix} \texttt{m00} & \texttt{m10} & \texttt{tx} \\ \texttt{m01} & \texttt{m11} & \texttt{ty} \\ 0 & 0 & 1 \end{bmatrix} $$

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

Creates a transform that performs a translation.

$$ \begin{bmatrix} 1 & 0 & \texttt{tx} \\ 0 & 1 & \texttt{ty} \\ 0 & 0 & 1 \end{bmatrix} $$

pub const fn scaling(sx: f32, sy: f32) -> Transform

Creates a transform that performs scaling.

$$ \begin{bmatrix} \texttt{sx} & 0 & 0 \\ 0 & \texttt{sy} & 0 \\ 0 & 0 & 1 \end{bmatrix} $$

pub fn rotation(theta: f32) -> Transform

Creates a transform that performs a rotation.

$$ \begin{bmatrix} \text{cos}\ \theta & -\text{sin}\ \theta & 0 \\ \text{sin}\ \theta & \text{cos}\ \theta & 0 \\ 0 & 0 & 1 \end{bmatrix} $$

pub const fn determinant(&self) -> f32

Computes the determinant of the matrix.

pub const fn inverse(&self) -> Option<Transform>

Computes the inverse of the matrix.

If the matrix is degenerate (that is, the determinant is zero), returns None.

pub const fn transform(&self, x: f32, y: f32) -> (f32, f32)

Transforms a point by the matrix.

Trait Implementations

impl Clone for Transform

fn clone(&self) -> Transform

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Transform

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

Formats the value using the given formatter.

impl Default for Transform

fn default() -> Transform

Returns the “default value” for a type.

impl Mul for Transform

type Output = Transform

The resulting type after applying the * operator.

fn mul(self, rhs: Transform) -> <Transform as Mul>::Output

Performs the * operation.

impl MulAssign for Transform

fn mul_assign(&mut self, rhs: Transform)

Performs the *= operation.

impl Copy for Transform