Struct RedrawScheduler 

pub struct RedrawScheduler {
    pub pending: bool,
    pub focused: bool,
    pub occluded: bool,
    pub paused: bool,
}

Redraw pacing: whether a frame is wanted, and whether the window can show one.

Other systems request a paint by writing pending = true; the window backend asks the platform for a redraw only while the window is visible (not occluded). That keeps an idle app from repainting at the display rate, the way Qt gates requestUpdate on isExposed() and GTK drives its frame clock.

The pump gates on visibility, not focus. On tiling window managers (Hyprland, sway) an unfocused window stays fully on-screen, so it must keep animating: a module’s off-thread position pump, restyle tweens, and scroll inertia all ride the redraw loop, and freezing them the moment focus leaves would stop a slider mid-drag. Only an occluded or minimized window parks.

The window backend owns focused, occluded, and paused, and calls Self::recompute_paused when the first two change. Other code reads them and writes only pending.

Fields

pending: bool

Set to true to request a paint the next time the event loop goes idle. Cleared once the paint is dispatched.

focused: bool

true when the window has keyboard focus. Tracked for the WindowFocused message and the focus-return repaint; not part of the pump gate (see RedrawScheduler::compute_paused).

occluded: bool

true when the window is fully occluded (covered by another window or moved off-screen).

paused: bool

Whether redraw requests are held back: recomputed whenever occluded or focused changes, and true only while the window is occluded.

Implementations

impl RedrawScheduler

pub fn recompute_paused(&mut self)

Recompute Self::paused after a change to focused or occluded.

pub fn compute_paused(_focused: bool, occluded: bool) -> bool

The pump gate: should the redraw loop park?

Only occlusion parks the loop. focused is accepted and ignored, so a visible but unfocused window (the tiling window manager case) keeps animating.

pub fn should_forward_redraw(&self) -> bool

Whether the backend should ask the platform for a redraw: a paint is pending and the window is not parked. Anything that wants a frame while unfocused (a worker thread’s crate::app::EventLoopWaker, a restyle tween, scroll inertia) sets pending, and this gate lets it through.

Trait Implementations

impl Clone for RedrawScheduler

fn clone(&self) -> RedrawScheduler

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Component for RedrawScheduler

where Self: Send + Sync + 'static,

const STORAGE_TYPE: StorageType = bevy_ecs::component::StorageType::SparseSet

A constant indicating the storage type used for this component.

type Mutability = Mutable

A marker type to assist Bevy with determining if this component is mutable, or immutable. Mutable components will have Component<Mutability = Mutable>, while immutable components will instead have Component<Mutability = Immutable>.

fn register_required_components( _requiree: ComponentId, required_components: &mut RequiredComponentsRegistrator<'_, '_>, )

Registers required components.

fn clone_behavior() -> ComponentCloneBehavior

Called when registering this component, allowing to override clone function (or disable cloning altogether) for this component.

fn relationship_accessor() -> Option<ComponentRelationshipAccessor<Self>>

Returns [ComponentRelationshipAccessor] required for working with relationships in dynamic contexts.

fn on_add() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_add [ComponentHook] for this Component if one is defined.

fn on_insert() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_insert [ComponentHook] for this Component if one is defined.

fn on_discard() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_discard [ComponentHook] for this Component if one is defined.

fn on_remove() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_remove [ComponentHook] for this Component if one is defined.

fn on_despawn() -> Option<for<'w> fn(DeferredWorld<'w>, HookContext)>

Gets the on_despawn [ComponentHook] for this Component if one is defined.

fn map_entities<E>(_this: &mut Self, _mapper: &mut E)

where E: EntityMapper,

Maps the entities on this component using the given EntityMapper. This is used to remap entities in contexts like scenes and entity cloning. When deriving Component, this is populated by annotating fields containing entities with #[entities]

impl Debug for RedrawScheduler

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

Formats the value using the given formatter.

impl Default for RedrawScheduler

fn default() -> Self

Returns the “default value” for a type.

impl Copy for RedrawScheduler

impl Resource for RedrawScheduler

where Self: Send + Sync + 'static,