Struct pango::Matrix

pub struct Matrix(_);

A structure specifying a transformation between user-space coordinates and device coordinates. The transformation is given by

<programlisting> x_device = x_user * matrix->xx + y_user * matrix->xy + matrix->x0; y_device = x_user * matrix->yx + y_user * matrix->yy + matrix->y0; </programlisting>

Implementations

impl Matrix

pub fn concat(&mut self, new_matrix: &Matrix)

Changes the transformation represented by self to be the transformation given by first applying transformation given by new_matrix then applying the original transformation.

new_matrix

a Matrix

pub fn font_scale_factor(&self) -> f64

Returns the scale factor of a matrix on the height of the font. That is, the scale factor in the direction perpendicular to the vector that the X coordinate is mapped to. If the scale in the X coordinate is needed as well, use font_scale_factors().

Returns

the scale factor of self on the height of the font, or 1.0 if self is None.

pub fn font_scale_factors(&self) -> (f64, f64)

Calculates the scale factor of a matrix on the width and height of the font. That is, xscale is the scale factor in the direction of the X coordinate, and yscale is the scale factor in the direction perpendicular to the vector that the X coordinate is mapped to.

Note that output numbers will always be non-negative.

Returns

xscale

output scale factor in the x direction, or None

yscale

output scale factor perpendicular to the x direction, or None

pub fn rotate(&mut self, degrees: f64)

Changes the transformation represented by self to be the transformation given by first rotating by degrees degrees counter-clockwise then applying the original transformation.

degrees

degrees to rotate counter-clockwise

pub fn scale(&mut self, scale_x: f64, scale_y: f64)

Changes the transformation represented by self to be the transformation given by first scaling by sx in the X direction and sy in the Y direction then applying the original transformation.

scale_x

amount to scale by in X direction

scale_y

amount to scale by in Y direction

pub fn transform_distance(&self, dx: &mut f64, dy: &mut f64)

Transforms the distance vector (dx,dy) by self. This is similar to transform_point() except that the translation components of the transformation are ignored. The calculation of the returned vector is as follows:

<programlisting> dx2 = dx1 * xx + dy1 * xy; dy2 = dx1 * yx + dy1 * yy; </programlisting>

Affine transformations are position invariant, so the same vector always transforms to the same vector. If (x1,y1) transforms to (x2,y2) then (x1+dx1,y1+dy1) will transform to (x1+dx2,y1+dy2) for all values of x1 and x2.

dx

in/out X component of a distance vector

dy

in/out Y component of a distance vector

pub fn transform_point(&self, x: &mut f64, y: &mut f64)

Transforms the point (x, y) by self.

x

in/out X position

y

in/out Y position

pub fn translate(&mut self, tx: f64, ty: f64)

Changes the transformation represented by self to be the transformation given by first translating by (tx, ty) then applying the original transformation.

tx

amount to translate in the X direction

ty

amount to translate in the Y direction

Trait Implementations

impl Clone for Matrix

fn clone(&self) -> Matrix

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Matrix

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

Formats the value using the given formatter.

impl Hash for Matrix

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl Ord for Matrix

fn cmp(&self, other: &Matrix) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

Restrict a value to a certain interval.

impl PartialEq<Matrix> for Matrix

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl PartialOrd<Matrix> for Matrix

fn partial_cmp(&self, other: &Matrix) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for Matrix

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for Matrix

impl StructuralEq for Matrix

impl StructuralPartialEq for Matrix