Struct Transform3D 

pub struct Transform3D { /* private fields */ }

A full 3D transformation stored as a 4×4 matrix.

Backed by glam::Mat4 which provides SIMD-optimized operations. Needed for perspective transforms, 3D rotations, and compositing layers that exist in 3D space.

For pure 2D work, prefer AffineTransform — it uses fewer operations and less memory.

Implementations

impl Transform3D

pub const IDENTITY: Self

pub fn translate(tx: f32, ty: f32, tz: f32) -> Self

pub fn scale(sx: f32, sy: f32, sz: f32) -> Self

pub fn rotate_x(angle: f32) -> Self

pub fn rotate_y(angle: f32) -> Self

pub fn rotate_z(angle: f32) -> Self

Rotation around the Z axis (equivalent to 2D rotation).

pub fn perspective(depth: f32) -> Self

A perspective projection that makes distant objects appear smaller. depth is the distance from the viewer to the z=0 plane.

pub fn is_identity(&self) -> bool

pub fn is_2d(&self) -> bool

True when the transform operates only in the X/Y plane (no Z rotation, no perspective, no Z translation). Can be losslessly represented as an AffineTransform.

pub fn to_affine(&self) -> AffineTransform

Extract a 2D affine transform, dropping the Z components. Only meaningful when is_2d returns true.

pub fn from_affine(t: &AffineTransform) -> Self

Promote a 2D affine transform to a 3D matrix.

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

pub fn inverse(&self) -> Option<Self>

Compute the inverse. Returns None if the matrix is singular.

pub fn determinant(&self) -> f32

pub fn transform_point(&self, p: Point) -> Point

Transform a 2D point through this 3D matrix. The point is treated as (x, y, 0, 1) and projected back to 2D by dividing by the homogeneous w coordinate.

pub fn is_back_face_visible(&self) -> bool

True when the back face of a transformed plane would be visible (the Z component of the transformed normal is negative).

pub fn as_raw(&self) -> &Mat4

Access the underlying glam::Mat4 for interop with rendering libraries that accept glam types directly.

Trait Implementations

impl Clone for Transform3D

fn clone(&self) -> Transform3D

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Transform3D

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

Formats the value using the given formatter.

impl Default for Transform3D

fn default() -> Self

Returns the “default value” for a type.

impl Mul for Transform3D

type Output = Transform3D

The resulting type after applying the * operator.

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

Performs the * operation.

impl PartialEq for Transform3D

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

impl StructuralPartialEq for Transform3D