Struct SpatialMessages3D 

pub struct SpatialMessages3D<M> { /* private fields */ }

3D spatial message list with spatial-hashing neighbor lookup.

Same concept as SpatialMessages2D but for 3D positions.

Mirrors FlameGPU2 MessageSpatial3D and its 3D Partition Boundary Matrix.

Implementations

impl<M: Clone> SpatialMessages3D<M>

pub fn new(radius: f32) -> Result<Self, MessageConfigError>

Create a new 3D spatial message list.

pub fn output(&mut self, message: M, x: f32, y: f32, z: f32)

Output a message at a 3D position (phase 1).

pub fn try_output( &mut self, message: M, x: f32, y: f32, z: f32, ) -> Result<(), MessagePhaseError>

Try to output a message at a 3D position, returning a typed phase error on misuse.

pub fn finalize(&mut self)

Build the spatial index (phase boundary).

pub fn read_nearby( &self, x: f32, y: f32, z: f32, radius: f32, ) -> SpatialIter3D<'_, M>

Iterate messages within radius of (x, y, z) (phase 2).

Returns an iterator yielding (message_ref, distance_squared).

Panics

Panics if called before finalize. Use try_read_nearby to handle phase errors explicitly.

pub fn try_read_nearby( &self, x: f32, y: f32, z: f32, radius: f32, ) -> Result<SpatialIter3D<'_, M>, MessagePhaseError>

Try to iterate messages within radius of (x, y, z) (phase 2).

pub fn is_finalized(&self) -> bool

Whether the message buffer has been finalized for reading.

pub fn len(&self) -> usize

Number of messages.

pub fn is_empty(&self) -> bool

Returns true if no messages have been output.

pub fn clear(&mut self)

Clear all messages and the spatial index for the next step.

Trait Implementations

impl<M: Clone> Clone for SpatialMessages3D<M>

fn clone(&self) -> SpatialMessages3D<M>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<M: Debug> Debug for SpatialMessages3D<M>

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

Formats the value using the given formatter.