Struct DecodedClip 

pub struct DecodedClip {
    pub dims: [u32; 3],
    pub pivot: [f32; 3],
    pub voxel_world_size: f32,
    pub occ_words_per_col: u32,
    pub loop_mode: LoopMode,
    pub frames: Vec<VoxelFrame>,
    pub dirs: Vec<Vec<u32>>,
    pub durations: Vec<u32>,
}

A decoded clip: every frame expanded to a full VoxelFrame plus its recomputed dirs (parallel to frames[i].colors) and resolved durations. The runtime flipbook.

Fields

dims: [u32; 3]

pivot: [f32; 3]

voxel_world_size: f32

occ_words_per_col: u32

loop_mode: LoopMode

frames: Vec<VoxelFrame>

dirs: Vec<Vec<u32>>

Per-frame surface-normal LUT indices, parallel to frames[i].colors.

durations: Vec<u32>

Implementations

impl DecodedClip

pub fn frame_count(&self) -> usize

pub fn total_ms(&self) -> u32

Total loop length in ms (sum of frame durations), saturating rather than overflowing for absurdly long clips.

pub fn pad_stats(&self) -> PadStats

Padding diagnostics — declared dims vs. the tight content bbox across all frames (R3). See pad_stats / PadStats.

pub fn frame_at(&self, elapsed_ms: u32) -> usize

The frame index to show after elapsed_ms of playback, honouring the clip’s LoopMode and per-frame durations. Pure — the host (or the facade’s clip-instance clocks) drives set_clip_instance_frame from this. Empty clip ⇒ 0.

• LoopMode::Loop: wraps modulo the total length.
• LoopMode::Once: holds the last frame past the end.
• LoopMode::PingPong: bounces 0→N-1→0 over 2·total.

Trait Implementations

impl Clone for DecodedClip

fn clone(&self) -> DecodedClip

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DecodedClip

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

Formats the value using the given formatter.