Struct Transform 

pub struct Transform {
    pub position: Vec3,
    pub rotation: Vec3,
    pub scale: Vec3,
}

Local translation, Euler rotation and scale relative to the parent.

Units: metres, degrees and dimensionless scale. Rotations use Y-X-Z order, +Y is up and -Z is forward. Scale defaults to one. Shear is not representable.

use kvas_engine::components::Transform;
use glam::Vec3;
let mut pose = Transform::at(Vec3::new(0.0, 1.0, 0.0));
assert!(pose.look_at(Vec3::new(0.0, 1.0, -1.0), Vec3::Y));
assert!((pose.forward() - Vec3::NEG_Z).length() < 1e-5);

Fields

position: Vec3

Translation in parent-local metres.

rotation: Vec3

Euler angles in degrees.

scale: Vec3

Per-axis local scale, one for an unscaled object.

Implementations

impl Transform

pub fn at(position: Vec3) -> Self

Identity orientation/scale positioned at a parent-local point.

pub fn quat(&self) -> Quat

Converts stored Euler degrees to a quaternion using Y-X-Z rotation order.

pub fn set_quat(&mut self, q: Quat)

Stores a unit quaternion as Euler degrees; equivalent angles may wrap. The caller must supply a finite normalized quaternion.

pub fn matrix(&self) -> Mat4

Local TRS matrix for column-vector multiplication (translation * rotation * scale).

pub fn from_matrix(m: Mat4) -> Self

Decomposes a finite, non-singular TRS matrix. Shear cannot be retained. Use Self::try_from_matrix for unchecked input.

pub fn forward(&self) -> Vec3

Local -Z rotated into parent space, ignoring scale.

pub fn right(&self) -> Vec3

Local +X rotated into parent space, ignoring scale.

pub fn up(&self) -> Vec3

Local +Y rotated into parent space, ignoring scale.

pub fn is_finite(&self) -> bool

Checks that every stored scalar is finite; zero scale remains valid data.

pub fn try_from_matrix(matrix: Mat4) -> Option<Self>

Decomposes a finite non-singular matrix, returning None for invalid data. Perspective and shear matrices are rejected by checking the reconstructed TRS.

pub fn transform_point(&self, point: Vec3) -> Vec3

Transforms a local point into parent space, including translation and scale.

pub fn transform_direction(&self, direction: Vec3) -> Vec3

Rotates a direction into parent space, ignoring translation and scale.

pub fn inverse_transform_point(&self, point: Vec3) -> Option<Vec3>

Converts a parent-space point to local space, or None for a singular/invalid pose.

pub fn look_at(&mut self, target: Vec3, up: Vec3) -> bool

Orients local -Z toward a parent-space target while keeping position/scale. Returns false without mutation for coincident points, non-finite data, a zero up vector or an up vector parallel to the viewing direction.

pub fn interpolate(&self, other: &Self, t: f32) -> Self

Interpolates translation/scale linearly and orientation along the shortest quaternion arc. t is clamped to [0, 1]; non-finite t selects self.

Trait Implementations

impl Clone for Transform

fn clone(&self) -> Transform

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Component for Transform

const REMOVABLE: bool = false

Whether the user may remove it in the inspector.

fn fields(&mut self) -> Vec<Field<'_>>

Mutable field descriptors used by the Inspector and script property serialization.

impl Component for Transform

const NAME: &'static str = "Transform"

Stable, globally unique name; keep it identical in the host and script library.

const KEY: u64 = _

Storage key derived from [Self::NAME]. Normally should not be overridden.

impl Copy for Transform

impl Debug for Transform

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

Formats the value using the given formatter.

impl Default for Transform

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Transform

where Transform: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Transform

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

where __S: Serializer,

Serialize this value into the given Serde serializer.