Struct bones_ecs::World

pub struct World {
    pub resources: Resources,
    pub components: ComponentStores,
}

The World is simply a collection of Resources, and ComponentStores.

Also stored in the world is the Entities, but it is stored as a resource.

World is designed to be trivially Cloneed to allow for snapshotting the world state. The is especially useful in the context of rollback networking, which requires the ability to snapshot and restore state.

Fields

resources: Resources

Stores the world resources.

components: ComponentStores

Stores the world components.

Implementations

impl World

pub fn new() -> Self

Create a new World.

pub fn with_entities(entities: AtomicResource<Entities>) -> Self

Create a new world that uses the provided entities resource.

This allows multiple worlds to avoid allocating the same entity IDs.

pub fn maintain(&self)

Remove the component info for dead entities.

This should be called every game frame to cleanup entities that have been killed.

This will remove the component storage for all killed entities, and allow their slots to be re-used for any new entities.

pub fn run_system<'system, R, In, Out, S>(&self, system: S, input: In) -> Out

where In: 'system, Out: 'system, S: IntoSystem<R, In, Out>, S::Sys: 'system,

Run a system once.

This is good for initializing the world with setup systems.

pub fn entity_components<Q: QueryItem>( &self, entity: Entity, query: Q, ) -> <Q::Iter as Iterator>::Item

Get an entity’s components.

Panics

Panics if the entity does not have the required components from the query.

pub fn get_entity_components<Q: QueryItem>( &self, entity: Entity, query: Q, ) -> Option<<Q::Iter as Iterator>::Item>

Get an entity’s components.

pub fn init_resource<R: HasSchema + FromWorld>(&mut self) -> RefMut<'_, R>

Initialize a resource of type T by inserting it’s default value.

pub fn insert_resource<R: HasSchema>(&mut self, resource: R) -> Option<R>

Insert a resource.

pub fn resource<T: HasSchema>(&self) -> Ref<'_, T>

Borrow a resource from the world.

Panics

Panics if the resource does not exist in the store.

pub fn resource_mut<T: HasSchema>(&self) -> RefMut<'_, T>

Borrow a resource from the world.

Panics

Panics if the resource does not exist in the store.

pub fn get_resource<T: HasSchema>(&self) -> Option<Ref<'_, T>>

Borrow a resource from the world, if it exists.

pub fn get_resource_mut<T: HasSchema>(&mut self) -> Option<RefMut<'_, T>>

Borrow a resource from the world, if it exists.

pub fn component<T: HasSchema>(&self) -> Ref<'_, ComponentStore<T>>

Borrow a component store from the world.

Panics

Panics if the component store does not exist in the world.

pub fn component_mut<T: HasSchema>(&self) -> RefMut<'_, ComponentStore<T>>

Mutably borrow a component store from the world.

Panics

Panics if the component store does not exist in the world.

pub fn reset_internals(&mut self, reset_components: bool, reset_entities: bool)

Provides an interface for resetting entities, and components.

Trait Implementations

impl Clone for World

fn clone(&self) -> World

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for World

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

Formats the value using the given formatter.

impl Default for World

fn default() -> Self

Returns the “default value” for a type.

impl SystemParam for &World

type State = ()

The intermediate state for the parameter, that may be extracted from the world.

type Param<'s> = &'s World

The type of the parameter, ranging over the lifetime of the intermediate state.

fn get_state(_world: &World) -> Self::State

This is called to produce the intermediate state of the system parameter.

fn borrow<'s>(world: &'s World, _state: &'s mut Self::State) -> Self::Param<'s>

This is used create an instance of the system parame, possibly borrowed from the intermediate parameter state.