Struct Transform4x4 

pub struct Transform4x4 { /* private fields */ }

4x4 transformation matrix.

Represents a full 3D affine transformation including rotation, scale, translation, and perspective. The matrix is stored in column-major order.

Matrix Layout

[ m00  m01  m02  m03 ]
[ m10  m11  m12  m13 ]
[ m20  m21  m22  m23 ]
[ m30  m31  m32  m33 ]

Note

This struct does not have automatic getters for matrix elements. Use the Matrix trait methods (m00(), m01(), etc.) to access elements.

Conversions

• Can be converted from/to Cube for bounding box storage

Example

use rpfm_lib::files::bmd::common::{Transform4x4, Matrix};

let transform = Transform4x4::identity();
let rotation = transform.rotation_matrix();
let (rx, ry, rz) = Transform4x4::rotation_matrix_to_euler_angles(rotation, true);

Implementations

impl Transform4x4

pub fn m00_mut(&mut self) -> &mut f32

Matrix element at row 0, column 0.

pub fn m01_mut(&mut self) -> &mut f32

Matrix element at row 0, column 1.

pub fn m02_mut(&mut self) -> &mut f32

Matrix element at row 0, column 2.

pub fn m03_mut(&mut self) -> &mut f32

Matrix element at row 0, column 3.

pub fn m10_mut(&mut self) -> &mut f32

Matrix element at row 1, column 0.

pub fn m11_mut(&mut self) -> &mut f32

Matrix element at row 1, column 1.

pub fn m12_mut(&mut self) -> &mut f32

Matrix element at row 1, column 2.

pub fn m13_mut(&mut self) -> &mut f32

Matrix element at row 1, column 3.

pub fn m20_mut(&mut self) -> &mut f32

Matrix element at row 2, column 0.

pub fn m21_mut(&mut self) -> &mut f32

Matrix element at row 2, column 1.

pub fn m22_mut(&mut self) -> &mut f32

Matrix element at row 2, column 2.

pub fn m23_mut(&mut self) -> &mut f32

Matrix element at row 2, column 3.

pub fn m30_mut(&mut self) -> &mut f32

Matrix element at row 3, column 0 (translation X).

pub fn m31_mut(&mut self) -> &mut f32

Matrix element at row 3, column 1 (translation Y).

pub fn m32_mut(&mut self) -> &mut f32

Matrix element at row 3, column 2 (translation Z).

pub fn m33_mut(&mut self) -> &mut f32

Matrix element at row 3, column 3 (homogeneous coordinate).

impl Transform4x4

pub fn set_m00(&mut self, val: f32) -> &mut Self

Matrix element at row 0, column 0.

pub fn set_m01(&mut self, val: f32) -> &mut Self

Matrix element at row 0, column 1.

pub fn set_m02(&mut self, val: f32) -> &mut Self

Matrix element at row 0, column 2.

pub fn set_m03(&mut self, val: f32) -> &mut Self

Matrix element at row 0, column 3.

pub fn set_m10(&mut self, val: f32) -> &mut Self

Matrix element at row 1, column 0.

pub fn set_m11(&mut self, val: f32) -> &mut Self

Matrix element at row 1, column 1.

pub fn set_m12(&mut self, val: f32) -> &mut Self

Matrix element at row 1, column 2.

pub fn set_m13(&mut self, val: f32) -> &mut Self

Matrix element at row 1, column 3.

pub fn set_m20(&mut self, val: f32) -> &mut Self

Matrix element at row 2, column 0.

pub fn set_m21(&mut self, val: f32) -> &mut Self

Matrix element at row 2, column 1.

pub fn set_m22(&mut self, val: f32) -> &mut Self

Matrix element at row 2, column 2.

pub fn set_m23(&mut self, val: f32) -> &mut Self

Matrix element at row 2, column 3.

pub fn set_m30(&mut self, val: f32) -> &mut Self

Matrix element at row 3, column 0 (translation X).

pub fn set_m31(&mut self, val: f32) -> &mut Self

Matrix element at row 3, column 1 (translation Y).

pub fn set_m32(&mut self, val: f32) -> &mut Self

Matrix element at row 3, column 2 (translation Z).

pub fn set_m33(&mut self, val: f32) -> &mut Self

Matrix element at row 3, column 3 (homogeneous coordinate).

Trait Implementations

impl Clone for Transform4x4

fn clone(&self) -> Transform4x4

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Transform4x4

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

Formats the value using the given formatter.

impl Decodeable for Transform4x4

fn decode<R: ReadBytes>( data: &mut R, _extra_data: &Option<DecodeableExtraData<'_>>, ) -> Result<Self>

Decodes binary data into the implementing type.

impl Default for Transform4x4

fn default() -> Transform4x4

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Transform4x4

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Encodeable for Transform4x4

fn encode<W: WriteBytes>( &mut self, buffer: &mut W, _extra_data: &Option<EncodeableExtraData<'_>>, ) -> Result<()>

Encodes the implementing type into binary data.

impl From<Cube> for Transform4x4

fn from(value: Cube) -> Self

Converts to this type from the input type.

impl From<Transform4x4> for Cube

fn from(value: Transform4x4) -> Self

Converts to this type from the input type.

impl Matrix for Transform4x4

fn m00(&self) -> f32

Returns matrix element at row 0, column 0.

fn m01(&self) -> f32

Returns matrix element at row 0, column 1.

fn m02(&self) -> f32

Returns matrix element at row 0, column 2.

fn m03(&self) -> f32

Returns matrix element at row 0, column 3 (0.0 for 3x4 matrices).

fn m10(&self) -> f32

Returns matrix element at row 1, column 0.

fn m11(&self) -> f32

Returns matrix element at row 1, column 1.

fn m12(&self) -> f32

Returns matrix element at row 1, column 2.

fn m13(&self) -> f32

Returns matrix element at row 1, column 3 (0.0 for 3x4 matrices).

fn m20(&self) -> f32

Returns matrix element at row 2, column 0.

fn m21(&self) -> f32

Returns matrix element at row 2, column 1.

fn m22(&self) -> f32

Returns matrix element at row 2, column 2.

fn m23(&self) -> f32

Returns matrix element at row 2, column 3 (0.0 for 3x4 matrices).

fn m30(&self) -> f32

Returns matrix element at row 3, column 0 (translation X).

fn m31(&self) -> f32

Returns matrix element at row 3, column 1 (translation Y).

fn m32(&self) -> f32

Returns matrix element at row 3, column 2 (translation Z).

fn m33(&self) -> f32

Returns matrix element at row 3, column 3 (1.0 for 3x4 matrices).

fn identity() -> Self

Creates an identity transformation matrix.

fn rotation_matrix(&self) -> Matrix3<f64>

Extracts the 3x3 rotation submatrix.

fn extract_scales(matrix: Matrix3<f64>) -> (f64, f64, f64)

Extracts scale factors from a rotation matrix.

fn apply_scales(matrix: Matrix3<f64>, scales: (f64, f64, f64)) -> Matrix3<f64>

Applies scale factors to a rotation matrix.

fn normalize_rotation_matrix( matrix: Matrix3<f64>, scales: (f64, f64, f64), ) -> Matrix3<f64>

Normalizes a rotation matrix by removing scale factors.

fn rotation_matrix_to_euler_angles( matrix: Matrix3<f64>, degrees: bool, ) -> (f64, f64, f64)

Converts a rotation matrix to Euler angles.

fn euler_angles_to_rotation_matrix( angles: (f64, f64, f64), degrees: bool, ) -> Matrix3<f64>

Converts Euler angles to a rotation matrix.

impl PartialEq for Transform4x4

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

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Transform4x4