Struct SceneCache 

pub struct SceneCache { /* private fields */ }

Bounded deterministic compile-once/render-many scene cache.

Implementations

impl SceneCache

pub const DEFAULT_MAX_BYTES: usize

Default aggregate serialized scene budget.

pub fn new(capacity: usize) -> Result<Self>

Creates a cache with an explicit non-zero entry bound.

pub fn with_byte_capacity(capacity: usize, max_bytes: usize) -> Result<Self>

Bounds cached and evicted-but-consumer-held scenes by entries and aggregate serialized bytes. Returned Arc copies outside this cache, including Arc::make_mut allocations, are not process memory accounting.

pub fn get(&self, key: &DocumentFingerprint) -> Option<Arc<ResolvedScene>>

Returns an immutable cached scene without changing eviction order.

pub fn get_or_try_insert_with<F>( &mut self, key: DocumentFingerprint, limits: &ResourceLimits, resolve: F, ) -> Result<Arc<ResolvedScene>>

where F: FnOnce() -> Result<ResolvedScene>,

Returns a cached scene or resolves and inserts it exactly once on a miss. Rejects a miss before resolving when consumer-held scenes exhaust the entry or serialized-byte bound. This is not a scratch-memory reservation.

pub fn insert( &mut self, key: DocumentFingerprint, scene: ResolvedScene, limits: &ResourceLimits, ) -> Result<Arc<ResolvedScene>>

Inserts a fully resolved scene and evicts the oldest inserted key. Evicted scenes held by consumers still consume entry/byte admission. If leases prevent admission, returns LimitExceeded; earlier FIFO evictions may already have occurred. Compilation scratch is not covered.

pub fn len(&self) -> usize

Number of retained scenes.

pub fn is_empty(&self) -> bool

Returns whether no scenes are retained.

pub const fn used_bytes(&self) -> usize

Aggregate serialized bytes retained by cached scenes.

pub fn retired_bytes(&self) -> usize

Serialized bytes of evicted scenes still held by consumers (not RSS). Counts are observed per entry; concurrent consumer drops may lower them.

pub const fn max_bytes(&self) -> usize

Configured aggregate serialized scene byte budget.