Enum SystemStage 

pub enum SystemStage {
    PreUpdate,
    Update,
    PostUpdate,
    PreRender,
    AssetSync,
    AssetSyncDeps,
    Render,
    PostRender,
}

Determines when during a frame a system is executed.

There’s no dedicated “run once at startup” stage — instead, any system on any stage can be made to run at most once with .once(), which turns “have I already done this” into the function’s own return value (Some(()) = done, retire; None = not ready, try again next tick) instead of a special stage with its own rules. A .once() system naturally waits as many ticks as it needs to (an async GPU backend, a LazyResource that isn’t built yet) using the exact same requirement checks as every other system on its stage.

AssetSync/AssetSyncDeps are prioritized: they’re re-run to convergence (repeated until a full pass produces no new resources) at the front of every tick and again after every other stage, so newly queued asset/resource work is drained before gameplay stages continue rather than waiting for the next tick’s front pass. All other stages run once per App::update tick, in the order declared below.

Variants

PreUpdate

Before the main update.

Update

Main game-logic update.

PostUpdate

After the main update.

PreRender

Prepare rendering data and poll for the GPU backend. The backend resource becomes available here on the tick it finishes initialising, making it visible to the asset sync stages.

AssetSync

Upload CPU-side source assets to the GPU backend.

AssetSyncDeps

Construct lazy GPU resources and upload assets that depend on other processed assets. Runs in a convergence loop so dependency chains (e.g. LazyResource A → LazyResource B) resolve within a single tick.

Render

Issue draw calls.

PostRender

Cleanup or post-processing after rendering.

Implementations

impl SystemStage

pub fn is_convergent(self) -> bool

Returns true for stages that are prioritized and re-run until a full pass produces no new resources, instead of running once in their declared position in the tick order. See the type-level docs on SystemStage.

Trait Implementations

impl Clone for SystemStage

fn clone(&self) -> SystemStage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SystemStage

impl Debug for SystemStage

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for SystemStage

impl Hash for SystemStage

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for SystemStage

fn cmp(&self, other: &SystemStage) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for SystemStage

fn eq(&self, other: &SystemStage) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl PartialOrd for SystemStage

fn partial_cmp(&self, other: &SystemStage) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StructuralPartialEq for SystemStage