zng_layout::unit::euclid::default

Type Alias Transform3D

Help

pub type Transform3D<T> = Transform3D<T, UnknownUnit, UnknownUnit>;

Aliased Type§

struct Transform3D<T> {Show 16 fields
    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,
}

Fields§

§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

Implementations

impl<T, Src, Dst> Transform3D<T, Src, Dst>

pub const fn new( 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, ) -> Transform3D<T, Src, Dst>

Create a transform specifying all of it’s component as a 4 by 4 matrix.

Components are specified following column-major-column-vector matrix notation. For example, the translation terms m41, m42, m43 are the 13rd, 14th and 15th parameters.

use euclid::default::Transform3D;
let tx = 1.0;
let ty = 2.0;
let tz = 3.0;
let translation = Transform3D::new(
  1.0, 0.0, 0.0, 0.0,
  0.0, 1.0, 0.0, 0.0,
  0.0, 0.0, 1.0, 0.0,
  tx,  ty,  tz,  1.0,
);

pub fn new_2d( m11: T, m12: T, m21: T, m22: T, m41: T, m42: T, ) -> Transform3D<T, Src, Dst>
where T: Zero + One,

Create a transform representing a 2d transformation from the components of a 2 by 3 matrix transformation.

Components follow the column-major-column-vector notation (m41 and m42 representing the translation terms).

m11  m12   0   0
m21  m22   0   0
  0    0   1   0
m41  m42   0   1

pub fn is_2d(&self) -> bool
where T: Zero + One + PartialEq,

Returns true if this transform can be represented with a Transform2D.

See https://drafts.csswg.org/css-transforms/#2d-transform

impl<T, Src, Dst> Transform3D<T, Src, Dst>
where T: Copy + Add<Output = T> + Mul<Output = T>,

Methods for apply transformations to objects

pub fn transform_point2d_homogeneous( &self, p: Point2D<T, Src>, ) -> HomogeneousVector<T, Dst>

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.

pub fn transform_point2d(&self, p: Point2D<T, Src>) -> Option<Point2D<T, Dst>>
where T: Div<Output = T> + Zero + PartialOrd,

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.

pub fn transform_vector2d(&self, v: Vector2D<T, Src>) -> Vector2D<T, 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.

pub fn transform_point3d_homogeneous( &self, p: Point3D<T, Src>, ) -> HomogeneousVector<T, 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.

pub fn transform_point3d(&self, p: Point3D<T, Src>) -> Option<Point3D<T, Dst>>
where T: Div<Output = T> + Zero + PartialOrd,

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.

pub fn transform_vector3d(&self, v: Vector3D<T, Src>) -> Vector3D<T, 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.

pub fn outer_transformed_rect( &self, rect: &Rect<T, Src>, ) -> Option<Rect<T, Dst>>
where T: Sub<Output = T> + Div<Output = T> + Zero + PartialOrd,

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.

pub fn outer_transformed_box2d( &self, b: &Box2D<T, Src>, ) -> Option<Box2D<T, Dst>>
where T: Sub<Output = T> + Div<Output = T> + Zero + PartialOrd,

Returns a 2d box that encompasses the result of transforming the given box by this transform, if the transform makes sense for it, or None otherwise.

pub fn outer_transformed_box3d( &self, b: &Box3D<T, Src>, ) -> Option<Box3D<T, Dst>>
where T: Sub<Output = T> + Div<Output = T> + Zero + PartialOrd,

Returns a 3d box that encompasses the result of transforming the given box by this transform, if the transform makes sense for it, or None otherwise.

impl<T, Src, Dst> Transform3D<T, Src, Dst>
where T: Copy + Add<Output = T> + Mul<Output = T>,

Methods for combining generic transformations

pub fn then<NewDst>( &self, other: &Transform3D<T, Dst, NewDst>, ) -> Transform3D<T, Src, NewDst>

Returns the multiplication of the two matrices such that mat’s transformation applies after self’s transformation.

Assuming row vectors, this is equivalent to self * mat

impl<T, Src, Dst> Transform3D<T, Src, Dst>
where T: Copy + Mul<Output = T> + Div<Output = T> + Zero + One + PartialEq,

pub fn project_to_2d(&self) -> Transform3D<T, Src, Dst>

Returns a projection of this transform in 2d space.

impl<T, Src, Dst> Transform3D<T, Src, Dst>
where T: Copy,

pub fn to_array(&self) -> [T; 16]

Returns an array containing this transform’s terms.

The terms are laid out in the same order as they are specified in Transform3D::new, that is following the column-major-column-vector matrix notation.

For example the translation terms are found on the 13th, 14th and 15th slots of the array.

pub fn to_array_transposed(&self) -> [T; 16]

Returns an array containing this transform’s terms transposed.

The terms are laid out in transposed order from the same order of Transform3D::new and Transform3D::to_array, that is following the row-major-column-vector matrix notation.

