Struct SceneManager 

pub struct SceneManager { /* private fields */ }

Manages multiple isolated ECS worlds (scenes).

On construction a “default” scene is created and set as the sole active scene. The default scene cannot be destroyed.

Entity Isolation

Entities spawned in one scene are completely invisible to other scenes. Each scene owns its own World with independent entity allocators, component storage, and archetypes.

Implementations

impl SceneManager

pub fn new() -> SceneManager

Creates a new SceneManager with a “default” scene already created and marked active.

pub fn create_scene(&mut self, name: &str) -> Result<u32, GoudError>

Creates a new scene with the given name.

Returns the SceneId on success. Returns an error if a scene with the same name already exists.

pub fn destroy_scene(&mut self, id: u32) -> Result<(), GoudError>

Destroys a scene and frees its resources.

Returns an error if the scene does not exist or if attempting to destroy the default scene.

pub fn get_scene(&self, id: u32) -> Option<&World>

Returns a reference to the World for the given scene.

pub fn get_scene_mut(&mut self, id: u32) -> Option<&mut World>

Returns a mutable reference to the World for the given scene.

pub fn get_scene_by_name(&self, name: &str) -> Option<u32>

Looks up a scene by name, returning its ID if found.

pub fn get_scene_name(&self, id: u32) -> Option<&str>

Returns the name of the scene with the given ID, if it exists.

pub fn set_active(&mut self, id: u32, active: bool) -> Result<(), GoudError>

Sets whether a scene is active.

Active scenes are the ones that participate in the game loop (update, render, etc.). Returns an error if the scene does not exist.

pub fn is_active(&self, id: u32) -> bool

Returns true if the given scene is currently active.

pub fn active_scenes(&self) -> &[u32]

Returns a slice of all currently active scene IDs.

pub fn scene_count(&self) -> usize

Returns the number of occupied scenes (including the default).

pub fn default_scene(&self) -> u32

Returns the ID of the default scene.

Trait Implementations

impl Debug for SceneManager

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

Formats the value using the given formatter.

impl Default for SceneManager

fn default() -> SceneManager

Returns the “default value” for a type.