Enum FrameOutcome 

pub enum FrameOutcome {
    Rendered,
    Skipped,
    NeedsReconfigure,
    Error(SurfaceRenderError),
}

Outcome of PlatformWindow::render_frame. Mirrors the wgpu surface-status cases that matter to the caller so the app loop can decide how to respond (ignore, reconfigure, log) without every frame getting logged as an error.

Variants

Rendered

Frame was rendered and presented.

Skipped

wgpu reported the window as occluded or the acquire timed out. Per wgpu guidance, skip this frame. On macOS, the initial paint after window creation often hits Occluded one or more times before Metal finishes compositing, so the caller should still request another redraw once — unless it already knows the window is occluded via WindowEvent::Occluded(true).

NeedsReconfigure

Surface became outdated (resize, scale change, device switch). Caller should reconfigure the surface and try again.

Error(SurfaceRenderError)

Acquisition failed with a non-transient error.

Trait Implementations

impl Debug for FrameOutcome

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

Formats the value using the given formatter.