Struct SubSelection 

pub struct SubSelection { /* private fields */ }

A set of selected sub-objects (faces, vertices, edges, or points) across one or more parent objects.

Parallel to crate::interaction::selection::Selection but operates at sub-object granularity. Each entry pairs a parent object_id with a SubObjectRef. No ordering is maintained beyond the tracked primary.

Typical usage

Hold a SubSelection alongside a Selection. Use Selection to track which objects are selected at object level; use SubSelection to track which specific faces or points within those objects are highlighted.

// On rect-pick:
let rect_result = pick_rect(...);
sub_sel.clear();
sub_sel.extend_from_rect_pick(&rect_result);

// On ray-pick (face highlight):
if let Some(sub) = hit.sub_object {
    sub_sel.select_one(hit.id, sub);
}

Implementations

impl SubSelection

pub fn new() -> Self

Create an empty sub-selection.

pub fn version(&self) -> u64

Monotonically increasing generation counter.

Incremented by wrapping_add(1) on every mutation. Compare against a cached value to detect changes without re-hashing.

pub fn select_one(&mut self, object_id: NodeId, sub: SubObjectRef)

Clear and select exactly one sub-object.

pub fn toggle(&mut self, object_id: NodeId, sub: SubObjectRef)

Toggle a sub-object in or out of the selection.

If added, it becomes the primary. If removed, primary is cleared or set to an arbitrary remaining entry.

pub fn add(&mut self, object_id: NodeId, sub: SubObjectRef)

Add a sub-object without clearing others.

pub fn remove(&mut self, object_id: NodeId, sub: SubObjectRef)

Remove a sub-object from the selection.

pub fn clear(&mut self)

Clear the entire sub-selection.

pub fn extend( &mut self, items: impl IntoIterator<Item = (NodeId, SubObjectRef)>, )

Extend from an iterator of (object_id, SubObjectRef) pairs.

The last pair becomes primary.

pub fn extend_from_rect_pick(&mut self, result: &RectPickResult)

Populate from a RectPickResult.

Adds all sub-objects from the rect pick without clearing the current selection. Call clear first if you want a fresh selection.

pub fn contains(&self, object_id: NodeId, sub: SubObjectRef) -> bool

Whether a specific sub-object is selected.

pub fn primary(&self) -> Option<(NodeId, SubObjectRef)>

The most recently selected (object_id, SubObjectRef) pair.

pub fn iter(&self) -> impl Iterator<Item = &(NodeId, SubObjectRef)>

Iterate over all selected (object_id, SubObjectRef) pairs.

pub fn for_object( &self, object_id: NodeId, ) -> impl Iterator<Item = SubObjectRef> + '_

All sub-object refs for a specific parent object.

pub fn len(&self) -> usize

Number of selected sub-objects.

pub fn is_empty(&self) -> bool

Whether the sub-selection is empty.

pub fn face_count(&self) -> usize

Count of selected faces across all objects.

pub fn point_count(&self) -> usize

Count of selected points across all objects.

pub fn vertex_count(&self) -> usize

Count of selected vertices across all objects.

pub fn voxel_count(&self) -> usize

Count of selected voxels across all objects.

pub fn cell_count(&self) -> usize

Count of selected cells across all objects.

Trait Implementations

impl Clone for SubSelection

fn clone(&self) -> SubSelection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SubSelection

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SubSelection

fn default() -> SubSelection

Returns the “default value” for a type.