Struct GeoCache 

pub struct GeoCache {
    pub name: String,
    pub fps: f32,
    pub vertex_count: usize,
    pub frames: Vec<GeoCacheFrame>,
}

In-memory geometry cache containing all frames.

Fields

name: String

Human-readable name (stored in the file header).

fps: f32

Frames per second.

vertex_count: usize

Number of vertices per frame (must be constant across all frames).

frames: Vec<GeoCacheFrame>

All frames in chronological order.

Implementations

impl GeoCache

pub fn new(name: &str, fps: f32, vertex_count: usize) -> Self

Create a new empty cache.

pub fn add_frame(&mut self, frame: GeoCacheFrame) -> Result<(), String>

Append a frame. Returns an error when vertex counts mismatch, or when the frame has normals but the existing frames do not (or vice-versa).

pub fn frame_count(&self) -> usize

Number of frames stored.

pub fn duration_seconds(&self) -> f32

Total animation duration in seconds (last frame time, or 0 if empty).

pub fn get_frame(&self, index: usize) -> Option<&GeoCacheFrame>

Access a frame by index.

pub fn sample(&self, time_seconds: f32) -> Option<Vec<[f32; 3]>>

Linearly interpolate vertex positions at time_seconds.

Clamps to the first or last frame when time_seconds is out of the recorded range. Returns None only when the cache is empty.

pub fn write(&self, path: &Path) -> Result<()>

Write the cache to a binary file.

pub fn read(path: &Path) -> Result<Self>

Read a cache from a binary file.

pub fn validate(path: &Path) -> Result<()>

Validate a cache file (check magic, version, sizes).

Trait Implementations

impl Clone for GeoCache

fn clone(&self) -> GeoCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GeoCache

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

Formats the value using the given formatter.