Struct StreamingClip 

pub struct StreamingClip { /* private fields */ }

A seekable, O(1-frame)-memory cursor over a VoxelClip’s I/P stream — the streaming alternative to DecodedClip, which materialises every frame (and which the GPU/CPU flipbook then holds N volumes for). For a huge clip this keeps one reconstructed frame plus the compact encoded stream instead of N full frames.

Seeking to a frame replays deltas from the nearest preceding keyframe; stepping forward from the current frame is incremental. Drive it from frame_at like the flipbook, then rebuild a single sprite model from current_frame (+ current_dirs for the GPU) each time the frame changes — e.g. via roxlap_core::SpriteDense::from_voxel_frame or SceneRenderer::refresh_sprite_model.

Implementations

impl StreamingClip

pub fn new(clip: &VoxelClip) -> Result<StreamingClip, DecodeError>

Build a streaming cursor over clip and reconstruct frame 0.

Errors

DecodeError::DeltaBeforeKey if the stream is empty or doesn’t start with a keyframe; otherwise the same per-frame errors as VoxelClip::decode (surfaced lazily while seeking).

pub fn frame_count(&self) -> usize

pub fn dims(&self) -> [u32; 3]

pub fn pivot(&self) -> [f32; 3]

pub fn voxel_world_size(&self) -> f32

pub fn loop_mode(&self) -> LoopMode

pub fn durations(&self) -> &[u32]

pub fn current_index(&self) -> usize

Frame index currently reconstructed.

pub fn current_frame(&self) -> &VoxelFrame

The currently-reconstructed frame.

pub fn current_dirs(&self) -> &[u32]

Per-voxel dir LUT indices for the current frame, parallel to current_frame().colors (for GPU sprite-model upload).

pub fn seek(&mut self, frame: usize) -> Result<&VoxelFrame, DecodeError>

Seek to frame (clamped to the last frame) and return the reconstructed VoxelFrame. Forward seeks step incrementally; backward / random seeks replay from the nearest preceding keyframe.

Errors

Per-frame DecodeErrors from a malformed stream (out-of-range delta column, invalid reconstructed frame).

Trait Implementations

impl Clone for StreamingClip

fn clone(&self) -> StreamingClip

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StreamingClip

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

Formats the value using the given formatter.