Struct SharedWorld 

pub struct SharedWorld { /* private fields */ }

A lock-free double buffer for compact entity replication. This points into a SharedArrayBuffer allocated by the Main Thread.

Implementations

impl SharedWorld

pub unsafe fn from_ptr(ptr: *mut u8) -> Self

Initializes the SharedWorld from a raw memory pointer.

Safety

The pointer must remain valid for the lifetime of this object and must point to a region of at least SHARED_MEMORY_SIZE bytes.

pub fn new() -> Self

Creates a new SharedWorld by allocating its own memory (fallback/local use).

pub fn is_valid(ptr: *mut u8) -> bool

Validates if a raw pointer was registered by a living SharedWorld instance.

pub fn as_ptr(&self) -> *mut u8

Returns the raw pointer to the base of the shared world buffer.

pub fn active_index(&self) -> u32

Returns the active buffer index (0 or 1).

pub fn entity_count(&self) -> u32

Returns the entity count for the active buffer.

pub fn tick(&self) -> u64

Returns the server tick for the active buffer.

pub fn sub_tick_fraction(&self) -> f32

Returns the sub-tick progress fraction (0.0 to 1.0).

pub fn set_sub_tick_fraction(&mut self, fraction: f32)

Updates the sub-tick progress fraction.

pub fn get_read_buffer(&self) -> &[SabSlot]

Returns the entities currently visible to readers.

Both the active buffer index and the entity count are derived from a single atomic load, so readers always see a consistent pair.

pub fn get_write_buffer(&mut self) -> &mut [SabSlot]

Returns the buffer currently available for writing (inactive buffer).

pub fn commit_write(&mut self, entity_count: u32, tick: u64)

Swaps the active buffer and updates the entity count and tick.

pub fn set_room_bounds( &mut self, min_x: f32, min_y: f32, max_x: f32, max_y: f32, )

Updates the room bounds using a seqlock so readers always see a consistent rectangle. The sequence number is bumped to an odd value before writing and back to an even value (with Release ordering) after, matching the acquire fence in get_room_bounds.

pub fn get_room_bounds(&self) -> (f32, f32, f32, f32)

Reads the room bounds, retrying if a concurrent write is detected via the seqlock. Guaranteed to return a consistent (non-torn) rectangle.

Trait Implementations

impl Default for SharedWorld

fn default() -> Self

Returns the “default value” for a type.

impl Drop for SharedWorld

fn drop(&mut self)

Executes the destructor for this type.