Struct Matrix4

#[repr(C)]
pub struct Matrix4(pub [Vector4; 4]);

A 4x4 matrix, suitable for 3D transformations.

Tuple Fields

0: [Vector4; 4]

Implementations

impl Matrix4

pub const fn from_1d_array(a: [f32; 16]) -> Self

A new matrix from a 1D array.

pub const fn from_2d_array(a: [[f32; 4]; 4]) -> Self

A new matrix from a 2D array.

pub const fn identity() -> Self

The identity matrix.

pub const fn zero() -> Self

A matrix composed entirely of zeroes.

pub fn look_at(eye: Point, target: Point, up: Vector3) -> Self

A look-at matrix suitable for positioning a camera.

pub fn perspective( aspect_ratio: f32, fov_radians: f32, znear: f32, zfar: f32, ) -> Self

A perspective matrix suitable for use as a camera projection.

pub fn orthographic( left: f32, right: f32, bottom: f32, top: f32, near: f32, far: f32, ) -> Self

An orthographic matrix suitable for rendering user interfaces.

pub fn translation(v: Vector3) -> Self

A matrix that translates by the given vector.

pub fn rotation_x(angle_radians: f32) -> Self

A matrix that rotates around the x-axis.

pub fn rotation_y(angle_radians: f32) -> Self

A matrix that rotates around the y-axis.

pub fn rotation_z(angle_radians: f32) -> Self

A matrix that rotates around the z-axis.

pub fn rotation_axis_angle(axis: Vector3, angle_radians: f32) -> Self

A matrix that rotates around an arbitrary axis.

pub fn rotation_from_vector_to_vector(start: Vector3, end: Vector3) -> Self

A matrix that rotates from a given vector to another.

pub fn uniform_scale(scale: f32) -> Self

A matrix that scales uniformly in all dimensions.

pub fn row(&self, i: usize) -> Vector4

Obtain the specified row vector of this matrix.

pub fn column(&self, i: usize) -> Vector4

Obtain the specified column vector of this matrix.

pub fn transpose(&self) -> Self

The transpose of this matrix (i.e. this matrix flipped along the diagonal)

pub fn invert(&self) -> Self

The inverse of this matrix.

pub fn as_slice(&self) -> &[f32]

Trait Implementations

impl Clone for Matrix4

fn clone(&self) -> Matrix4

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Matrix4

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

Formats the value using the given formatter.

impl Mul<&Matrix4> for Matrix4

type Output = Matrix4

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Matrix4> for Point

type Output = Point

The resulting type after applying the * operator.

fn mul(self, rhs: Matrix4) -> Point

Performs the * operation.

impl Mul<Matrix4> for Vector3

type Output = Vector3

The resulting type after applying the * operator.

fn mul(self, rhs: Matrix4) -> Vector3

Performs the * operation.

impl Mul<Matrix4> for Vector4

type Output = Vector4

The resulting type after applying the * operator.

fn mul(self, rhs: Matrix4) -> Vector4

Performs the * operation.

impl Mul<Point> for Matrix4

type Output = Point

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Vector3> for Matrix4

type Output = Vector3

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Vector4> for Matrix4

type Output = Vector4

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul for Matrix4

type Output = Matrix4

The resulting type after applying the * operator.

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

Performs the * operation.

impl NearlyEqual for &Matrix4

fn nearly_equals(self, rhs: Self) -> bool

impl PartialEq for Matrix4

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

impl StructuralPartialEq for Matrix4