Struct polyhorn_ui::linalg::Transform3D

pub struct Transform3D<T> {
    pub columns: [[T; 4]; 4],
}

Rank 4 row-major transformation matrix for 3D objects.

Fields

columns: [[T; 4]; 4]

This field contains the entries of this matrix in column-major order.

Implementations

impl<T> Transform3D<T>

pub fn new(columns: [[T; 4]; 4]) -> Transform3D<T>

Returns a new transformation matrix with the given entries in row-major order. This function does not perform any kind of validation on the given entries. It is the caller's responsibility to ensure that the given entries result in a valid transformation matrix.

pub fn map<F, O>(self, op: F) -> Transform3D<O> where
    F: FnMut(T) -> O, 

Applies the given transformation to each entry in the transformation matrix individually.

impl<T> Transform3D<T> where
    T: Float, 

pub fn identity() -> Transform3D<T>

Returns a new identity matrix, i.e. a matrix of zeros with ones on the diagonal.

pub fn with_perspective(d: T) -> Transform3D<T>

Returns a new transformation matrix for a perspective with the given depth.

pub fn with_translation(tx: T, ty: T, tz: T) -> Transform3D<T>

Returns a new transformation matrix for a translation with the given offsets.

pub fn with_scale(sx: T, sy: T, sz: T) -> Transform3D<T>

Returns a new transformation matrix for a scale with the given factors.

pub fn with_skew_x(sx: T) -> Transform3D<T>

Returns a new transformation matrix for a horizontal skew with the given angle radians.

pub fn with_skew_y(sy: T) -> Transform3D<T>

Returns a new transformation matrix for a vertical skew with the given angle radians.

pub fn with_rotation(q: Quaternion3D<T>) -> Transform3D<T>

Returns a new transformation matrix for a counter-clockwise rotation with the given angle radians around the given vector. The given vector does not have to be a unit vector. If it is not a unit vector, this function will normalize and and multiply the angle with the original norm.

pub fn translate(self, tx: T, ty: T, tz: T) -> Transform3D<T>

Translates the given transformation matrix with the given offsets by concatenating the given matrix to a new translation matrix.

pub fn scale(self, sx: T, sy: T, sz: T) -> Transform3D<T>

Scales the given transformation matrix with the given factors by concatenating the given matrix to a new scale matrix.

pub fn rotate(self, q: Quaternion3D<T>) -> Transform3D<T>

Rotates the given transformation matrix with the given angle in radians around the given vector. The rotation is counter-clockwise and if the given vector is not unit, it will be normalized and the angle will be multiplied with the length of the original vector.

pub fn concat(self, other: Transform3D<T>) -> Transform3D<T>

Concatenates the given transformation matrix to the current transformation matrix.

pub fn apply(self, point: Point3D<T>) -> Point3D<T>

Applies the given transformation matrix to a point.

pub fn multiply_scalar(self, scalar: T) -> Transform3D<T>

Multiplies every element of this transformation with the given scalar and returns the result.

Trait Implementations

impl<T: Clone> Clone for Transform3D<T>

pub fn clone(&self) -> Transform3D<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Copy> Copy for Transform3D<T>

impl<T: Debug> Debug for Transform3D<T>

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

Formats the value using the given formatter.

impl<T> Default for Transform3D<T> where
    T: Float, 

pub fn default() -> Self

Returns the "default value" for a type.

impl<T> Eq for Transform3D<T> where
    T: Float, 

impl<T> PartialEq<Transform3D<T>> for Transform3D<T> where
    T: Float, 

pub fn eq(&self, other: &Transform3D<T>) -> bool

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

#[must_use]pub fn ne(&self, other: &Rhs) -> bool

This method tests for !=.