pub trait Command: Send + 'static {
// Required method
fn apply(self, world: &mut World);
}
Expand description
A World
mutation.
Should be used with Commands::add
.
§Usage
// Our world resource
#[derive(Resource, Default)]
struct Counter(u64);
// Our custom command
struct AddToCounter(u64);
impl Command for AddToCounter {
fn apply(self, world: &mut World) {
let mut counter = world.get_resource_or_insert_with(Counter::default);
counter.0 += self.0;
}
}
fn some_system(mut commands: Commands) {
commands.add(AddToCounter(42));
}
Required Methods§
sourcefn apply(self, world: &mut World)
fn apply(self, world: &mut World)
Applies this command, causing it to mutate the provided world
.
This method is used to define what a command “does” when it is ultimately applied.
Because this method takes self
, you can store data or settings on the type that implements this trait.
This data is set by the system or other source of the command, and then ultimately read in this method.