Struct PlayerControlTimeline 

pub struct PlayerControlTimeline { /* private fields */ }

This queue allocates its complete event storage during construction.

Implementations

impl PlayerControlTimeline

pub fn new( capacity: usize, render_frame: u64, initial_control: PlayerControl, ) -> Result<Self, ControlTimelineCreateError>

pub fn with_policy( capacity: usize, render_frame: u64, initial_control: PlayerControl, policy: ControlTimelinePolicy, ) -> Result<Self, ControlTimelineCreateError>

pub const fn capacity(&self) -> usize

pub const fn len(&self) -> usize

pub const fn is_empty(&self) -> bool

pub const fn is_full(&self) -> bool

pub const fn policy(&self) -> ControlTimelinePolicy

pub const fn render_frame(&self) -> u64

pub const fn current_control(&self) -> PlayerControl

pub fn next_event(&self) -> Option<TimedPlayerControl>

pub const fn checkpoint(&self) -> PlayerControlTimelineCheckpoint

Captures the logical queue and render state in constant time.

This function does not allocate. Event consumption does not invalidate the result.

pub fn restore_checkpoint( &mut self, checkpoint: PlayerControlTimelineCheckpoint, ) -> Result<(), ControlTimelineCheckpointRestoreError>

Restores a checkpoint in constant time.

This function does not allocate. It rejects a marker from another timeline. It also rejects a marker after a slot write.

pub fn next_transition_offset(&self, block_frame_count: u32) -> Option<u32>

Returns the next transition inside the half-open render block.

pub fn enqueue( &mut self, event: TimedPlayerControl, ) -> Result<(), ControlTimelinePushError>

Adds one event without allocating or changing an accepted event.

pub fn visit_block( &mut self, block_frame_count: u32, visit: impl FnMut(ControlBlockItem), ) -> Result<(), ControlTimelineAdvanceError>

Visits every transition and render span in one half-open block.

Events at the block end remain pending for the next block.

pub fn snapshot(&self) -> ControlTimelineSnapshot

pub fn restore( &mut self, snapshot: &ControlTimelineSnapshot, ) -> Result<(), ControlTimelineRestoreError>

Restore validates all data before it changes the current timeline.

pub fn from_snapshot( snapshot: &ControlTimelineSnapshot, ) -> Result<Self, ControlTimelineRestoreError>

Trait Implementations

impl Debug for PlayerControlTimeline

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

Formats the value using the given formatter.