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]

Fixed bounding box [xsiz, ysiz, zsiz] in voxels, copied from the source VoxelClip.

pivot: [f32; 3]

Model pivot in fractional voxel units from the box’s minimum corner, copied from the source clip.

voxel_world_size: f32

Render scale (1 voxel = this many world units), copied from the source clip.

occ_words_per_col: u32

u32 occupancy words per column: ceil(dims[2] / 32).

loop_mode: LoopMode

Playback wrap behaviour, copied from the source clip.

frames: Vec<VoxelFrame>

Every frame fully reconstructed (deltas applied), in playback order.

dirs: Vec<Vec<u32>>

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

durations: Vec<u32>

Resolved per-frame durations (ms) — always one entry per frame (uniform default_frame_ms when the clip stored none).

Implementations

impl DecodedClip

pub fn frame_count(&self) -> usize

Number of frames in the clip (≥ 1 for a decodable clip).

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.