Struct Affine

#[repr(C)]
pub struct Affine(/* private fields */);

A 2D affine transform. Derived from kurbo.

Implementations

impl Affine

pub const IDENTITY: Affine = _

The identity transform.

pub const FLIP_Y: Affine = _

A transform that is flipped on the y-axis. Useful for converting between y-up and y-down spaces.

pub const FLIP_X: Affine = _

A transform that is flipped on the x-axis.

pub const fn new(c: [f64; 6]) -> Affine

Construct an affine transform from coefficients.

If the coefficients are (a, b, c, d, e, f), then the resulting transformation represents this augmented matrix:

| a c e |
| b d f |
| 0 0 1 |

Note that this convention is transposed from PostScript and Direct2D, but is consistent with the Wikipedia formulation of affine transformation as augmented matrix. The idea is that (A * B) * v == A * (B * v), where * is the Mul trait.

pub const fn scale(s: f64) -> Affine

An affine transform representing uniform scaling.

pub const fn scale_non_uniform(s_x: f64, s_y: f64) -> Affine

An affine transform representing non-uniform scaling with different scale values for x and y

pub fn rotate(th: f64) -> Affine

An affine transform representing rotation.

The convention for rotation is that a positive angle rotates a positive X direction into positive Y. Thus, in a Y-down coordinate system (as is common for graphics), it is a clockwise rotation, and in Y-up (traditional for math), it is anti-clockwise.

The angle, th, is expressed in radians.

pub fn translate<V: Into<Vec2>>(p: V) -> Affine

An affine transform representing translation.

pub fn map_unit_square(rect: Rect) -> Affine

Creates an affine transformation that takes the unit square to the given rectangle.

Useful when you want to draw into the unit square but have your output fill any rectangle. In this case push the Affine onto the transform stack.

pub fn as_coeffs(self) -> [f64; 6]

Get the coefficients of the transform.

pub fn determinant(self) -> f64

Compute the determinant of this transform.

pub fn inverse(self) -> Affine

Compute the inverse transform.

Produces NaN values when the determinant is zero.

pub fn transform_rect_bbox(self, rect: Rect) -> Rect

Compute the bounding box of a transformed rectangle.

Returns the minimal Rect that encloses the given Rect after affine transformation. If the transform is axis-aligned, then this bounding box is “tight”, in other words the returned Rect is the transformed rectangle.

The returned rectangle always has non-negative width and height.

pub fn is_finite(&self) -> bool

Is this map finite?

pub fn is_nan(&self) -> bool

Is this map NaN?

Trait Implementations

impl Clone for Affine

fn clone(&self) -> Affine

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Affine

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

Formats the value using the given formatter.

impl Default for Affine

fn default() -> Affine

Returns the “default value” for a type.

impl Mul<Affine> for f64

type Output = Affine

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Point> for Affine

type Output = Point

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul for Affine

type Output = Affine

The resulting type after applying the * operator.

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

Performs the * operation.

impl MulAssign for Affine

fn mul_assign(&mut self, other: Affine)

Performs the *= operation.

impl PartialEq for Affine

fn eq(&self, other: &Affine) -> 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 Affine

impl StructuralPartialEq for Affine