Struct hektor::Mat2

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

A 2x2 column-major Matrix.

There's two columns, and each column is itself a Vec2.

Methods

impl Mat2

Accessors

pub fn x_axis(self) -> Vec2

Obtains the x_axis column of this matrix

pub fn y_axis(self) -> Vec2

Obtains the y_axis column of this matrix

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

&mut to the x_axis column of this matrix

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

&mut to the y_axis column of this matrix

impl Mat2

Constructors

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

Combines the columns given into a new Mat2

pub fn splat(v: f32) -> Self

Splats the given value across all columns.

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

Forms a diagonal matrix from the values given.

pub fn to_mat3(self, z: f32) -> Mat3

Up-converts to a Mat3 by adding the given z as the z of the z_axis. The x_axis and y_axis are extended with 0.0

pub fn determinant(self) -> f32

Determinant of the matrix.

This gives the scale factor of a unit square 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 squares become 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 Mat2

fn determinant(self) -> f32

See determinant for info.

impl Display for Mat2

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

Display formats without labels in a 2 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 Mat2

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

Debug formats with each axis labeled and then shown as a 2-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 Mat2

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 Mat2

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<Mat2> for Mat2

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

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

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

This method tests for !=.

impl Add<Mat2> for Mat2

type Output = Self

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<f32> for Mat2

type Output = Self

The resulting type after applying the + operator.

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

Performs the + operation.

impl Add<Mat2> for f32

type Output = Mat2

The resulting type after applying the + operator.

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

Performs the + operation.

impl Sub<Mat2> for Mat2

type Output = Self

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<f32> for Mat2

type Output = Self

The resulting type after applying the - operator.

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

Performs the - operation.

impl Sub<Mat2> for f32

type Output = Mat2

The resulting type after applying the - operator.

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

Performs the - operation.

impl Mul<f32> for Mat2

type Output = Self

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Mat2> for f32

type Output = Mat2

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Vec2> for Mat2

type Output = Vec2

The resulting type after applying the * operator.

fn mul(self, v2: Vec2) -> Vec2

Performs the * operation.

impl Mul<Mat2> for Mat2

type Output = Self

The resulting type after applying the * operator.

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

Performs the * operation.

impl Neg for Mat2

type Output = Self

The resulting type after applying the - operator.

fn neg(self) -> Self

Performs the unary - operation.

impl AddAssign<Mat2> for Mat2

fn add_assign(&mut self, rhs: Self)

Performs the += operation.

impl AddAssign<f32> for Mat2

fn add_assign(&mut self, rhs: f32)

Performs the += operation.

impl SubAssign<Mat2> for Mat2

fn sub_assign(&mut self, rhs: Self)

Performs the -= operation.

impl SubAssign<f32> for Mat2

fn sub_assign(&mut self, rhs: f32)

Performs the -= operation.

impl MulAssign<f32> for Mat2

fn mul_assign(&mut self, rhs: f32)

Performs the *= operation.

impl MulAssign<Mat2> for Mat2

fn mul_assign(&mut self, rhs: Self)

Performs the *= operation.

impl Index<usize> for Mat2

type Output = Vec2

The returned type after indexing.

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

Performs the indexing (container[index]) operation.

impl IndexMut<usize> for Mat2

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

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

impl Copy for Mat2

impl AsRef<[Vec2; 2]> for Mat2

fn as_ref(&self) -> &[Vec2; 2]

Performs the conversion.

impl AsMut<[Vec2; 2]> for Mat2

fn as_mut(&mut self) -> &mut [Vec2; 2]

Performs the conversion.

impl From<[f32; 4]> for Mat2

fn from([xx, xy, yx, yy]: [f32; 4]) -> Self

Performs the conversion.

impl From<Mat2> for [f32; 4]

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

Performs the conversion.

impl Clone for Mat2

fn clone(&self) -> Mat2

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for Mat2

fn default() -> Mat2

Returns the "default value" for a type.

impl Pod for Mat2

impl Zeroable for Mat2

fn zeroed() -> Self

Calls zeroed.