Struct euler::Mat4

#[repr(C)]
pub struct Mat4 {

    pub m00: f32,
    pub m01: f32,
    pub m02: f32,
    pub m03: f32,
    pub m10: f32,
    pub m11: f32,
    pub m12: f32,
    pub m13: f32,
    pub m20: f32,
    pub m21: f32,
    pub m22: f32,
    pub m23: f32,
    pub m30: f32,
    pub m31: f32,
    pub m32: f32,
    pub m33: f32,
}

Single-precision 2x2 column major matrix.

Fields

m00: f32

m01: f32

m02: f32

m03: f32

m10: f32

m11: f32

m12: f32

m13: f32

m20: f32

m21: f32

m22: f32

m23: f32

m30: f32

m31: f32

m32: f32

m33: f32

Implementations

impl Mat4

pub fn new( m00: f32, m01: f32, m02: f32, m03: f32, m10: f32, m11: f32, m12: f32, m13: f32, m20: f32, m21: f32, m22: f32, m23: f32, m30: f32, m31: f32, m32: f32, m33: f32 ) -> Self

Full constructor.

pub fn identity() -> Self

Identity constructor.

pub fn diagonal(di: f32) -> Self

Diagonal constructor.

pub fn tridiagonal(lo: f32, di: f32, up: f32) -> Self

Tri-diagonal constructor.

impl Mat4

pub fn determinant(self) -> f32

Computes the matrix determinant.

pub fn trace(self) -> f32

Computes the matrix trace.

pub fn inverse(self) -> Mat4

Computes the matrix inverse.

Panics

Panics if the matrix has no inverse (i.e. has zero determinant).

Examples found in repository

examples/unproject.rs (line 8)

fn unproject_single_precision(ndc: euler::Vec2) -> euler::Vec3 {
    let projection = mat4!();
    let inverse_projection = projection.inverse();
    let eye = inverse_projection * vec4!(ndc, -1.0, 1.0);
    let view = euler::Trs::new(
        vec3!(1, 0, -1),
        quat!(1, 0, 0; f32::consts::PI / 2.0),
        vec3!(1.0),
    )
    .matrix();
    let inverse_view = view.inverse();
    let world = inverse_view * vec4!(eye.xy(), -1.0, 0.0);
    let ray = world.xyz().normalize();
    ray
}

pub fn transpose(self) -> Mat4

Returns the matrix transpose.

pub fn try_invert(self) -> Option<Mat4>

Attempts to compute the matrix inverse, returning None if the matrix is non-invertible (i.e. has zero determinant).

Trait Implementations

impl Add<Mat4> for Mat4

type Output = Mat4

The resulting type after applying the + operator.

fn add(self, rhs: Mat4) -> Self::Output

Performs the + operation.

impl ApproxEq for Mat4

type Epsilon = <Matrix4<f32> as ApproxEq>::Epsilon

Used for specifying relative comparisons.

fn default_epsilon() -> Self::Epsilon

The default tolerance to use when testing values that are close together.

fn default_max_relative() -> Self::Epsilon

The default relative tolerance for testing values that are far-apart.

fn default_max_ulps() -> u32

The default ULPs to tolerate when testing values that are far-apart.

fn relative_eq( &self, other: &Self, epsilon: Self::Epsilon, max_relative: Self::Epsilon ) -> bool

A test for equality that uses a relative comparison if the values are far apart.

fn ulps_eq(&self, other: &Self, epsilon: Self::Epsilon, max_ulps: u32) -> bool

A test for equality that uses units in the last place (ULP) if the values are far apart.

fn relative_ne( &self, other: &Self, epsilon: Self::Epsilon, max_relative: Self::Epsilon ) -> bool

The inverse of ApproxEq::relative_eq.

fn ulps_ne(&self, other: &Self, epsilon: Self::Epsilon, max_ulps: u32) -> bool

The inverse of ApproxEq::ulps_eq.

impl AsRef<[[f32; 4]; 4]> for Mat4

fn as_ref(&self) -> &[[f32; 4]; 4]

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Mat4

fn clone(&self) -> Mat4

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Mat4

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

Formats the value using the given formatter.

impl Default for Mat4

fn default() -> Self

Returns the “default value” for a type.

impl Display for Mat4

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

Formats the value using the given formatter.

impl From<[[f32; 4]; 4]> for Mat4

fn from(array: [[f32; 4]; 4]) -> Self

Converts to this type from the input type.

impl From<DMat2> for Mat4

fn from(arg: DMat2) -> Self

Converts to this type from the input type.

impl From<DMat3> for Mat4

fn from(arg: DMat3) -> Self

Converts to this type from the input type.

impl From<DMat4> for Mat4

fn from(arg: DMat4) -> Self

Converts to this type from the input type.

impl From<Mat2> for Mat4

fn from(arg: Mat2) -> Self

Converts to this type from the input type.

impl From<Mat3> for Mat4

fn from(arg: Mat3) -> Self

Converts to this type from the input type.

impl From<Mat4> for DMat2

fn from(arg: Mat4) -> Self

Converts to this type from the input type.

impl From<Mat4> for DMat3

fn from(arg: Mat4) -> Self

Converts to this type from the input type.

impl From<Mat4> for DMat4

fn from(arg: Mat4) -> Self

Converts to this type from the input type.

impl From<Mat4> for Mat2

fn from(arg: Mat4) -> Self

Converts to this type from the input type.

impl From<Mat4> for Mat3

fn from(arg: Mat4) -> Self

Converts to this type from the input type.

impl From<f32> for Mat4

fn from(arg: f32) -> Self

Converts to this type from the input type.

impl From<f64> for Mat4

fn from(arg: f64) -> Self

Converts to this type from the input type.

impl Into<[[f32; 4]; 4]> for Mat4

fn into(self) -> [[f32; 4]; 4]

Converts this type into the (usually inferred) input type.

impl Mul<Mat4> for Mat4

type Output = Mat4

The resulting type after applying the * operator.

fn mul(self, rhs: Mat4) -> Self::Output

Performs the * operation.

impl Mul<Mat4> for f32

type Output = Mat4

The resulting type after applying the * operator.

fn mul(self, rhs: Mat4) -> Self::Output

Performs the * operation.

impl<'a> Mul<Vec4> for &'a Mat4

type Output = Vec4

The resulting type after applying the * operator.

fn mul(self, rhs: Vec4) -> Self::Output

Performs the * operation.

impl Mul<Vec4> for Mat4

type Output = Vec4

The resulting type after applying the * operator.

fn mul(self, rhs: Vec4) -> Self::Output

Performs the * operation.

impl Mul<f32> for Mat4

type Output = Mat4

The resulting type after applying the * operator.

fn mul(self, rhs: f32) -> Self::Output

Performs the * operation.

impl PartialEq<Mat4> for Mat4

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

type Output = Mat4

The resulting type after applying the - operator.

fn sub(self, rhs: Mat4) -> Self::Output

Performs the - operation.

impl Copy for Mat4

impl StructuralPartialEq for Mat4