Struct Affine

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

A 2D affine transform.

Implementations

impl Affine

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>(p: V) -> Affine

where V: Into<Vec2>,

An affine transform representing translation.

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.

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<(), Error>

Formats the value using the given formatter.

impl Default for Affine

fn default() -> Affine

Returns the “default value” for a type.

impl From<TranslateScale> for Affine

fn from(ts: TranslateScale) -> Affine

Converts to this type from the input type.

impl<'a> Mul<&'a BezPath> for Affine

type Output = BezPath

The resulting type after applying the * operator.

fn mul(self, other: &BezPath) -> BezPath

Performs the * operation.

impl Mul<BezPath> for Affine

type Output = BezPath

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Circle> for Affine

type Output = Ellipse

The resulting type after applying the * operator.

fn mul(self, other: Circle) -> <Affine as Mul<Circle>>::Output

Performs the * operation.

impl Mul<CubicBez> for Affine

type Output = CubicBez

The resulting type after applying the * operator.

fn mul(self, c: CubicBez) -> CubicBez

Performs the * operation.

impl Mul<Ellipse> for Affine

type Output = Ellipse

The resulting type after applying the * operator.

fn mul(self, other: Ellipse) -> <Affine as Mul<Ellipse>>::Output

Performs the * operation.

impl Mul<Line> for Affine

type Output = Line

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<PathEl> for Affine

type Output = PathEl

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<PathSeg> for Affine

type Output = PathSeg

The resulting type after applying the * operator.

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

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<QuadBez> for Affine

type Output = QuadBez

The resulting type after applying the * operator.

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

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