#[repr(C)]
pub struct TypedTransform3D<T, Src, Dst> {
pub m11: T,
pub m12: T,
pub m13: T,
pub m14: T,
pub m21: T,
pub m22: T,
pub m23: T,
pub m24: T,
pub m31: T,
pub m32: T,
pub m33: T,
pub m34: T,
pub m41: T,
pub m42: T,
pub m43: T,
pub m44: T,
// some fields omitted
}
A 3d transform stored as a 4 by 4 matrix in row-major order in memory.
Transforms can be parametrized over the source and destination units, to describe a
transformation from a space to another.
For example, TypedTransform3D<f32, WorldSpace, ScreenSpace>::transform_point3d
takes a TypedPoint3D<f32, WorldSpace>
and returns a TypedPoint3D<f32, ScreenSpace>
.
Transforms expose a set of convenience methods for pre- and post-transformations.
A pre-transformation corresponds to adding an operation that is applied before
the rest of the transformation, while a post-transformation adds an operation
that is applied after.
pub fn row_major( m11: T, m12: T, m13: T, m14: T, m21: T, m22: T, m23: T, m24: T, m31: T, m32: T, m33: T, m34: T, m41: T, m42: T, m43: T, m44: T ) -> TypedTransform3D<T, Src, Dst> | |
Create a transform specifying its components in row-major order.
For example, the translation terms m41, m42, m43 on the last row with the
row-major convention) are the 13rd, 14th and 15th parameters.
pub fn column_major( m11: T, m21: T, m31: T, m41: T, m12: T, m22: T, m32: T, m42: T, m13: T, m23: T, m33: T, m43: T, m14: T, m24: T, m34: T, m44: T ) -> TypedTransform3D<T, Src, Dst> | |
Create a transform specifying its components in column-major order.
For example, the translation terms m41, m42, m43 on the last column with the
column-major convention) are the 4th, 8th and 12nd parameters.
Create a 4 by 4 transform representing a 2d transformation, specifying its components
in row-major order.
Create an orthogonal projection transform.
Create a 2D transform picking the relevant terms from this transform.
This method assumes that self represents a 2d transformation, callers
should check that self.is_2d() returns true beforehand.
Check whether shapes on the XY plane with Z pointing towards the
screen transformed by this matrix would be facing back.
Returns the same transform with a different destination unit.
Returns the same transform with a different source unit.
Drop the units, preserving only the numeric value.
Tag a unitless value with units.
pub fn post_mul<NewDst>( &self, mat: &TypedTransform3D<T, Dst, NewDst> ) -> TypedTransform3D<T, Src, NewDst> | |
Returns the multiplication of the two matrices such that mat's transformation
applies after self's transformation.
Returns the multiplication of the two matrices such that mat's transformation
applies before self's transformation.
Returns the inverse transform if possible.
Compute the determinant of the transform.
Multiplies all of the transform's component by a scalar and returns the result.
Convenience function to create a scale transform from a TypedScale
.
Returns the homogeneous vector corresponding to the transformed 2d point.
The input point must be use the unit Src, and the returned point has the unit Dst.
Returns the given 2d point transformed by this transform, if the transform makes sense,
or None
otherwise.
The input point must be use the unit Src, and the returned point has the unit Dst.
Returns the given 2d vector transformed by this matrix.
The input point must be use the unit Src, and the returned point has the unit Dst.
Returns the homogeneous vector corresponding to the transformed 3d point.
The input point must be use the unit Src, and the returned point has the unit Dst.
Returns the given 3d point transformed by this transform, if the transform makes sense,
or None
otherwise.
The input point must be use the unit Src, and the returned point has the unit Dst.
Returns the given 3d vector transformed by this matrix.
The input point must be use the unit Src, and the returned point has the unit Dst.
Returns a rectangle that encompasses the result of transforming the given rectangle by this
transform, if the transform makes sense for it, or None
otherwise.
Create a 3d translation transform
Returns a transform with a translation applied before self's transformation.
pub fn post_translate( &self, v: TypedVector3D<T, Dst> ) -> TypedTransform3D<T, Src, Dst> | |
Returns a transform with a translation applied after self's transformation.
Returns a projection of this transform in 2d space.
Create a 3d scale transform
Returns a transform with a scale applied before self's transformation.
pub fn post_scale(&self, x: T, y: T, z: T) -> TypedTransform3D<T, Src, Dst> | |
Returns a transform with a scale applied after self's transformation.
Create a 3d rotation transform from an angle / axis.
The supplied axis must be normalized.
pub fn post_rotate( &self, x: T, y: T, z: T, theta: Angle<T> ) -> TypedTransform3D<T, Src, Dst> | |
Returns a transform with a rotation applied after self's transformation.
Returns a transform with a rotation applied before self's transformation.
Create a simple perspective projection transform
Returns an array containing this transform's terms in row-major order (the order
in which the transform is actually laid out in memory).
Returns an array containing this transform's terms in column-major order.
Returns an array containing this transform's 4 rows in (in row-major order)
as arrays.
This is a convenience method to interface with other libraries like glium.
Returns an array containing this transform's 4 columns in (in row-major order,
or 4 rows in column-major order) as arrays.
This is a convenience method to interface with other libraries like glium.
Creates a transform from an array of 16 elements in row-major order.
Creates a transform from 4 rows of 4 elements (row-major order).
Cast from one numeric representation to another, preserving the units.
Fallible cast from one numeric representation to another, preserving the units.
This method tests for self
and other
values to be equal, and is used by ==
. Read more
This method tests for !=
.
Returns the "default value" for a type. Read more
Performs copy-assignment from source
. Read more
Formats the value using the given formatter. Read more
Feeds this value into the given [Hasher
]. Read more
Feeds a slice of this type into the given [Hasher
]. Read more
Creates owned data from borrowed data, usually by cloning. Read more
🔬 This is a nightly-only experimental API. (toowned_clone_into
)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more
🔬 This is a nightly-only experimental API. (try_from
)
The type returned in the event of a conversion error.
🔬 This is a nightly-only experimental API. (try_from
)
🔬 This is a nightly-only experimental API. (get_type_id
)
this method will likely be replaced by an associated static