Struct PaintOutcome 

pub struct PaintOutcome {
    pub needs_frame: bool,
    pub needs_layout: bool,
    pub needs_frame_paced_only: bool,
    pub paced_interval: Option<Duration>,
    pub paint_serial: u64,
}

The result of a whole crate::app::RenderRoot::paint pass.

needs_frame is whether any widget advanced animation state during paint and asked (via PaintCtx::request_frame) to be re-invoked to continue. The shell turns it into another scheduled frame — the desktop shell via window.request_redraw(), the mobile shells implicitly through their continuous loop. Mirrors crate::event::EventOutcome’s needs_redraw.

needs_layout is whether any widget asked (via PaintCtx::request_layout) to have layout re-run next frame because its animation changed its layout, not just its paint. crate::app::RenderRoot::paint folds it into the render root’s pending crate::view::ChangeFlags (LAYOUT) so the next frame’s take_change_flags().needs_layout() reports it — driving the mobile intra-frame layout skip to relayout while the animation is in flight.

needs_frame_paced_only is the aggregated TickClass verdict: true only when a frame was requested and every request this frame was TickClass::CosmeticLoop (a pacable decorative loop), false the instant any TickClass::Transition request (including any request_layout) joined in. The mobile frame gate may throttle such a purely-cosmetic frame to a lower cadence; a false here means the frame runs every vsync as today. Only meaningful when needs_frame is true.

paced_interval is how fast that paced frame asked to be re-run: the MIN over every paced request this pass (see PaintCtx::request_frame_paced_at). Only meaningful alongside needs_frame_paced_only.

Fields

needs_frame: bool

Whether the shell should schedule another frame to continue an animation.

needs_layout: bool

Whether the render root folded a layout-continuation request into its pending change flags (a widget called PaintCtx::request_layout). The root also folds LAYOUT for a pod an unpaced frame request or a trailing landing paint dirtied; that fold is not reported here.

needs_frame_paced_only: bool

Whether a frame was requested and every request this frame was TickClass::CosmeticLoop — the paced-only state the mobile frame gate may throttle (see PaintCtx::needs_frame_paced_only). Meaningful only when needs_frame is set.

paced_interval: Option<Duration>

The tightest (MIN) interval any paced request this frame named — see PaintCtx::paced_interval. None (no paced request) and Some(Duration::ZERO) (a bare PaintCtx::request_frame_paced) both mean “the theme’s own cosmetic_loop_rate”; a longer value asks the gate to pace this loop slower than that cap. Meaningful only alongside needs_frame_paced_only; a shell latches it beside that flag and hands it to the frame gate, which resolves it against the live theme’s cap.

paint_serial: u64

The serial the render root minted for this paint (PaintCtx::paint_serial): 1 for a root’s first paint, one more for each paint after it. A shell carries it with the painted scene and hands it to the renderer before encoding that scene, so the resident-key ledger the renderer publishes names the last scene it committed (see crate::retained). 0 only from a Default outcome.

Trait Implementations

impl Clone for PaintOutcome

fn clone(&self) -> PaintOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PaintOutcome

impl Debug for PaintOutcome

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

Formats the value using the given formatter.

impl Default for PaintOutcome

fn default() -> PaintOutcome

Returns the “default value” for a type.

impl Eq for PaintOutcome

impl PartialEq for PaintOutcome

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PaintOutcome