Struct Mat3 

pub struct Mat3 {
    pub a: f64,
    pub b: f64,
    pub c: f64,
    pub d: f64,
    pub e: f64,
    pub f: f64,
    pub g: f64,
    pub h: f64,
    pub i: f64,
}

a 3×3 matrix of f64 values.

The matrix is stored in row-major order:

| a  b  c |
| c  d  e |
| g  h  i |

Fields

a: f64

First row, first column element.

b: f64

First row, second column element.

c: f64

First row, third column element.

d: f64

Second row, first column element.

e: f64

Second row, second column element.

f: f64

Second row, third column element.

g: f64

Third row, first column element.

h: f64

Third row, second column element.

i: f64

Third row, third column element.

Implementations

impl Mat3

pub const fn new( a: f64, b: f64, c: f64, d: f64, e: f64, f: f64, g: f64, h: f64, i: f64, ) -> Mat3

impl Mat3

pub const IDENTITY: Mat3

The identity matrix:

| 1  0  0 |
| 0  1  0 |
| 0  0  1 |

pub const ZERO: Mat3

The zero matrix:

| 0  0  0 |
| 0  0  0 |
| 0  0  0 |

pub fn determinant(&self) -> f64

Returns the determinant of the matrix.

Computed as: [ \det(M) = a(ei - fh) - b(di - fg) + c(dh - eg) ]

Examples

use lars::Mat3;
let m = Mat3::new(1.0, 2.0, 3.0, 3.0, 2.0, 1.0, 2.0, 1.0, 3.0);
assert_eq!(m.determinant(), -12.0);

pub fn inverse(&self) -> Mat3

Returns the inverse of the matrix, if it exists.

Computed as: M⁻¹ = (1/det(M)) * adj(M) / 1 | ei - fh ch - bi bf - ce | M⁻¹ = —–– x | fg - di ai - cg cd - af | det(M) | dh - eg bg - ah ae - bd |

Panics

Panics if the matrix is singular (determinant = 0).

Examples

use lars::Mat3;
let m = Mat3::new(1.0, 2.0, 3.0, 3.0, 2.0, 1.0, 2.0, 1.0, 3.0);
assert_eq!(m.inverse(), Mat3::new(-5.0, 3.0, 4.0, 7.0, 3.0, -8.0, 1.0, -3.0, 4.0)/12.0);

Trait Implementations

impl Add for Mat3

type Output = Mat3

The resulting type after applying the + operator.

fn add(self, rhs: Mat3) -> Mat3

Performs the + operation.

impl Clone for Mat3

fn clone(&self) -> Mat3

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Mat3

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

Formats the value using the given formatter.

impl<__RhsT: Copy> Div<__RhsT> for Mat3

where f64: Div<__RhsT, Output = f64>,

type Output = Mat3

The resulting type after applying the / operator.

fn div(self, rhs: __RhsT) -> Mat3

Performs the / operation.

impl Mul<Mat3> for Vec3

type Output = Vec3

The resulting type after applying the * operator.

fn mul(self, rhs: Mat3) -> Vec3

Performs the * operation.

impl Mul<Vec3> for Mat3

type Output = Vec3

The resulting type after applying the * operator.

fn mul(self, rhs: Vec3) -> Vec3

Performs the * operation.

impl Mul for Mat3

type Output = Mat3

The resulting type after applying the * operator.

fn mul(self, rhs: Mat3) -> Mat3

Performs the * operation.

impl PartialEq for Mat3

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

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

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 PartialOrd for Mat3

fn partial_cmp(&self, other: &Mat3) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Sub for Mat3

type Output = Mat3

The resulting type after applying the - operator.

fn sub(self, rhs: Mat3) -> Mat3

Performs the - operation.

impl Copy for Mat3