More cleanup and comments

crates/re_space_view/src/data_query.rs

@@ -1,7 +1,7 @@
 use re_data_store::{EntityProperties, EntityPropertyMap};
 use re_viewer_context::{DataQueryResult, EntitiesPerSystem, StoreContext};
 
-pub struct EntityOverrides {
+pub struct EntityOverrideContext {
     pub root: EntityProperties,
     pub individual: EntityPropertyMap,
     pub group: EntityPropertyMap,

crates/re_space_view/src/data_query_blueprint.rs

@@ -14,7 +14,7 @@ use slotmap::SlotMap;
 use smallvec::SmallVec;
 
 use crate::{
-    blueprint::components::QueryExpressions, DataQuery, EntityOverrides, PropertyResolver,
+    blueprint::components::QueryExpressions, DataQuery, EntityOverrideContext, PropertyResolver,
 };
 
 /// An implementation of [`DataQuery`] that is built from a collection of [`QueryExpressions`]
@@ -272,6 +272,11 @@ impl DataQueryBlueprint {
 }
 
 impl DataQuery for DataQueryBlueprint {
+    /// Build up the initial [`DataQueryResult`] for this [`DataQueryBlueprint`]
+    ///
+    /// Note that this result will not have any resolved [`PropertyOverrides`]. Those can
+    /// be added by separately calling [`DataQueryPropertyResolver::update_overrides`] on
+    /// the result.
     fn execute_query(
         &self,
         ctx: &re_viewer_context::StoreContext<'_>,
@@ -498,13 +503,15 @@ pub struct DataQueryPropertyResolver<'a> {
 }
 
 impl DataQueryPropertyResolver<'_> {
-    /// Helper function to lookup the properties for a given entity path.
+    /// Helper function to build the [`EntityOverrideContext`] for this [`DataQuery`]
     ///
-    /// We start with the auto properties for the `SpaceView` as the base layer and
-    /// then incrementally override from there.
-    fn resolve_entity_overrides(&self, ctx: &StoreContext<'_>) -> EntityOverrides {
+    /// The context is made up of 3 parts:
+    ///  - The root properties are build by merging a stack of paths from the Blueprint Tree. This
+    ///  may include properties from the `SpaceView` or `DataQuery`.
+    ///  - The individual overrides are found by walking an override subtree under the `data_query/<id>/individual_overrides`
+    ///  - The group overrides are found by walking an override subtree under the `data_query/<id>/group_overrides`
+    fn build_override_context(&self, ctx: &StoreContext<'_>) -> EntityOverrideContext {
         re_tracing::profile_function!();
-        let blueprint = ctx.blueprint;
 
         let mut root: EntityProperties = Default::default();
         for prefix in &self.default_stack {
@@ -517,65 +524,59 @@ impl DataQueryPropertyResolver<'_> {
             }
         }
 
-        let mut individual = self.auto_properties.clone();
-
-        if let Some(tree) = blueprint.tree().subtree(&self.individual_override_root) {
-            tree.visit_children_recursively(&mut |path: &EntityPath| {
-                if let Some(props) = blueprint
-                    .store()
-                    .query_timeless_component::<EntityPropertiesComponent>(path)
-                {
-                    let overridden_path = EntityPath::from(
-                        &path.as_slice()[self.individual_override_root.len()..path.len()],
-                    );
-                    individual.update(overridden_path, props.value.0);
-                }
-            });
-        }
-
-        EntityOverrides {
+        EntityOverrideContext {
             root,
             individual: self.resolve_entity_overrides_for_path(ctx, &self.individual_override_root),
             group: self.resolve_entity_overrides_for_path(ctx, &self.recursive_override_root),
         }
     }
 
+    /// Find all of the overrides for a given path.
+    ///
+    /// These overrides are full entity-paths prefixed by the override root.
+    ///
+    /// For example the individual override for `world/points` in the context of the query-id `1234`
+    /// would be found at: `data_query/1234/individual_overrides/world/points`.
     fn resolve_entity_overrides_for_path(
         &self,
         ctx: &StoreContext<'_>,
-        props_path: &EntityPath,
+        override_root: &EntityPath,
     ) -> EntityPropertyMap {
         re_tracing::profile_function!();
         let blueprint = ctx.blueprint;
 
         let mut prop_map = self.auto_properties.clone();
 
-        if let Some(tree) = blueprint.tree().subtree(props_path) {
+        if let Some(tree) = blueprint.tree().subtree(override_root) {
             tree.visit_children_recursively(&mut |path: &EntityPath| {
                 if let Some(props) = blueprint
                     .store()
                     .query_timeless_component_quiet::<EntityPropertiesComponent>(path)
                 {
                     let overridden_path =
-                        EntityPath::from(&path.as_slice()[props_path.len()..path.len()]);
+                        EntityPath::from(&path.as_slice()[override_root.len()..path.len()]);
                     prop_map.update(overridden_path, props.value.0);
                 }
             });
         }
         prop_map
     }
 
+    /// Recursively walk the [`DataResultTree`] and update the [`PropertyOverrides`] for each node.
+    ///
+    /// This will accumulate the group properties at each step down the tree, and then finally merge
+    /// with individual overrides at the leafs.
     fn update_overrides_recursive(
         &self,
         query_result: &mut DataQueryResult,
-        entity_overrides: &EntityOverrides,
+        override_context: &EntityOverrideContext,
         accumulated: &EntityProperties,
         handle: DataResultHandle,
     ) {
         if let Some((child_handles, accumulated)) =
             query_result.tree.lookup_node_mut(handle).and_then(|node| {
                 if node.data_result.is_group {
-                    let overridden_properties = entity_overrides
+                    let overridden_properties = override_context
                         .group
                         .get_opt(&node.data_result.entity_path);
 
@@ -595,7 +596,7 @@ impl DataQueryPropertyResolver<'_> {
 
                     Some((node.children.clone(), accumulated_properties))
                 } else {
-                    let overridden_properties = entity_overrides
+                    let overridden_properties = override_context
                         .individual
                         .get_opt(&node.data_result.entity_path);
 
@@ -620,7 +621,7 @@ impl DataQueryPropertyResolver<'_> {
             for child in child_handles {
                 self.update_overrides_recursive(
                     query_result,
-                    entity_overrides,
+                    override_context,
                     &accumulated,
                     child,
                 );
@@ -630,8 +631,10 @@ impl DataQueryPropertyResolver<'_> {
 }
 
 impl<'a> PropertyResolver for DataQueryPropertyResolver<'a> {
+    /// Recursively walk the [`DataResultTree`] and update the [`PropertyOverrides`] for each node.
     fn update_overrides(&self, ctx: &StoreContext<'_>, query_result: &mut DataQueryResult) {
-        let entity_overrides = self.resolve_entity_overrides(ctx);
+        re_tracing::profile_function!();
+        let entity_overrides = self.build_override_context(ctx);
 
         if let Some(root) = query_result.tree.root_handle() {
             self.update_overrides_recursive(

crates/re_space_view/src/lib.rs

@@ -9,7 +9,7 @@ mod data_query_blueprint;
 mod screenshot;
 mod unreachable_transform_reason;
 
-pub use data_query::{DataQuery, EntityOverrides, PropertyResolver};
+pub use data_query::{DataQuery, EntityOverrideContext, PropertyResolver};
 pub use data_query_blueprint::DataQueryBlueprint;
 pub use screenshot::ScreenshotMode;
 pub use unreachable_transform_reason::UnreachableTransformReason;

crates/re_viewer_context/src/selection_state.rs

@@ -117,6 +117,7 @@ pub struct SelectionState {
 impl SelectionState {
     /// Called at the start of each frame
     pub fn on_frame_start(&mut self, item_retain_condition: impl Fn(&Item) -> bool) {
+        // Use a different name so we don't get a collision in puffin.
         re_tracing::profile_scope!("SelectionState::on_frame_start");
 
         let history = self.history.get_mut();