Enum FrameDamage 

pub enum FrameDamage {
    None,
    Rects(Vec<LogicalRect>),
    Full,
}

Outcome of a single CPU render_frame call — the seed of the unified DamageRegion type described in DAMAGE_REGION_PLAN.md.

Lives in azul-layout (rather than in the dll’s headless backend, where it was originally defined) so that it can be stored on LayoutWindow and therefore be reachable from a CallbackInfo — i.e. from an E2E assertion. dll::desktop::shell2::headless::FrameDamage is a re-export of this type.

Variants

None

Nothing changed; render was skipped, the previous frame is still valid.

Rects(Vec<LogicalRect>)

Incremental repaint of exactly these logical rects.

Full

Full repaint (first frame, structural change, or shrink-resize).

Implementations

impl FrameDamage

pub const fn is_none(&self) -> bool

true if no pixel was repainted at all.

pub const fn is_full(&self) -> bool

true if the whole window was repainted.

pub fn rect_count(&self) -> usize

Number of damage rects (None → 0, Full → 1).

pub fn rects(&self) -> Option<&[LogicalRect]>

The damage rects, if this is an incremental repaint.

pub fn area(&self, window_area: f32) -> f32

Total damaged area in logical px². None → 0.0, Full → the full window_area passed in (the caller knows the window size).

pub fn to_present_rects_physical( &self, dpi_factor: f32, buf_w: u32, buf_h: u32, force_full: bool, ) -> Option<Vec<(u32, u32, u32, u32)>>

Convert this damage record into physical-pixel present rects for a buf_w×buf_h buffer at dpi_factor — the ONE conversion every platform presenter should use to hand damage to its compositor (XPutImage sub-rects / wl_surface_damage / partial StretchDIBits / setNeedsDisplayInRect:).

• None → returns None: the previous frame is still on screen and valid — present nothing. Callers must STILL present in full when the OS asked for a re-present (Expose / WM_PAINT-from-uncover / drawRect) — pass force_full = true there.
• Rects → Some(rects) as (x, y, w, h) physical px, rounded OUTWARD (floor origin / ceil far edge — truncation would under-cover fractional edges and leave 1px stale seams), clamped to the buffer. More than 16 rects collapses to one full-buffer rect (bounded cost, per DAMAGE_REGION_PLAN §3).
• Full → one full-buffer rect.

“Present must never silently be empty when a present is required” — when in doubt, callers should treat errors/unknowns as Full.

Trait Implementations

impl Clone for FrameDamage

fn clone(&self) -> FrameDamage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FrameDamage

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

Formats the value using the given formatter.

impl Default for FrameDamage

fn default() -> FrameDamage

Returns the “default value” for a type.

impl PartialEq for FrameDamage

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for FrameDamage