Struct IsolatedFrameMetrics

pub struct IsolatedFrameMetrics {

    pub isolated_pass_count: u32,
    pub offscreen_pixels_rendered: u64,
    pub blur_pixels_total: u64,
    pub offscreen_peak_bytes: u64,
    pub pool_reuse_hits: u32,
    pub pool_allocs: u32,
    pub blur_pass_count: u32,
    pub stencil_offscreen_count: u32,
    pub downgrade_nested_isolated: u32,
    pub downgrade_oversized: u32,
    pub downgrades: IsolatedDowngradeCounts,
    pub backdrop_capture_count: u32,
    pub backdrop_pixels_total: u64,
    pub backdrop_blur_pass_count: u32,
    pub blend_capture_count: u32,
    pub blend_composite_count: u32,
}

Per-frame metrics for isolated offscreen rendering (AILLOLI_UI_GPU_DEBUG=1).

Pixel and byte fields are accumulated with integer counters during a frame. A default value represents a frame that performed no isolated work.

Examples

use ailloli_ui_render_wgpu::IsolatedFrameMetrics;

let metrics = IsolatedFrameMetrics::default();
assert_eq!(metrics.isolated_pass_count, 0);
assert_eq!(metrics.pool_reuse_ratio(), 0.0);

Fields

isolated_pass_count: u32

Number of offscreen isolated content passes rendered this frame.

offscreen_pixels_rendered: u64

Total physical pixels covered by isolated offscreen targets.

blur_pixels_total: u64

Total physical pixels processed by blur passes.

offscreen_peak_bytes: u64

Peak bytes retained by the offscreen surface pool.

pool_reuse_hits: u32

Number of offscreen leases satisfied by reusable allocations.

pool_allocs: u32

Number of new offscreen allocations made this frame.

blur_pass_count: u32

Number of separable blur GPU passes recorded.

stencil_offscreen_count: u32

Number of isolated targets that required stencil attachments.

downgrade_nested_isolated: u32

Legacy count of nested-isolation downgrades.

downgrade_oversized: u32

Legacy count of oversized-target downgrades.

downgrades: IsolatedDowngradeCounts

Typed downgrade counts accumulated by the active budget policy.

backdrop_capture_count: u32

Number of backdrop regions copied before isolated rendering.

backdrop_pixels_total: u64

Total physical pixels copied for backdrop capture.

backdrop_blur_pass_count: u32

Number of blur passes applied to captured backdrop regions.

blend_capture_count: u32

Number of destination regions captured for non-normal blending.

blend_composite_count: u32

Number of shader blend composites recorded.

Implementations

impl IsolatedFrameMetrics

pub fn downgrade_count(&self) -> u32

Returns the total number of typed and legacy isolation downgrades.

Addition uses ordinary u32 arithmetic and therefore follows Rust’s debug-overflow checks; real frame counts remain far below the limit.

Examples

use ailloli_ui_render_wgpu::IsolatedFrameMetrics;

let mut metrics = IsolatedFrameMetrics::default();
metrics.downgrade_nested_isolated = 2;
metrics.downgrade_oversized = 1;
assert_eq!(metrics.downgrade_count(), 3);

pub fn pool_reuse_ratio(&self) -> f64

Returns reused leases divided by all reuse/allocation outcomes.

The range is 0.0..=1.0; an empty denominator returns 0.0 instead of NaN.

Examples

use ailloli_ui_render_wgpu::IsolatedFrameMetrics;

let metrics = IsolatedFrameMetrics {
    pool_reuse_hits: 3,
    pool_allocs: 1,
    ..IsolatedFrameMetrics::default()
};
assert_eq!(metrics.pool_reuse_ratio(), 0.75);

Trait Implementations

impl Clone for IsolatedFrameMetrics

fn clone(&self) -> IsolatedFrameMetrics

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for IsolatedFrameMetrics

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

Formats the value using the given formatter.

impl Default for IsolatedFrameMetrics

fn default() -> IsolatedFrameMetrics

Returns the “default value” for a type.

impl Copy for IsolatedFrameMetrics