[][src]Struct specs::prelude::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>[src]

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

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)[src]

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)[src]

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_par(&mut self, world: &World)[src]

Dispatches the systems (except thread local systems) in parallel given the resources to operate on.

This operation blocks the executing thread.

Only available with "parallel" feature enabled.

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)[src]

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)[src]

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.

pub fn max_threads(&self) -> usize[src]

This method returns the largest amount of threads this dispatcher can make use of. This is mainly for debugging purposes so you can see how well your systems can make use of multi-threading.

Trait Implementations

impl<'a, 'b, 'c> RunNow<'a> for Dispatcher<'b, 'c>[src]

Auto Trait Implementations

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

impl<'a, 'b> !Sync for Dispatcher<'a, 'b>

impl<'a, 'b> !Send for Dispatcher<'a, 'b>

impl<'a, 'b> !UnwindSafe for Dispatcher<'a, 'b>

impl<'a, 'b> !RefUnwindSafe for Dispatcher<'a, 'b>

Blanket Implementations

impl<T> From<T> for T[src]

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<'a, T> RunNow<'a> for T where
    T: System<'a>, 
[src]

impl<T> Any for T where
    T: Any
[src]