For example the translation terms are found at indices 3, 7 and 11 of the array.

pub fn to_arrays(&self) -> [[T; 4]; 4]

Equivalent to to_array with elements packed four at a time in an array of arrays.

pub fn to_arrays_transposed(&self) -> [[T; 4]; 4]

Equivalent to to_array_transposed with elements packed four at a time in an array of arrays.

pub fn from_array(array: [T; 16]) -> Transform3D<T, Src, Dst>

Create a transform providing its components via an array of 16 elements instead of as individual parameters.

The order of the components corresponds to the column-major-column-vector matrix notation (the same order as Transform3D::new).

pub fn from_arrays(array: [[T; 4]; 4]) -> Transform3D<T, Src, Dst>

Equivalent to from_array with elements packed four at a time in an array of arrays.

The order of the components corresponds to the column-major-column-vector matrix notation (the same order as Transform3D::new).

pub fn from_untyped( m: &Transform3D<T, UnknownUnit, UnknownUnit>, ) -> Transform3D<T, Src, Dst>

Tag a unitless value with units.

pub fn to_untyped(&self) -> Transform3D<T, UnknownUnit, UnknownUnit>

Drop the units, preserving only the numeric value.

pub fn with_source<NewSrc>(&self) -> Transform3D<T, NewSrc, Dst>

Returns the same transform with a different source unit.

pub fn with_destination<NewDst>(&self) -> Transform3D<T, Src, NewDst>

Returns the same transform with a different destination unit.

pub fn to_2d(&self) -> Transform2D<T, Src, Dst>

Create a 2D transform picking the relevant terms from this transform.

This method assumes that self represents a 2d transformation, callers should check that is_2d returns true beforehand.

impl<T, Src, Dst> Transform3D<T, Src, Dst>
where T: Add<Output = T> + Sub<Output = T> + Mul<Output = T> + Div<Output = T> + Copy + Zero + One + Trig,

Methods for creating and combining rotation transformations

pub fn rotation(x: T, y: T, z: T, theta: Angle<T>) -> Transform3D<T, Src, Dst>

Create a 3d rotation transform from an angle / axis. The supplied axis must be normalized.

pub fn then_rotate( &self, x: T, y: T, z: T, theta: Angle<T>, ) -> Transform3D<T, Src, Dst>

Returns a transform with a rotation applied after self’s transformation.

pub fn pre_rotate( &self, x: T, y: T, z: T, theta: Angle<T>, ) -> Transform3D<T, Src, Dst>

Returns a transform with a rotation applied before self’s transformation.

impl<T, Src, Dst> Transform3D<T, Src, Dst>
where T: Sub<Output = T> + Mul<Output = T> + Div<Output = T> + Copy + Neg<Output = T> + Add<Output = T> + PartialOrd + One + Zero,

pub fn ortho( left: T, right: T, bottom: T, top: T, near: T, far: T, ) -> Transform3D<T, Src, Dst>

Create an orthogonal projection transform.

pub fn is_backface_visible(&self) -> bool

Check whether shapes on the XY plane with Z pointing towards the screen transformed by this matrix would be facing back.

pub fn is_invertible(&self) -> bool

Returns whether it is possible to compute the inverse transform.

pub fn inverse(&self) -> Option<Transform3D<T, Dst, Src>>

Returns the inverse transform if possible.

pub fn determinant(&self) -> T

Compute the determinant of the transform.

pub fn mul_s(&self, x: T) -> Transform3D<T, Src, Dst>

Multiplies all of the transform’s component by a scalar and returns the result.

pub fn from_scale(scale: Scale<T, Src, Dst>) -> Transform3D<T, Src, Dst>

Convenience function to create a scale transform from a Scale.

impl<T, Src, Dst> Transform3D<T, Src, Dst>
where T: NumCast + Copy,

pub fn cast<NewT>(&self) -> Transform3D<NewT, Src, Dst>
where NewT: NumCast,

Cast from one numeric representation to another, preserving the units.

pub fn try_cast<NewT>(&self) -> Option<Transform3D<NewT, Src, Dst>>
where NewT: NumCast,

Fallible cast from one numeric representation to another, preserving the units.

impl<T, Src, Dst> Transform3D<T, Src, Dst>
where T: ApproxEq<T>,

pub fn approx_eq(&self, other: &Transform3D<T, Src, Dst>) -> bool

Returns true if this transform is approximately equal to the other one, using T’s default epsilon value.

The same as ApproxEq::approx_eq but available without importing trait.

pub fn approx_eq_eps(&self, other: &Transform3D<T, Src, Dst>, eps: &T) -> bool

Returns true if this transform is approximately equal to the other one, using a provided epsilon value.

The same as ApproxEq::approx_eq_eps but available without importing trait.

impl<T, Src, Dst> Transform3D<T, Src, Dst>
where T: Zero + One,

pub fn identity() -> Transform3D<T, Src, Dst>

Creates an identity matrix:

