Struct SceneResidency 

pub struct SceneResidency { /* private fields */ }

Per-scene residency pins, one refcount per resource and channel.

Implementations

impl SceneResidency

pub fn new(scenes: Vec<(AssetId, Vec<Member>)>) -> Self

Build from each scene’s exclusively-owned members. Every scene starts unpinned with nothing resident; the driver blocks every owned member (all_members) at setup, then the first sync_pins unblocks the pinned scenes’ members.

pub fn is_empty(&self) -> bool

Whether nothing is pinned.

pub fn all_members(&self) -> impl Iterator<Item = Member> + '_

Every scene-owned member, for the driver’s setup pass: all owned members start blocked, matching every scene starting unpinned.

pub fn sync_pins(&mut self, pinned: &[AssetId]) -> PinChanges

Establish the pin set: exactly the scenes in pinned are pinned after this call. Returns the members whose blocked state must change on the stream planners (a no-op sync returns empty changes).

pub fn note_resident(&mut self, member: Member, resident: bool)

Record a member’s residency transition (a completed upload or an applied eviction). Members owned by no scene are ignored.

pub fn state(&self, scene: AssetId) -> Option<SceneLoadState>

The scene’s derived load state, or None for an unknown scene.

pub fn progress(&self, scene: AssetId) -> Option<f32>

Fraction of the scene’s members resident (1.0 with no members), or None for an unknown scene.

pub fn any_loading(&self) -> bool

Whether any pinned scene still has members loading.

pub fn status(&self) -> Vec<(AssetId, SceneLoadState, f32)>

Every scene’s (id, state, progress), in declaration order.

pub fn status_into(&self, out: &mut Vec<(AssetId, SceneLoadState, f32)>)

status, written into out (cleared first) so a per-frame poll reuses its buffer.