Struct CheckpointManager 

pub struct CheckpointManager {
    pub max_checkpoints: usize,
    /* private fields */
}

Manages a bounded list of checkpoints.

When the checkpoint count exceeds max_checkpoints, the oldest (by created_at) is evicted automatically.

Fields

max_checkpoints: usize

Implementations

impl CheckpointManager

pub fn new(max: usize) -> Self

Create a new manager with a capacity cap.

pub fn create( &mut self, name: impl Into<String>, pos: Vec2, snapshot: WorldSnapshot, ) -> u64

Create a new checkpoint and return its id.

If the checkpoint list is at capacity, the oldest checkpoint is removed.

pub fn create_with_time( &mut self, name: impl Into<String>, pos: Vec2, snapshot: WorldSnapshot, created_at: f64, ) -> u64

Like create but with an explicit game-time timestamp.

pub fn get(&self, id: u64) -> Option<&Checkpoint>

Get a checkpoint by id.

pub fn get_mut(&mut self, id: u64) -> Option<&mut Checkpoint>

Get a mutable checkpoint by id.

pub fn get_nearest(&self, pos: Vec2) -> Option<&Checkpoint>

Get the checkpoint closest to pos (Euclidean distance).

pub fn get_most_recent(&self) -> Option<&Checkpoint>

Get the most recently created checkpoint (highest created_at).

pub fn get_within_radius(&self, pos: Vec2, radius: f32) -> Vec<&Checkpoint>

Get all checkpoints within radius of pos, sorted by distance.

pub fn list(&self) -> &[Checkpoint]

Iterate over all checkpoints.

pub fn remove(&mut self, id: u64) -> bool

Remove the checkpoint with the given id. Returns true if found.

pub fn clear(&mut self)

Remove all checkpoints.

pub fn len(&self) -> usize

Number of checkpoints.

pub fn is_empty(&self) -> bool

pub fn is_at_cap(&self) -> bool

pub fn serialize_all(&self) -> Vec<u8>

Serialize all checkpoints to a JSON byte vector.

pub fn deserialize_all( bytes: &[u8], ) -> Result<Vec<Checkpoint>, DeserializeError>

Deserialize checkpoints from a JSON byte vector (as produced by serialize_all).

pub fn load_from_bytes(&mut self, bytes: &[u8]) -> Result<(), DeserializeError>

Restore checkpoints from bytes, replacing any existing ones.