Struct Matrix 

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

Matrix is a full 4×4 column-major transform.

Valo maps two-dimensional input as (x, y, 0, 1), including perspective division. The renderer ignores transformed z for draw ordering.

Implementations

impl Matrix

pub const IDENTITY: Matrix

IDENTITY leaves coordinates unchanged.

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

translation creates a two-dimensional translation.

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

scale creates a two-dimensional scale.

pub fn rotation(radians: f32) -> Self

rotation creates a rotation around the origin.

Positive angles rotate clockwise in Valo’s y-down coordinate system.

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

from_affine creates a matrix from [a, b, c, d, tx, ty].

The linear columns are (a, b) and (c, d).

pub fn from_flutter_array(values: &[f32; 16]) -> Self

from_flutter_array creates a matrix from 16 column-major Flutter values.

pub fn to_flutter_array(&self) -> [f32; 16]

to_flutter_array returns 16 column-major Flutter values.

pub fn to_mat4(self) -> Mat4

to_mat4 returns the backing glam matrix.

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

then composes this matrix with other.

The result applies other first and this matrix second.

pub fn is_affine(&self) -> bool

is_affine reports whether two-dimensional input has no perspective.

pub fn kind(&self) -> MatrixKind

kind classifies this matrix for two-dimensional rendering.

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

map_point transforms a point and applies perspective division.

Points at or behind the eye plane use a small positive divisor.

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

map_rect returns axis-aligned bounds around a transformed rectangle.

It returns Rect::EVERYTHING when a corner reaches or crosses the eye plane and finite conservative bounds cannot be proven.

pub fn max_scale(&self) -> f32

max_scale returns the larger length of the transformed x and y basis vectors.

It ignores perspective and is therefore approximate for general matrices.

pub fn to_affine(&self) -> [f32; 6]

to_affine returns [a, b, c, d, tx, ty] from the two-dimensional block.

Perspective components are omitted; check Self::is_affine when exact conversion is required.

pub fn determinant(&self) -> f32

determinant returns the signed area scale of the two-dimensional block.

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

invert returns the inverse matrix or None when no finite inverse exists.

Trait Implementations

impl Clone for Matrix

fn clone(&self) -> Matrix

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Matrix

impl Debug for Matrix

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

Formats the value using the given formatter.

impl Default for Matrix

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for Matrix

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Matrix