Struct hektor::Mat3

#[repr(C)]
pub struct Mat3 { /* fields omitted */ }

A 3x3 column-major Matrix.

There's three columns, and each column is itself a Vec3.

Methods

impl Mat3

Accessors

pub fn x_axis(self) -> Vec3

Obtains the x_axis column of this matrix

pub fn y_axis(self) -> Vec3

Obtains the y_axis column of this matrix

pub fn z_axis(self) -> Vec3

Obtains the z_axis column of this matrix

pub fn x_axis_mut(&mut self) -> &mut Vec3

&mut to the x_axis column of this matrix

pub fn y_axis_mut(&mut self) -> &mut Vec3

&mut to the y_axis column of this matrix

pub fn z_axis_mut(&mut self) -> &mut Vec3

&mut to the z_axis column of this matrix

impl Mat3

Constructors

pub fn new(x_axis: Vec3, y_axis: Vec3, z_axis: Vec3) -> Self

Combines the columns given into a new Mat3

pub fn splat(v: f32) -> Self

Splats the given value across all columns.

pub fn diagonal(x: f32, y: f32, z: f32) -> Self

Forms a diagonal matrix from the values given.

pub fn to_mat2(self) -> Mat2

Down-converts to a Mat2

pub fn to_mat4(self, w: f32) -> Mat4

Up-converts to a Mat4 by adding the given w as the w of the w_axis. The x_axis, y_axis, and z_axis are extended with 0.0

pub fn determinant(self) -> f32

Determinant of the matrix.

This gives the scale factor of a unit cube in the matrix's modified coordinate space:

• Positive means that the output orientation is generally similar.
• Negative means that the output orientation is flipped.
• Zero means that the output loses at least 1 dimension (meaning that cubes become squares, lines, or points).

pub fn transpose(self) -> Self

Transpose the matrix.

This "flips" it along the diagonal. The diagonal values stay the same.

pub fn inverse(self) -> Option<Self>

Gives the inverse matrix, if it exists.

m * m.inverse() and m.inverse() * m should both give an identity matrix as the output. As we all known, with floating point there's usually a little bit of rounding error possible so it may not work perfectly.

Failure

There's no inverse if the determinant is zero.

Trait Implementations

impl CanDeterminant for Mat3

fn determinant(self) -> f32

See determinant for info.

impl Display for Mat3

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

Display formats without labels in a 3 line style similar to standard math notation.

Passes the formatter along to the fields, so you can use any normal f32 Display format arguments that you like.

impl Debug for Mat3

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

Debug formats with each axis labeled and then shown as a 3-tuple in one long line.

Passes the formatter along to the fields, so you can use any normal f32 Debug format arguments that you like.

impl UpperExp for Mat3

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

UpperExp formats like Display, but with the upper exponent.

Passes the formatter along to the fields, so you can use any normal f32 UpperExp format arguments that you like.

impl LowerExp for Mat3

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

LowerExp formats like Display, but with the lower exponent.

Passes the formatter along to the fields, so you can use any normal f32 LowerExp format arguments that you like.

impl PartialEq<Mat3> for Mat3

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

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

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

This method tests for !=.

impl Add<Mat3> for Mat3

type Output = Self

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<f32> for Mat3

type Output = Self

The resulting type after applying the + operator.

fn add(self, rhs: f32) -> Self

Performs the + operation.

impl Add<Mat3> for f32

type Output = Mat3

The resulting type after applying the + operator.

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

Performs the + operation.

impl Sub<Mat3> for Mat3

type Output = Self

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<f32> for Mat3

type Output = Self

The resulting type after applying the - operator.

fn sub(self, rhs: f32) -> Self

Performs the - operation.

impl Sub<Mat3> for f32

type Output = Mat3

The resulting type after applying the - operator.

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

Performs the - operation.

impl Mul<f32> for Mat3

type Output = Self

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Mat3> for f32

type Output = Mat3

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Vec3> for Mat3

type Output = Vec3

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Mat3> for Mat3

type Output = Self

The resulting type after applying the * operator.

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

Performs the * operation.

impl Neg for Mat3

type Output = Self

The resulting type after applying the - operator.

fn neg(self) -> Self

Performs the unary - operation.

impl AddAssign<Mat3> for Mat3

fn add_assign(&mut self, rhs: Self)

Performs the += operation.

impl AddAssign<f32> for Mat3

fn add_assign(&mut self, rhs: f32)

Performs the += operation.

impl SubAssign<Mat3> for Mat3

fn sub_assign(&mut self, rhs: Self)

Performs the -= operation.

impl SubAssign<f32> for Mat3

fn sub_assign(&mut self, rhs: f32)

Performs the -= operation.

impl MulAssign<f32> for Mat3

fn mul_assign(&mut self, rhs: f32)

Performs the *= operation.

impl MulAssign<Mat3> for Mat3

fn mul_assign(&mut self, rhs: Self)

Performs the *= operation.

impl Index<usize> for Mat3

type Output = Vec3

The returned type after indexing.

fn index(&self, index: usize) -> &Vec3

Performs the indexing (container[index]) operation.

impl IndexMut<usize> for Mat3

fn index_mut(&mut self, index: usize) -> &mut Vec3

Performs the mutable indexing (container[index]) operation.

impl Copy for Mat3

impl AsRef<[Vec3; 3]> for Mat3

fn as_ref(&self) -> &[Vec3; 3]

Performs the conversion.

impl AsMut<[Vec3; 3]> for Mat3

fn as_mut(&mut self) -> &mut [Vec3; 3]

Performs the conversion.

impl From<[f32; 9]> for Mat3

fn from([xx, xy, xz, yx, yy, yz, zx, zy, zz]: [f32; 9]) -> Self

Performs the conversion.

impl From<Mat3> for [f32; 9]

fn from(Mat3 { x_axis: x_axis, y_axis: y_axis, z_axis: z_axis }: Mat3) -> Self

Performs the conversion.

impl Clone for Mat3

fn clone(&self) -> Mat3

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for Mat3

fn default() -> Mat3

Returns the "default value" for a type.

impl Pod for Mat3

impl Zeroable for Mat3

fn zeroed() -> Self

Calls zeroed.