Struct Mat3

Source

#[repr(C)]pub struct Mat3 {
    pub x_axis: Vec3,
    pub y_axis: Vec3,
    pub z_axis: Vec3,
}

Expand description

A 3x3 column major matrix.

This 3x3 matrix type features convenience methods for creating and using linear and affine transformations. If you are primarily dealing with 2D affine transformations the Affine2 type is much faster and more space efficient than using a 3x3 matrix.

Linear transformations including 3D rotation and scale can be created using methods such as Self::from_diagonal(), Self::from_quat(), Self::from_axis_angle(), Self::from_rotation_x(), Self::from_rotation_y(), or Self::from_rotation_z().

The resulting matrices can be use to transform 3D vectors using regular vector multiplication.

Affine transformations including 2D translation, rotation and scale can be created using methods such as Self::from_translation(), Self::from_angle(), Self::from_scale() and Self::from_scale_angle_translation().

The Self::transform_point2() and Self::transform_vector2() convenience methods are provided for performing affine transforms on 2D vectors and points. These multiply 2D inputs as 3D vectors with an implicit z value of 1 for points and 0 for vectors respectively. These methods assume that Self contains a valid affine transform.

Fields§

§x_axis: Vec3§y_axis: Vec3§z_axis: Vec3

Struct Mat3 Copy item path

Fields§

Implementations§

impl Mat3

pub const ZERO: Mat3

pub const IDENTITY: Mat3

pub const NAN: Mat3

pub const fn from_cols(x_axis: Vec3, y_axis: Vec3, z_axis: Vec3) -> Mat3

pub const fn from_cols_array(m: &[f32; 9]) -> Mat3

pub const fn to_cols_array(&self) -> [f32; 9]

pub const fn from_cols_array_2d(m: &[[f32; 3]; 3]) -> Mat3

pub const fn to_cols_array_2d(&self) -> [[f32; 3]; 3]

pub const fn from_diagonal(diagonal: Vec3) -> Mat3

pub fn from_mat4(m: Mat4) -> Mat3

pub fn from_mat4_minor(m: Mat4, i: usize, j: usize) -> Mat3

§Panics

pub fn from_quat(rotation: Quat) -> Mat3

§Panics

pub fn from_axis_angle(axis: Vec3, angle: f32) -> Mat3

§Panics

pub fn from_euler(order: EulerRot, a: f32, b: f32, c: f32) -> Mat3

pub fn to_euler(&self, order: EulerRot) -> (f32, f32, f32)

§Panics

pub fn from_rotation_x(angle: f32) -> Mat3

pub fn from_rotation_y(angle: f32) -> Mat3

pub fn from_rotation_z(angle: f32) -> Mat3

pub fn from_translation(translation: Vec2) -> Mat3

pub fn from_angle(angle: f32) -> Mat3

pub fn from_scale_angle_translation( scale: Vec2, angle: f32, translation: Vec2, ) -> Mat3

pub fn from_scale(scale: Vec2) -> Mat3

§Panics

pub fn from_mat2(m: Mat2) -> Mat3

pub const fn from_cols_slice(slice: &[f32]) -> Mat3

§Panics

pub fn write_cols_to_slice(&self, slice: &mut [f32])

§Panics

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

§Panics

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

§Panics

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

§Panics

pub fn is_finite(&self) -> bool

pub fn is_nan(&self) -> bool

pub fn transpose(&self) -> Mat3

pub fn diagonal(&self) -> Vec3

pub fn determinant(&self) -> f32

pub fn inverse(&self) -> Mat3

§Panics

pub fn try_inverse(&self) -> Option<Mat3>

pub fn inverse_or_zero(&self) -> Mat3

pub fn transform_point2(&self, rhs: Vec2) -> Vec2

§Panics

pub fn transform_vector2(&self, rhs: Vec2) -> Vec2

§Panics

pub fn look_to_lh(dir: Vec3, up: Vec3) -> Mat3

§Panics

pub fn look_to_rh(dir: Vec3, up: Vec3) -> Mat3

§Panics

pub fn look_at_lh(eye: Vec3, center: Vec3, up: Vec3) -> Mat3

§Panics

pub fn look_at_rh(eye: Vec3, center: Vec3, up: Vec3) -> Mat3

§Panics

pub fn mul_vec3(&self, rhs: Vec3) -> Vec3

pub fn mul_vec3a(&self, rhs: Vec3A) -> Vec3A

pub fn mul_transpose_vec3(&self, rhs: Vec3) -> Vec3

pub fn mul_mat3(&self, rhs: &Mat3) -> Mat3

pub fn add_mat3(&self, rhs: &Mat3) -> Mat3

pub fn sub_mat3(&self, rhs: &Mat3) -> Mat3

pub fn mul_scalar(&self, rhs: f32) -> Mat3

pub fn mul_diagonal_scale(&self, scale: Vec3) -> Mat3

pub fn div_scalar(&self, rhs: f32) -> Mat3

pub fn recip(&self) -> Mat3

pub fn abs_diff_eq(&self, rhs: Mat3, max_abs_diff: f32) -> bool

pub fn abs(&self) -> Mat3

pub fn as_dmat3(&self) -> DMat3

Trait Implementations§

impl Add<&Mat3> for &Mat3

type Output = Mat3

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

Struct Mat3

impl AsMutMatrixParts<f32, 3, 3> for Mat3
where Mat3: AsMut<[f32; 9]>, f32: MatrixScalar,

impl AsRefMatrixParts<f32, 3, 3> for Mat3
where Mat3: AsRef<[f32; 9]>, f32: MatrixScalar,

impl CreateFrom for Mat3
where Mat3: ShaderType<ExtraMetadata = MatrixMetadata> + FromMatrixParts<f32, 3, 3>, f32: MatrixScalar + CreateFrom,

fn create_from<B>(reader: &mut Reader<B>) -> Mat3
where B: BufferRef,

fn deserialize<D>( deserializer: D, ) -> Result<Mat3, <D as Deserializer<'de>>::Error>
where D: Deserializer<'de>,