Enum AcquireOutcome 

pub enum AcquireOutcome {
    Acquired,
    Reconfigured,
    Lost,
    Skipped,
}

The outcome of a single acquire call — the first half of the two-phase present seam (acquire + submit), itself the second phase of the render pipeline after encode.

A shell that times the swapchain acquire (the blocking vsync/present wait) separately from the submit (blit + queue-submit + present) branches on this to decide whether submitting is worthwhile. Only Self::Acquired carries a stashed swapchain texture for the submit call to draw into; every other variant is terminal and maps to a FrameOutcome with no submit.

Variants

Acquired

The swapchain texture was acquired and stashed; the submit call draws into it and presents it. Maps to FrameOutcome::Rendered once submitted.

Reconfigured

The surface was stale and has been reconfigured internally; no texture was stashed. Maps to FrameOutcome::Redraw — the shell should request another frame against the fresh configuration.

Lost

The surface was lost and has been dropped; the machine is now in SurfacePhase::SurfaceLost. Maps to FrameOutcome::SurfaceLost — the shell must recreate the surface via on_surface_created.

Skipped

No renderable surface (NoSurface/SurfaceLost) or a transient acquire failure: nothing was stashed and nothing was queued. Maps to FrameOutcome::Skipped.

Trait Implementations

impl Clone for AcquireOutcome

fn clone(&self) -> AcquireOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for AcquireOutcome

impl Debug for AcquireOutcome

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

Formats the value using the given formatter.

impl Eq for AcquireOutcome

impl PartialEq for AcquireOutcome

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for AcquireOutcome