Struct AdaptiveQuality 

pub struct AdaptiveQuality { /* private fields */ }

Exponentially smoothed frame time with hysteresis over QualityTier.

Implementations

impl AdaptiveQuality

pub const fn new(config: AdaptiveQualityConfig, publication: bool) -> Self

Builds a controller at the tier one render mode starts from.

publication is the engine’s own determinism switch: the cinematic path and off-screen publication never adapt regardless of policy, and they start at QualityTier::Standard — the tier it holds for every frame. An interactive path starts at QualityTier::Reduced, the tier whose sampling matches the realtime presets the engine shipped before the loop existed, and the loop raises it once there is measured headroom.

pub const fn target_fps(&self) -> u16

The frame rate the loop steers toward.

pub const fn enabled(&self) -> bool

Whether the loop is allowed to move a tier.

pub const fn tier(&self) -> QualityTier

The tier every frame of this instant presents at.

pub const fn smoothed_ns(&self) -> u64

The smoothed frame time in nanoseconds; zero before the first frame.

pub fn set_atom_count(&mut self, atom_count: u64)

Applies the size-based realtime ceiling for the next frame.

This is a cheap scene-level operation. Changing to a smaller band immediately drops the tier and clears its timing window; growing a scene’s budget never causes a sudden expensive jump.

pub fn set_publication(&mut self, publication: bool)

Marks the engine as running the deterministic publication path.

Entering publication holds the tier constant from that frame on.

pub fn observe(&mut self, frame_ns: u64) -> QualityTier

Feeds one frame’s wall-clock duration and returns the tier the next frame presents at.

The caller chooses the sample source per target: the native render call duration (CPU encoding/submission) or the browser submission-to-fence-completion elapsed time. Both are host-clock durations, neither is GPU execution time, and each frame feeds exactly one sample from exactly one source.

Trait Implementations

impl Clone for AdaptiveQuality

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for AdaptiveQuality

impl Debug for AdaptiveQuality

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

Formats the value using the given formatter.

impl Default for AdaptiveQuality

fn default() -> Self

Returns the “default value” for a type.