Struct pdfium_render::matrix::PdfMatrix

pub struct PdfMatrix {
    pub a: PdfMatrixValue,
    pub b: PdfMatrixValue,
    pub c: PdfMatrixValue,
    pub d: PdfMatrixValue,
    pub e: PdfMatrixValue,
    pub f: PdfMatrixValue,
}

Six floating-point values that represent the six configurable elements of a nine-element 3x3 PDF transformation matrix.

Applying the matrix to any transformable object containing a set_matrix() function - such as a page, clip path, individual page object, or page object group - will result in a transformation of that object. Depending on the values specified in the matrix, the object can be moved, scaled, rotated, or skewed.

It is rare that a matrix needs to be used directly. All transformable objects provide convenient and expressive access to the most commonly used transformation operations without requiring a matrix.

However, a matrix can be convenient when the same transformation values need to be applied to a large set of transformable objects.

An overview of PDF transformation matrices can be found in the PDF Reference Manual version 1.7 on page 204; a detailed description can be founded in section 4.2.3 on page 207.

Fields

a: PdfMatrixValue

b: PdfMatrixValue

c: PdfMatrixValue

d: PdfMatrixValue

e: PdfMatrixValue

f: PdfMatrixValue

Implementations

impl PdfMatrix

pub const ZERO: PdfMatrix = _

A PdfMatrix object with all matrix values set to 0.0.

pub const IDENTITY: PdfMatrix = _

A PdfMatrix object with matrix values a and d set to 1.0 and all other values set to 0.0.

pub const fn new( a: PdfMatrixValue, b: PdfMatrixValue, c: PdfMatrixValue, d: PdfMatrixValue, e: PdfMatrixValue, f: PdfMatrixValue ) -> Self

Creates a new PdfMatrix with the given matrix values.

pub const fn zero() -> Self

Creates a new PdfMatrix object with all matrix values set to 0.0.

The return value of this function is identical to the constant PdfMatrix::ZERO.

pub const fn identity() -> Self

Creates a new PdfMatrix object with matrix values a and d set to 1.0 and all other values set to 0.0.

The return value of this function is identical to the constant PdfMatrix::IDENTITY.

pub fn transform( self, a: PdfMatrixValue, b: PdfMatrixValue, c: PdfMatrixValue, d: PdfMatrixValue, e: PdfMatrixValue, f: PdfMatrixValue ) -> Result<Self, PdfiumError>

Applies the given transformation, expressed as six values representing the six configurable elements of a nine-element 3x3 PDF transformation matrix, to this PdfMatrix.

To move, scale, rotate, or skew this PdfMatrix, consider using one or more of the following functions. Internally they all use Self::transform(), but are probably easier to use (and certainly clearer in their intent) in most situations.

• Self::translate(): changes the position of this PdfMatrix.
• Self::scale(): changes the size of this PdfMatrix.
• Self::rotate_clockwise_degrees(), Self::rotate_counter_clockwise_degrees(), Self::rotate_clockwise_radians(), Self::rotate_counter_clockwise_radians(): rotates this PdfMatrix around its origin.
• Self::skew_degrees(), Self::skew_radians(): skews this PdfMatrix relative to its axes.

The order in which transformations are applied is significant. For example, the result of rotating then translating an object may be vastly different from translating then rotating the same object.

An overview of PDF transformation matrices can be found in the PDF Reference Manual version 1.7 on page 204; a detailed description can be founded in section 4.2.3 on page 207.

pub fn set_matrix(self, matrix: PdfMatrix) -> Result<Self, PdfiumError>

Applies the values in the given PdfMatrix to this PdfMatrix.

pub fn translate( self, delta_x: PdfPoints, delta_y: PdfPoints ) -> Result<Self, PdfiumError>

Moves the origin of this PdfMatrix by the given horizontal and vertical delta distances.

pub fn scale( self, horizontal_scale_factor: PdfMatrixValue, vertical_scale_factor: PdfMatrixValue ) -> Result<Self, PdfiumError>

Changes the size of this PdfMatrix, scaling it by the given horizontal and vertical scale factors.

pub fn flip_horizontally(self) -> Result<Self, PdfiumError>

Flips this PdfMatrix horizontally around its origin by applying a horizontal scale factor of -1.

pub fn flip_vertically(self) -> Result<Self, PdfiumError>

Flips this PdfMatrix vertically around its origin by applying a vertical scale factor of -1.

pub fn reflect(self) -> Result<Self, PdfiumError>

Reflects this PdfMatrix by flipping it both horizontally and vertically around its origin.

pub fn rotate_counter_clockwise_degrees( self, degrees: PdfMatrixValue ) -> Result<Self, PdfiumError>

