Struct SceneNode 

pub struct SceneNode {
    pub id: NodeId,
    pub name: Option<String>,
    pub local: Transform,
    pub visible: bool,
    pub parent: Option<NodeId>,
    pub children: Vec<NodeId>,
    pub tag: Option<String>,
    pub sort_key: i32,
    pub user_data: u64,
    /* private fields */
}

A scene graph node with parent-child transform hierarchy.

Fields

id: NodeId

name: Option<String>

local: Transform

visible: bool

parent: Option<NodeId>

children: Vec<NodeId>

tag: Option<String>

Arbitrary tag for queries (e.g. “player”, “enemy”, “ui”).

sort_key: i32

Draw order within the same layer (lower = drawn first).

user_data: u64

User-defined metadata slot (e.g. entity index).

Implementations

impl SceneNode

pub fn new(id: NodeId, position: Vec3) -> Self

pub fn with_name(self, name: impl Into<String>) -> Self

pub fn with_tag(self, tag: impl Into<String>) -> Self

pub fn with_sort_key(self, key: i32) -> Self

pub fn set_position(&mut self, pos: Vec3)

Set local position and mark dirty.

pub fn set_rotation_z(&mut self, angle: f32)

Set local rotation (Z axis) and mark dirty.

pub fn set_scale(&mut self, scale: f32)

Set uniform local scale and mark dirty.

pub fn set_transform(&mut self, t: Transform)

Set the full local transform and mark dirty.

pub fn update_world_transform(&mut self, parent_world: &Mat4) -> bool

Compute and cache the world transform given the parent’s world matrix. Returns whether recomputation occurred.

pub fn world_matrix(&self) -> &Mat4

Get the cached world transform matrix.

pub fn world_position(&self) -> Vec3

World-space position (column 3 of world matrix).

pub fn world_scale(&self) -> Vec3

World-space scale (magnitude of columns 0, 1, 2).

pub fn mark_dirty(&mut self)

Mark this node (and implicitly its subtree) as needing world-transform update.

pub fn is_dirty(&self) -> bool

Returns true if the node’s world transform needs recomputation.

pub fn translate(&mut self, delta: Vec3)

Translate local position by delta.

pub fn rotate_z(&mut self, angle: f32)

Rotate local transform by angle (radians, around Z).

pub fn is_visible(&self) -> bool

pub fn set_visible(&mut self, v: bool)

Trait Implementations

impl Clone for SceneNode

fn clone(&self) -> SceneNode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SceneNode

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

Formats the value using the given formatter.