Struct re_view_spatial::contexts::transform_tree_context::TransformTreeContext

pub struct TransformTreeContext {
    space_origin: EntityPath,
    transform_per_entity: IntMap<EntityPathHash, TransformInfo>,
}

Provides transforms from an entity to a chosen reference space for all elements in the scene for the currently selected time & timeline.

The resulting transforms are dependent on:

• tree, pose, pinhole and view-coordinates transforms components as logged to the data store
  • TODO(#6743): blueprint overrides aren’t respected yet
• the view’ spatial origin
• the query time
  • TODO(#723): ranges aren’t taken into account yet
• TODO(andreas): the queried entities. Right now we determine transforms for ALL entities in the scene. since 3D views tend to display almost everything that’s mostly fine, but it’s very wasteful when they don’t.

The renderer then uses this reference space as its world space, making world and reference space equivalent for a given view.

TODO(#7025): Right now we also do full tree traversal in here to resolve transforms to the root. However, for views that share the same query, we can easily make all entities relative to the respective origin in a linear pass over all matrices. (Note that right now the query IS always the same across all views for a given frame since it’s just latest-at controlled by the timeline, but once we support range queries it may be not or only partially the case)

Fields

space_origin: EntityPath

All transforms provided are relative to this reference path.

transform_per_entity: IntMap<EntityPathHash, TransformInfo>

All reachable entities.

Implementations

impl TransformTreeContext

fn gather_parent_transforms<'a>( &mut self, ctx: &'a ViewContext<'a>, data_result_tree: &DataResultTree, current_tree: &'a EntityTree, time_query: &LatestAtQuery, transforms: &CachedTransformsForTimeline, )

Gather transforms for everything above the root.

fn gather_descendants_transforms( &mut self, ctx: &ViewContext<'_>, data_result_tree: &DataResultTree, subtree: &EntityTree, query: &LatestAtQuery, transform: TransformInfo, transforms_for_timeline: &CachedTransformsForTimeline, )

pub fn reference_path(&self) -> &EntityPath

pub fn transform_info_for_entity( &self, ent_path: EntityPathHash, ) -> Option<&TransformInfo>

Retrieves transform information for a given entity.

Returns None if it’s not reachable from the view’s origin.

Trait Implementations

impl Clone for TransformTreeContext

fn clone(&self) -> TransformTreeContext

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for TransformTreeContext

fn default() -> Self

Returns the “default value” for a type.

impl IdentifiedViewSystem for TransformTreeContext

fn identifier() -> ViewSystemIdentifier

Unique name for a system within a given crate::ViewClass.

impl ViewContextSystem for TransformTreeContext

fn execute(&mut self, ctx: &ViewContext<'_>, query: &ViewQuery<'_>)

Determines transforms for all entities relative to a space path which serves as the “reference”. I.e. the resulting transforms are “reference from scene”

This means that the entities in reference_space get the identity transform and all other entities are transformed relative to it.

fn compatible_component_sets(&self) -> Vec<ComponentNameSet>

Returns all the component sets that the system is compatible with.

fn as_any(&self) -> &dyn Any

Converts itself to a reference of std::any::Any, which enables downcasting to concrete types.