pub fn skew(alpha: Angle<T>, beta: Angle<T>) -> Transform3D<T, Src, Dst>
where T: Trig,

Create a 2d skew transform.

See https://drafts.csswg.org/css-transforms/#funcdef-skew

pub fn perspective(d: T) -> Transform3D<T, Src, Dst>
where T: Neg<Output = T> + Div<Output = T>,

Create a simple perspective transform, projecting to the plane z = -d.

1   0   0   0
0   1   0   0
0   0   1 -1/d
0   0   0   1

See https://drafts.csswg.org/css-transforms-2/#PerspectiveDefined.

impl<T, Src, Dst> Transform3D<T, Src, Dst>
where T: Zero + One,

Methods for creating and combining scale transformations

pub fn scale(x: T, y: T, z: T) -> Transform3D<T, Src, Dst>

Create a 3d scale transform:

pub fn pre_scale(&self, x: T, y: T, z: T) -> Transform3D<T, Src, Dst>
where T: Copy + Add<Output = T> + Mul<Output = T>,

Returns a transform with a scale applied before self’s transformation.

pub fn then_scale(&self, x: T, y: T, z: T) -> Transform3D<T, Src, Dst>
where T: Copy + Add<Output = T> + Mul<Output = T>,

Returns a transform with a scale applied after self’s transformation.

impl<T, Src, Dst> Transform3D<T, Src, Dst>
where T: Zero + One,

Methods for creating and combining translation transformations

pub fn translation(x: T, y: T, z: T) -> Transform3D<T, Src, Dst>

Create a 3d translation transform:

pub fn pre_translate(&self, v: Vector3D<T, Src>) -> Transform3D<T, Src, Dst>
where T: Copy + Add<Output = T> + Mul<Output = T>,

Returns a transform with a translation applied before self’s transformation.

pub fn then_translate(&self, v: Vector3D<T, Dst>) -> Transform3D<T, Src, Dst>
where T: Copy + Add<Output = T> + Mul<Output = T>,

Returns a transform with a translation applied after self’s transformation.

Trait Implementations

impl<T, Src, Dst> ApproxEq<T> for Transform3D<T, Src, Dst>
where T: ApproxEq<T>,

fn approx_epsilon() -> T

Default epsilon value

fn approx_eq_eps(&self, other: &Transform3D<T, Src, Dst>, eps: &T) -> bool

Returns true if this object is approximately equal to the other one, using a provided epsilon value.

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

Returns true if this object is approximately equal to the other one, using the approx_epsilon epsilon value.

impl<T, Src, Dst> Clone for Transform3D<T, Src, Dst>
where T: Clone,

fn clone(&self) -> Transform3D<T, Src, Dst>

Returns a copy of the value. Read more

1.0.0 · Source§

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

Performs copy-assignment from source. Read more

impl<T, Src, Dst> Debug for Transform3D<T, Src, Dst>
where T: Copy + Debug + PartialEq + One + Zero,

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

Formats the value using the given formatter. Read more

impl<T, Src, Dst> Default for Transform3D<T, Src, Dst>
where T: Zero + One,

fn default() -> Transform3D<T, Src, Dst>

Returns the identity transform.

impl<'de, T, Src, Dst> Deserialize<'de> for Transform3D<T, Src, Dst>
where T: Deserialize<'de>,

fn deserialize<D>( deserializer: D, ) -> Result<Transform3D<T, Src, Dst>, <D as Deserializer<'de>>::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more

impl<T, Src, Dst> From<Translation3D<T, Src, Dst>> for Transform3D<T, Src, Dst>
where T: Zero + One,

fn from(t: Translation3D<T, Src, Dst>) -> Transform3D<T, Src, Dst>

Converts to this type from the input type.

impl<T, Src, Dst> Hash for Transform3D<T, Src, Dst>
where T: Hash,

fn hash<H>(&self, h: &mut H)
where H: Hasher,

Feeds this value into the given Hasher. Read more

1.3.0 · Source§

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

Feeds a slice of this type into the given Hasher. Read more

impl<T, Src, Dst> PartialEq for Transform3D<T, Src, Dst>
where T: PartialEq,

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

Tests for self and other values to be equal, and is used by ==.

1.0.0 · Source§

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

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

impl<T, Src, Dst> Serialize for Transform3D<T, Src, Dst>
where T: Serialize,

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>
where S: Serializer,

Serialize this value into the given Serde serializer. Read more

impl<T, Src, Dst> Zeroable for Transform3D<T, Src, Dst>
where T: Zeroable,

fn zeroed() -> Self

Calls zeroed. Read more

impl<T, Src, Dst> Copy for Transform3D<T, Src, Dst>
where T: Copy,

impl<T, Src, Dst> Eq for Transform3D<T, Src, Dst>
where T: Eq,

impl<T, Src, Dst> Pod for Transform3D<T, Src, Dst>
where T: Pod, Src: 'static, Dst: 'static,