Struct apecs::Facade

pub struct Facade { /* private fields */ }

Visits world resources from async systems.

A facade is a window into the world, by which an async system can interact with the world through Facade::visit, without causing resource contention.

Implementations

impl Facade

pub async fn visit<D: CanFetch + Send + Sync + 'static, T: Send + Sync + 'static>(
    &mut self,
    f: impl FnOnce(D) -> Result<T>
) -> Result<T>

Asyncronously visit fetchable system resources using a closure.

The closure may return data to the caller.

A roundtrip takes at most one frame.

Note: Using a closure ensures that no fetched system resources are held over an await point, which would preclude other systems from accessing them and susequently being able to run.

pub fn spawn<T: Send + Sync + 'static>(
    &self,
    future: impl Future<Output = T> + Send + 'static
) -> Task<T>

Spawn a task onto the world’s async task executor.