Struct pdbtbx::TransformationMatrix

pub struct TransformationMatrix { /* private fields */ }

A 3D affine transformation matrix

Implementations

impl TransformationMatrix

pub const fn matrix(&self) -> [[f64; 4]; 3]

Get the raw matrix (row major order)

pub fn matrix_mut(&mut self) -> &mut [[f64; 4]; 3]

Get the raw matrix (row major order)

pub fn set_matrix(&mut self, new_matrix: [[f64; 4]; 3])

Set the raw matrix (row major order), the user needs to make sure the matrix is valid

pub const fn identity() -> Self

Create a matrix defining identity, so no transformation

pub const fn from_matrix(matrix: [[f64; 4]; 3]) -> Self

Create a matrix with the given matrix

pub fn rotation_x(deg: f64) -> Self

Create a matrix defining a rotation around the X axis

Arguments

• deg the rotation in degrees

Panics

It panics if deg is not finite (f64.is_finite())

pub fn rotation_y(deg: f64) -> Self

Create a matrix defining a rotation around the Y axis

Arguments

• deg the rotation in degrees

Panics

It panics if deg is not finite (f64.is_finite())

pub fn rotation_z(deg: f64) -> Self

Create a matrix defining a rotation around the Z axis

Arguments

• deg the rotation in degrees

Panics

It panics if deg is not finite (f64.is_finite())

pub fn translation(x: f64, y: f64, z: f64) -> Self

Create a matrix defining a translation

Panics

It panics if any of the arguments is not finite (f64.is_finite())

pub fn magnify(f: f64) -> Self

Create a matrix defining a magnification

Arguments

• f the factor where 1.0 is the original size

Panics

It panics if f is not finite (f64.is_finite())

pub fn scale(x: f64, y: f64, z: f64) -> Self

Create a matrix defining a magnification with three different factors

Arguments

• x the factor for the x dimension where 1.0 is the original size
• y the factor for the y dimension where 1.0 is the original size
• z the factor for the z dimension where 1.0 is the original size

Panics

It panics if any of the arguments is not finite (f64.is_finite())

pub fn multiply_translation(&mut self, factors: (f64, f64, f64))

This multiplies the translation with the given factors, this can be used to convert fractional units into absolute units.

pub fn apply(&self, pos: (f64, f64, f64)) -> (f64, f64, f64)

Apply this transformation to the given position. It returns the new position.

Arguments

• pos the position (x, y, z)

pub fn combine(&self, other: &Self) -> Self

Combine this transformation with another transformation to deliver a new transformation. This transformation is applied before the other transformation.

Trait Implementations

impl Clone for TransformationMatrix

fn clone(&self) -> TransformationMatrix

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TransformationMatrix

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TransformationMatrix

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq<TransformationMatrix> for TransformationMatrix

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for TransformationMatrix