Struct DegradationCascade 

pub struct DegradationCascade { /* private fields */ }

Degradation cascade orchestrator.

Sits between the conformal frame guard and the render budget system. Call [pre_render] before each frame and [post_render] after.

Implementations

impl DegradationCascade

pub fn new(config: CascadeConfig) -> Self

Create a new cascade with the given configuration.

pub fn with_defaults() -> Self

Create a cascade with default configuration.

pub fn pre_render(&mut self, budget_us: f64, key: BucketKey) -> PreRenderResult

Pre-render check: predict p99 and decide whether to degrade.

Returns the degradation level to use for this frame and the prediction. The caller should apply the returned level to the render budget.

pub fn post_render(&mut self, frame_time_us: f64, key: BucketKey)

Post-render observation: feed actual frame time to the guard.

Call this after the frame has been rendered with the measured time.

pub fn level(&self) -> DegradationLevel

Get the current degradation level.

pub fn recovery_streak(&self) -> u32

Get the current recovery streak.

pub fn frame_idx(&self) -> u64

Get the frame counter.

pub fn total_degrades(&self) -> u64

Total degrade events.

pub fn total_recoveries(&self) -> u64

Total recovery events.

pub fn last_evidence(&self) -> Option<&CascadeEvidence>

Access the last cascade evidence.

pub fn guard(&self) -> &ConformalFrameGuard

Access the underlying guard.

pub fn config(&self) -> &CascadeConfig

Access the configuration.

pub fn reset(&mut self)

Reset the cascade to initial state.

pub fn should_render_widget(&self, is_essential: bool) -> bool

Whether widget should render given current degradation level and essentiality.

At EssentialOnly or higher degradation, non-essential widgets are skipped.

pub fn telemetry(&self) -> CascadeTelemetry

Capture telemetry for the cascade.

Trait Implementations

impl Debug for DegradationCascade

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

Formats the value using the given formatter.