Struct oxygengine_core::ecs::CommandBuffer

pub struct CommandBuffer { /* fields omitted */ }

Records operations for future application to a World

Useful when operations cannot be applied directly due to ordering concerns or borrow checking.

let mut world = World::new();
let entity = world.reserve_entity();
let mut cmd = CommandBuffer::new();
cmd.insert(entity, (true, 42));
cmd.run_on(&mut world); // cmd can now be reused
assert_eq!(*world.get::<i32>(entity).unwrap(), 42);

Implementations

impl CommandBuffer

pub fn new() -> CommandBuffer

Create an empty command buffer

pub fn insert(&mut self, entity: Entity, components: impl DynamicBundle)

Add components from bundle to entity, if it exists

Pairs well with World::reserve_entity to spawn entities with a known handle.

pub fn spawn(&mut self, components: impl DynamicBundle)

Spawn a new entity with components

If the Entity is needed immediately, consider combining World::reserve_entity with insert instead.

pub fn run_on(&mut self, world: &mut World)

Run recorded commands on world, clearing the command buffer

pub fn clear(&mut self)

Drop all recorded commands

Trait Implementations

impl Default for CommandBuffer

pub fn default() -> CommandBuffer

Create an empty buffer

impl Drop for CommandBuffer

pub fn drop(&mut self)

Executes the destructor for this type.

impl Send for CommandBuffer

impl Sync for CommandBuffer