Struct oxygengine_core::ecs::Dispatcher

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

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

Methods

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

pub fn setup(&mut self, res: &mut Resources)

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

pub fn dispose(self, res: &mut Resources)

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 Resources which are associated with external resources.

Calling any method after dispose (including dispose itself) will panic.

pub fn dispatch(&mut self, res: &Resources)

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

This function automatically redirects to

• dispatch_par in case it is supported
• 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, res: &Resources)

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, res: &Resources)

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>

fn run_now(&mut self, res: &Resources)

Runs the system now.

fn setup(&mut self, res: &mut Resources)

Sets up Resources for a later call to run_now.

fn dispose(self: Box<Dispatcher<'b, 'c>>, res: &mut Resources)

Performs clean up that requires resources from the Resources.