Struct GameObjectScene 

pub struct GameObjectScene {
    pub name: String,
    pub objects: Vec<GameObject>,
    /* private fields */
}

A bounded scene of game objects with hierarchy support. Serializable as JSON for .wm scene files, editor snapshots, and replication.

Fields

name: String

objects: Vec<GameObject>

Implementations

impl GameObjectScene

pub fn new(name: String) -> Self

pub fn spawn(&mut self, name: String) -> Result<u64, String>

Spawn an empty game object. Returns its ID.

pub fn spawn_primitive( &mut self, name: String, kind: PrimitiveKind, ) -> Result<u64, String>

Spawn a game object with a primitive mesh. Returns its ID.

pub fn find(&self, id: u64) -> Option<&GameObject>

pub fn find_mut(&mut self, id: u64) -> Option<&mut GameObject>

pub fn despawn(&mut self, id: u64) -> bool

Despawn an object by ID. Clears dangling parent references.

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn validate(&self) -> Result<(), String>

Validate entire scene.

pub fn roots(&self) -> impl Iterator<Item = &GameObject>

Root objects (no parent).

pub fn children_of(&self, parent_id: u64) -> impl Iterator<Item = &GameObject>

Children of a given parent.

pub fn propagate_transforms(&self) -> Vec<[f32; 16]>

Propagate transforms through the parent-child hierarchy. Each child’s world matrix = parent_world * child_local. Stores results indexed by object position in self.objects.

Uses topological BFS from roots — O(N) single pass, each object computed exactly once. Parents are always processed before children.

pub fn visible_mesh_count(&self) -> usize

Count of visible objects with a mesh binding.

Trait Implementations

impl Clone for GameObjectScene

fn clone(&self) -> GameObjectScene

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GameObjectScene

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

Formats the value using the given formatter.

impl Default for GameObjectScene

fn default() -> GameObjectScene

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for GameObjectScene

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GameObjectScene

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

where __S: Serializer,

Serialize this value into the given Serde serializer.