Struct ambient_api::ecs::EventQuery

pub struct EventQuery<Components>(/* private fields */)
where
    Components: ComponentsTuple + Copy + Clone + 'static;

An ECS query that calls a callback when its associated event occurs.

Implementations

impl<Components> EventQuery<Components>

where Components: ComponentsTuple + Copy + Clone + 'static,

pub fn create( event: QueryEvent, components: Components ) -> EventQuery<Components>

Creates a new EventQuery that will find entities that have the specified components that will call its bound function when the event occurs.

pub fn requires(self, requires: impl ComponentsTuple) -> EventQuery<Components>

The entities must include the components in requires.

pub fn excludes(self, excludes: impl ComponentsTuple) -> EventQuery<Components>

The entities must not include the components in excludes.

pub fn bind<R>( self, callback: impl FnMut(Vec<(EntityId, <Components as ComponentsTuple>::Data)>) -> R + 'static ) -> Listener

where R: CallbackReturn,

Each time the entity associated with components experiences the event, the callback (fn) is called with the result of the query.