Skip to main content

AsyncExecutor

Struct AsyncExecutor 

Source
pub struct AsyncExecutor<P: Plugin> { /* private fields */ }
Expand description

An way to run background tasks from the plugin’s GUI, equivalent to the ProcessContext::execute_background() and ProcessContext::execute_gui() functions. This is passed directly to Plugin::editor() so the plugin can move it into its editor and use it later.

§Note

This is only intended to be used from the GUI. Use the methods on InitContext and ProcessContext to run tasks during the initialize() and process() functions.

Implementations§

Source§

impl<P: Plugin> AsyncExecutor<P>

Source

pub fn new( execute_background: Arc<dyn Fn(P::BackgroundTask) + Send + Sync>, execute_gui: Arc<dyn Fn(P::BackgroundTask) + Send + Sync>, ) -> Self

Source§

impl<P: Plugin> AsyncExecutor<P>

Source

pub fn execute_background(&self, task: P::BackgroundTask)

Execute a task on a background thread using [Plugin::task_executor]. This allows you to defer expensive tasks for later without blocking either the process function or the GUI thread. As long as creating the task is realtime-safe, this operation is too.

§Note

Scheduling the same task multiple times will cause those duplicate tasks to pile up. Try to either prevent this from happening, or check whether the task still needs to be completed in your task executor.

Source

pub fn execute_gui(&self, task: P::BackgroundTask)

Execute a task on a background thread using [Plugin::task_executor].

§Note

Scheduling the same task multiple times will cause those duplicate tasks to pile up. Try to either prevent this from happening, or check whether the task still needs to be completed in your task executor.

Trait Implementations§

Source§

impl<P: Plugin> Clone for AsyncExecutor<P>

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more

Auto Trait Implementations§

§

impl<P> Freeze for AsyncExecutor<P>

§

impl<P> !RefUnwindSafe for AsyncExecutor<P>

§

impl<P> Send for AsyncExecutor<P>

§

impl<P> Sync for AsyncExecutor<P>

§

impl<P> Unpin for AsyncExecutor<P>

§

impl<P> UnsafeUnpin for AsyncExecutor<P>

§

impl<P> !UnwindSafe for AsyncExecutor<P>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

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

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.