Struct Transform

pub struct Transform {
    pub sx: f32,
    pub kx: f32,
    pub ky: f32,
    pub sy: f32,
    pub tx: f32,
    pub ty: f32,
}

An affine transformation matrix.

Unlike other types, doesn’t guarantee to be valid. This is Skia quirk. Meaning Transform(0, 0, 0, 0, 0, 0) is ok, while it’s technically not. Non-finite values are also not an error.

Fields

sx: f32

kx: f32

ky: f32

sy: f32

tx: f32

ty: f32

Implementations

impl Transform

pub fn identity() -> Self

Creates an identity transform.

pub fn from_row(sx: f32, ky: f32, kx: f32, sy: f32, tx: f32, ty: f32) -> Self

Creates a new Transform.

We are using column-major-column-vector matrix notation, therefore it’s ky-kx, not kx-ky.

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

Creates a new translating Transform.

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

Creates a new scaling Transform.

pub fn from_skew(kx: f32, ky: f32) -> Self

Creates a new skewing Transform.

pub fn from_rotate(angle: f32) -> Self

Creates a new rotating Transform.

angle in degrees.

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

Creates a new rotating Transform at the specified position.

angle in degrees.

pub fn from_bbox(bbox: NonZeroRect) -> Self

Converts Rect into a bounding box Transform.

pub fn is_finite(&self) -> bool

Checks that transform is finite.

pub fn is_valid(&self) -> bool

Checks that transform is finite and has non-zero scale.

pub fn is_identity(&self) -> bool

Checks that transform is identity.

pub fn is_scale(&self) -> bool

Checks that transform is scale-only.

pub fn is_skew(&self) -> bool

Checks that transform is skew-only.

pub fn is_translate(&self) -> bool

Checks that transform is translate-only.

pub fn is_scale_translate(&self) -> bool

Checks that transform contains only scale and translate.

pub fn has_scale(&self) -> bool

Checks that transform contains a scale part.

pub fn has_skew(&self) -> bool

Checks that transform contains a skew part.

pub fn has_translate(&self) -> bool

Checks that transform contains a translate part.

pub fn get_scale(&self) -> (f32, f32)

Returns transform’s scale part.

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

Pre-scales the current transform.

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

Post-scales the current transform.

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

Pre-translates the current transform.

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

Post-translates the current transform.

pub fn pre_rotate(&self, angle: f32) -> Self

Pre-rotates the current transform.

angle in degrees.

pub fn post_rotate(&self, angle: f32) -> Self

Post-rotates the current transform.

angle in degrees.

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

Pre-rotates the current transform by the specified position.

angle in degrees.

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

Post-rotates the current transform by the specified position.

angle in degrees.

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

Pre-concats the current transform.

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

Post-concats the current transform.

pub fn map_point(&self, point: &mut Point)

Transforms a points using the current transform.

pub fn map_points(&self, points: &mut [Point])

Transforms a slice of points using the current transform.

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

Returns an inverted transform.

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

Formats the value using the given formatter.

impl Default for Transform

fn default() -> Self

Returns the “default value” for a type.

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 Copy for Transform

impl StructuralPartialEq for Transform