Struct Transform 

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

A 2D transformation represented by a matrix

Transforms can be composed together through matrix multiplication, and are applied to Vectors through multiplication, meaning the notation used is the ‘*’ operator. A property of matrix multiplication is that for some matrices A, B, C and vector V is

Transform = A * B * C
Transform * V = A * (B * (C * V))

This property allows encoding multiple transformations in a single matrix. A transformation that involves rotating a shape 30 degrees and then moving it six units up could be written as

use quicksilver::geom::{Transform, Vector};
let transform = Transform::rotate(30.0) * Transform::translate(Vector::new(0.0, -6.0));

and then applied to a Vector

transform * Vector::new(5.0, 5.0)

Implementations

impl Transform

pub const IDENTITY: Transform

The identity transformation

pub fn rotate(angle: f32) -> Transform

Create a rotation transformation

pub fn translate(vec: Vector) -> Transform

Create a translation transformation

pub fn scale(vec: Vector) -> Transform

Create a scale transformation

pub fn orthographic(rect: Rectangle) -> Transform

Create an orthographic projection

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

pub fn inverse(&self) -> Transform

Find the inverse of a Transform

A transform’s inverse will cancel it out when multplied with it, as seen below:

let transform = Transform::translate(Vector::new(4.0, 5.0));
let inverse = transform.inverse();
let vector = Vector::new(10.0, 10.0);
assert_eq!(vector, transform * inverse * vector);
assert_eq!(vector, inverse * transform * vector);

Trait Implementations

impl Add for Transform

Add the values of two transforms together

Note you probably want Mul to combine Transforms. Addition is only useful in less common use cases like interpolation

type Output = Transform

The resulting type after applying the + operator.

fn add(self, other: Transform) -> Transform

Performs the + operation.

impl AddAssign for Transform

Uses the impl Add<Transform> for Transform internally

fn add_assign(&mut self, other: Transform)

Performs the += operation.

impl Clone for Transform

fn clone(&self) -> Transform

Returns a duplicate 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

Formats the value using the given formatter.

impl Default for Transform

fn default() -> Transform

Returns the “default value” for a type.

impl Display for Transform

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

Formats the value using the given formatter.

impl From<[[f32; 3]; 3]> for Transform

fn from(array: [[f32; 3]; 3]) -> Transform

Converts to this type from the input type.

impl From<RowMatrix3<f32>> for Transform

fn from(mat: RowMatrix3<f32>) -> Transform

Converts to this type from the input type.

impl From<Transform> for [[f32; 3]; 3]

fn from(trans: Transform) -> [[f32; 3]; 3]

Converts to this type from the input type.

impl From<Transform> for RowMatrix3<f32>

fn from(trans: Transform) -> RowMatrix3<f32>

Converts to this type from the input type.

impl Mul<Vector> for Transform

Transform a vector

type Output = Vector

The resulting type after applying the * operator.

fn mul(self, other: Vector) -> Vector

Performs the * operation.

impl Mul<f32> for Transform

Scale all of the internal values of the Transform matrix

Note this will NOT scale vectors multiplied by this transform, and generally you shouldn’t need to use this.

type Output = Transform

The resulting type after applying the * operator.

fn mul(self, other: f32) -> Transform

Performs the * operation.

impl Mul for Transform

Concat two transforms A and B such that A * B * v = A * (B * v)

type Output = Transform

The resulting type after applying the * operator.

fn mul(self, other: Transform) -> Transform

Performs the * operation.

impl MulAssign<f32> for Transform

Uses the impl Mul<f32> for Transform internally.

fn mul_assign(&mut self, other: f32)

Performs the *= operation.

impl MulAssign for Transform

Uses the impl Mul<Transform> for Transform internally.

fn mul_assign(&mut self, other: Transform)

Performs the *= operation.

impl PartialEq for Transform

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Sub for Transform

Subtract the values of one transform from another

Note you probably want Mul to combine Transforms. Subtraction is only useful in less common use cases like interpolation

type Output = Transform

The resulting type after applying the - operator.

fn sub(self, other: Transform) -> Transform

Performs the - operation.

impl SubAssign for Transform

Uses the impl Sub<Transform> for Transform internally

fn sub_assign(&mut self, other: Transform)

Performs the -= operation.

impl Copy for Transform

impl Eq for Transform