Struct re_view_spatial::transform_cache::TransformCacheStoreSubscriber

pub struct TransformCacheStoreSubscriber {
    transform_components: IntSet<ComponentName>,
    pose_components: IntSet<ComponentName>,
    pinhole_components: IntSet<ComponentName>,
    per_timeline: HashMap<Timeline, CachedTransformsForTimeline>,
    static_timeline: CachedTransformsForTimeline,
}

Store subscriber that resolves all transform components at a given entity to an affine transform.

It only handles resulting transforms individually to each entity, not how these transforms propagate in the tree. For transform tree propagation see crate::contexts::TransformTreeContext.

There are different kinds of transforms handled here:

• archetypes::Transform3D Tree transforms that should propagate in the tree (via crate::contexts::TransformTreeContext).
• archetypes::InstancePoses3D Instance poses that should be applied to the tree transforms (via crate::contexts::TransformTreeContext) but not propagate.
• components::PinholeProjection and components::ViewCoordinates Pinhole projections & associated view coordinates used for visualizing cameras in 3D and embedding 2D in 3D

Most of what this construct does internally is to keep track at which points in time these sets of components change such that a latest-at query for them may (!) yield any new results. It then (in TransformCacheStoreSubscriber::apply_all_updates) performs those queries and derives transforms from them.

Fields

transform_components: IntSet<ComponentName>

All components of archetypes::Transform3D

pose_components: IntSet<ComponentName>

All components of archetypes::InstancePoses3D

pinhole_components: IntSet<ComponentName>

All components related to pinholes (i.e. components::PinholeProjection and components::ViewCoordinates).

per_timeline: HashMap<Timeline, CachedTransformsForTimeline>

static_timeline: CachedTransformsForTimeline

Implementations

impl TransformCacheStoreSubscriber

pub fn subscription_handle() -> ChunkStoreSubscriberHandle

Accesses the global store subscriber.

Lazily registers the subscriber if it hasn’t been registered yet.

pub fn access<T>(store_id: &StoreId, f: impl FnMut(&Self) -> T) -> Option<T>

Accesses the transform component tracking data for a given store.

pub fn access_mut<T>( store_id: &StoreId, f: impl FnMut(&mut Self) -> T, ) -> Option<T>

Accesses the transform component tracking data for a given store exclusively.

pub fn transforms_for_timeline( &self, timeline: Timeline, ) -> &CachedTransformsForTimeline

Accesses the transform component tracking data for a given timeline.

Returns None if the timeline doesn’t have any transforms at all.

pub fn apply_all_updates(&mut self, entity_db: &EntityDb)

Makes sure the transform cache is up to date with the latest data.

This needs to be called once per frame prior to any transform propagation. (which is done by crate::contexts::TransformTreeContext)

fn add_temporal_chunk( &mut self, event: &ChunkStoreEvent, aspects: TransformAspect, )

fn add_static_chunk( &mut self, event: &ChunkStoreEvent, aspects: TransformAspect, )

fn remove_chunk(&mut self, event: &ChunkStoreEvent, aspects: TransformAspect)

Trait Implementations

impl Default for TransformCacheStoreSubscriber

fn default() -> Self

Returns the “default value” for a type.

impl PerStoreChunkSubscriber for TransformCacheStoreSubscriber

fn name() -> String

Arbitrary name for the subscriber.

fn on_events<'a>(&mut self, events: impl Iterator<Item = &'a ChunkStoreEvent>)

Get notified of changes happening in a ChunkStore, see ChunkStoreSubscriber::on_events.