Struct Mat3I16 

#[repr(C)]
pub struct Mat3I16 {
    pub m: [[i16; 3]; 3],
}

3×3 rotation / light matrix of i16 in 1.3.12. Laid out row-major so m[row][col] matches PSX-SPX notation (M_rc).

Fields

m: [[i16; 3]; 3]

Row-major 3×3 cells.

Implementations

impl Mat3I16

pub const ZERO: Self

Zero matrix.

pub const IDENTITY: Self

Identity matrix scaled 1.0 in 1.3.12 (diagonal = 0x1000).

pub const fn row(&self, i: usize) -> [i16; 3]

Access a row.

impl Mat3I16

pub fn mul(&self, other: &Self) -> Self

Matrix × matrix, with 1.3.12 fixed-point scaling applied so the output stays in 1.3.12. Saturates each cell to i16 range – rotation compositions stay well within, but callers doing scale-by-100 before compose should watch for truncation.

pub fn rotate_xyz(x: u16, y: u16, z: u16) -> Self

Compose X, then Y, then Z rotations using the PS1 matrix convention.

Angles use the same 256-per-revolution units as Self::rotate_x. The explicit order matters for camera/model transforms with more than one non-zero Euler component.

pub fn scale_rows_q12(&self, scale: [i32; 3]) -> Self

Scale matrix rows by independent Q12 factors.

This matches the classic PS1 ScaleMatrixL convention: row 0 receives X, row 1 receives Y, and row 2 receives Z. Results saturate like the GTE IR registers instead of wrapping at i16 boundaries.

pub fn scale_columns_q12(&self, scale: [i32; 3]) -> Self

Scale matrix columns by independent Q12 factors.

This matches the classic PS1 ScaleMatrix convention: column 0 receives X, column 1 receives Y, and column 2 receives Z.

pub fn transform(&self, v: Vec3I16) -> [i32; 3]

Matrix × vector, with 1.3.12 scaling. Returns i32 per component so the caller can inspect the un-saturated product (useful for normal generation / light calculations before feeding back into the GTE as V0).

pub fn transform_i32(&self, v: [i32; 3]) -> [i32; 3]

Matrix times a wide vector, using wrapping i32 dot products followed by an arithmetic Q12 shift. Inputs should keep each dot product in i32 when a non-wrapping result is required.

pub fn rotate_x_q12(angle: u16) -> Self

X rotation in 4096-per-turn units, with interpolated Q12 trig.

pub fn rotate_y_q12(angle: u16) -> Self

Y rotation in 4096-per-turn units, with interpolated Q12 trig.

pub const fn rotate_x(angle: u16) -> Self

Rotation around the X axis by angle (256-per-revolution units).

  | 1    0     0  |
  | 0   cos  -sin |
  | 0   sin   cos |

pub const fn rotate_y(angle: u16) -> Self

Rotation around the Y axis.

  |  cos  0  sin |
  |   0   1   0  |
  | -sin  0  cos |

pub const fn rotate_z(angle: u16) -> Self

Rotation around the Z axis.

  | cos  -sin  0 |
  | sin   cos  0 |
  |  0     0   1 |

Trait Implementations

impl Clone for Mat3I16

fn clone(&self) -> Mat3I16

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Mat3I16

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

Formats the value using the given formatter.

impl Default for Mat3I16

fn default() -> Mat3I16

Returns the “default value” for a type.

impl PartialEq for Mat3I16

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

impl Eq for Mat3I16

impl StructuralPartialEq for Mat3I16