Struct oxygengine_core::ecs::prelude::Dispatcher

pub struct Dispatcher<'a, 'b> { /* fields omitted */ }

The dispatcher struct, allowing systems to be executed in parallel.

Implementations

impl<'a, 'b> Dispatcher<'a, 'b>

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

Sets up all the systems which means they are gonna add default values for the resources they need.

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

Calls the dispose method of all systems and allows them to release external resources. It is common this method removes components and / or resources from the World which are associated with external resources.

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

Dispatch all the systems with given resources and context and then run thread local systems.

This function automatically redirects to

• [Dispatcher::dispatch_par] in case it is supported
• Dispatcher::dispatch_seq otherwise

and runs dispatch_thread_local afterwards.

Please note that this method assumes that no resource is currently borrowed. If that’s the case, it panics.

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

Dispatches the systems (except thread local systems) sequentially.

This is useful if parallel overhead is too big or the platform does not support multithreading.

Please note that this method assumes that no resource is currently borrowed. If that’s the case, it panics.

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

Dispatch only thread local systems sequentially.

Please note that this method assumes that no resource is currently borrowed. If that’s the case, it panics.

Trait Implementations

impl<'a, 'b, 'c> RunNow<'a> for Dispatcher<'b, 'c>

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

Runs the system now.

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

Sets up World for a later call to run_now.

pub fn dispose(self: Box<Dispatcher<'b, 'c>, Global>, world: &mut World)

Performs clean up that requires resources from the World. This commonly removes components from world which depend on external resources.