Struct CellIndex 

pub struct CellIndex { /* private fields */ }

Station-local 3D cell index.

Implementations

impl CellIndex

pub fn new(grid: GridSpec) -> Self

Creates an empty cell index.

pub fn with_capacity( grid: GridSpec, entity_capacity: usize, occupied_cell_capacity: usize, ) -> Self

Creates an empty index with explicit entity and occupied-cell capacity.

pub fn reserve(&mut self, additional_entities: usize, additional_cells: usize)

Reserves capacity for additional indexed entities and occupied cells.

pub fn reclaim_retained_capacity(&mut self)

Releases unused retained map, bucket, and multi-cell membership storage.

pub fn entity_capacity(&self) -> usize

Indexed-entity entries currently retained without another rehash.

pub fn occupied_cell_capacity(&self) -> usize

Occupied-cell entries currently retained without another rehash.

pub const fn grid(&self) -> GridSpec

Returns the grid spec.

pub fn upsert( &mut self, handle: EntityHandle, position: Position3, bounds: Bounds, )

Inserts or updates an entity in all cells touched by its bounds.

pub fn upsert_tracked( &mut self, handle: EntityHandle, position: Position3, bounds: Bounds, ) -> CellIndexUpdate

Inserts or updates an entity and reports whether index membership changed.

pub fn upsert_with_scratch( &mut self, handle: EntityHandle, position: Position3, bounds: Bounds, scratch: &mut CellIndexUpdateScratch, ) -> CellIndexUpdateReport

Inserts or updates membership with reusable storage and detailed work counters.

pub fn remove(&mut self, handle: EntityHandle) -> bool

Removes an entity from the index.

pub fn query_aabb(&self, aabb: Aabb3) -> Vec<EntityHandle>

Queries candidate handles overlapping an AABB.

pub fn query_aabb_into<'a>( &self, aabb: Aabb3, scratch: &'a mut CellQueryScratch, ) -> &'a [EntityHandle]

Queries candidate handles overlapping an AABB using caller scratch.

pub fn query_sphere(&self, center: Position3, radius: f32) -> Vec<EntityHandle>

Queries candidate handles inside cells touched by a sphere.

pub fn query_sphere_into<'a>( &self, center: Position3, radius: f32, scratch: &'a mut CellQueryScratch, ) -> &'a [EntityHandle]

Queries candidate handles inside cells touched by a sphere using caller scratch.

pub fn handles_in_cell(&self, cell: CellCoord3) -> Vec<EntityHandle>

Returns handles indexed directly in one cell.

pub fn handles_in_cell_slice(&self, cell: CellCoord3) -> &[EntityHandle]

Returns handles indexed directly in one cell without allocating.

pub fn cells_for_handle(&self, handle: EntityHandle) -> Option<&[CellCoord3]>

Returns cells currently occupied by one entity handle.

pub fn entity_count(&self) -> usize

Number of indexed entities.

pub fn point_membership_count(&self) -> usize

Number of entities using allocation-free single-cell membership.

pub fn occupied_cell_count(&self) -> usize

Number of non-empty cells.

pub fn cell_occupancy(&self) -> Vec<CellOccupancy>

Returns deterministic occupancy counts for all non-empty cells.

pub fn cell_occupancy_into(&self, out: &mut Vec<CellOccupancy>)

Writes deterministic occupancy counts into caller-owned reusable storage.

Trait Implementations

impl Clone for CellIndex

fn clone(&self) -> CellIndex

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CellIndex

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

Formats the value using the given formatter.