Struct Node 

pub struct Node {
    pub transform: Transform,
    pub visible: bool,
    /* private fields */
}

A minimal scene node containing only essential hot data.

Design Principles

• Only keeps data that must be traversed every frame (hierarchy and transform)
• Other attributes (Mesh, Camera, Light, Skin, etc.) are stored in Scene’s component maps
• Improves CPU cache hit rate by keeping nodes small and contiguous

Hierarchy

Nodes form a tree structure through parent-child relationships:

• parent: Optional handle to parent node (None for root nodes)
• children: List of child node handles

Transform

Each node has a Transform component that manages:

• Local position, rotation, and scale
• Cached local and world matrices
• Dirty flag for efficient updates

Fields

transform: Transform

Transform component (hot data accessed every frame)

visible: bool

Visibility flag for culling

Implementations

impl Node

pub fn new() -> Node

Creates a new node with default transform and visibility.

pub fn parent(&self) -> Option<NodeHandle>

Returns the parent node handle, if any.

pub fn children(&self) -> &[NodeHandle]

Returns a read-only slice of child node handles.

pub fn set_parent(&mut self, parent: Option<NodeHandle>)

Sets the parent of this node. Prefer using crate::Scene::attach which keeps both parent and child in sync. This is exposed for low-level construction (e.g., building hierarchies outside of a Scene).

pub fn push_child(&mut self, child: NodeHandle)

Appends a child handle. Prefer using crate::Scene::attach which keeps both parent and child in sync. This is exposed for low-level construction (e.g., building hierarchies outside of a Scene).

pub fn world_matrix(&self) -> &Affine3A

Returns a reference to the world transformation matrix.

This matrix transforms local coordinates to world coordinates. It is automatically updated by the transform system each frame.

Trait Implementations

impl Clone for Node

fn clone(&self) -> Node

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Node

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

Formats the value using the given formatter.

impl Default for Node

fn default() -> Node

Returns the “default value” for a type.