Enum InvalidationScope

pub enum InvalidationScope {
    All,
    Only(Vec<SurfaceTarget>),
}

Which surfaces a given App::update mutation can affect.

Returned by App::invalidate_after (default InvalidationScope::All) to let the runtime skip redraws on surfaces whose contents could not possibly have changed by the message in question. On a shell with many overlays most messages only touch one of them, so the savings are large.

Variants

All

Treat every surface as potentially affected (safe default).

Only(Vec<SurfaceTarget>)

Only the listed surfaces may have changed; others can be skipped this iteration. An empty list means “nothing visible to redraw” — useful for messages that only touch internal bookkeeping.

Implementations

impl InvalidationScope

pub fn union(self, other: Self) -> Self

Combine two scopes. All absorbs any other scope; two Only scopes merge into a deduped list of targets. Used by the run loop to fold the per-message scopes from a batch of pending messages into a single decision before applying it.

Trait Implementations

impl Clone for InvalidationScope

fn clone(&self) -> InvalidationScope

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for InvalidationScope

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

Formats the value using the given formatter.