Rotates this PdfMatrix counter-clockwise by the given number of degrees.

pub fn rotate_clockwise_degrees( self, degrees: PdfMatrixValue ) -> Result<Self, PdfiumError>

Rotates this PdfMatrix clockwise by the given number of degrees.

pub fn rotate_counter_clockwise_radians( self, radians: PdfMatrixValue ) -> Result<Self, PdfiumError>

Rotates this PdfMatrix counter-clockwise by the given number of radians.

pub fn rotate_clockwise_radians( self, radians: PdfMatrixValue ) -> Result<Self, PdfiumError>

Rotates this PdfMatrix clockwise by the given number of radians.

pub fn skew_degrees( self, x_axis_skew: PdfMatrixValue, y_axis_skew: PdfMatrixValue ) -> Result<Self, PdfiumError>

Skews the axes of this PdfMatrix by the given angles in degrees.

pub fn skew_radians( self, x_axis_skew: PdfMatrixValue, y_axis_skew: PdfMatrixValue ) -> Result<Self, PdfiumError>

Skews the axes of this PdfMatrix by the given angles in radians.

pub fn matrix(&self) -> Result<PdfMatrix, PdfiumError>

Returns the transformation matrix currently applied to this PdfMatrix.

pub fn get_translation(&self) -> (PdfPoints, PdfPoints)

Returns the current horizontal and vertical translation of the origin of this PdfMatrix.

pub fn get_horizontal_translation(&self) -> PdfPoints

Returns the current horizontal translation of the origin of this PdfMatrix.

pub fn get_vertical_translation(&self) -> PdfPoints

Returns the current vertical translation of the origin of this PdfMatrix.

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

Returns the current horizontal and vertical scale factors applied to this PdfMatrix.

pub fn get_horizontal_scale(&self) -> PdfMatrixValue

Returns the current horizontal scale factor applied to this PdfMatrix.

pub fn get_vertical_scale(&self) -> PdfMatrixValue

Returns the current vertical scale factor applied to this PdfMatrix.

pub fn get_rotation_counter_clockwise_degrees(&self) -> PdfMatrixValue

Returns the counter-clockwise rotation applied to this PdfMatrix, in degrees.

If the object is both rotated and skewed, the return value of this function will reflect the combined operation.

pub fn get_rotation_clockwise_degrees(&self) -> PdfMatrixValue

Returns the clockwise rotation applied to this PdfMatrix, in degrees.

If the object is both rotated and skewed, the return value of this function will reflect the combined operation.

pub fn get_rotation_counter_clockwise_radians(&self) -> PdfMatrixValue

Returns the counter-clockwise rotation applied to this PdfMatrix, in radians.

If the object is both rotated and skewed, the return value of this function will reflect the combined operation.

pub fn get_rotation_clockwise_radians(&self) -> PdfMatrixValue

Returns the clockwise rotation applied to this PdfMatrix, in radians.

If the object is both rotated and skewed, the return value of this function will reflect the combined operation.

pub fn get_skew_degrees(&self) -> (PdfMatrixValue, PdfMatrixValue)

Returns the current x axis and y axis skew angles applied to this PdfMatrix, in degrees.

If the object is both rotated and skewed, the return value of this function will reflect the combined operation.

pub fn get_x_axis_skew_degrees(&self) -> PdfMatrixValue

Returns the current x axis skew angle applied to this PdfMatrix, in degrees.

If the object is both rotated and skewed, the return value of this function will reflect the combined operation.

pub fn get_y_axis_skew_degrees(&self) -> PdfMatrixValue

Returns the current y axis skew applied to this PdfMatrix, in degrees.

If the object is both rotated and skewed, the return value of this function will reflect the combined operation.

pub fn get_skew_radians(&self) -> (PdfMatrixValue, PdfMatrixValue)

Returns the current x axis and y axis skew angles applied to this PdfMatrix, in radians.

If the object is both rotated and skewed, the return value of this function will reflect the combined operation.

pub fn get_x_axis_skew_radians(&self) -> PdfMatrixValue

Returns the current x axis skew applied to this PdfMatrix, in radians.

If the object is both rotated and skewed, the return value of this function will reflect the combined operation.

pub fn get_y_axis_skew_radians(&self) -> PdfMatrixValue

Returns the current y axis skew applied to this PdfMatrix, in radians.

If the object is both rotated and skewed, the return value of this function will reflect the combined operation.

Trait Implementations

impl Clone for PdfMatrix

fn clone(&self) -> PdfMatrix

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PdfMatrix

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

Formats the value using the given formatter.

impl Hash for PdfMatrix

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq<PdfMatrix> for PdfMatrix

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

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for PdfMatrix

impl Eq for PdfMatrix