token-value-map

Time-based data mapping library for animation and interpolation.

Overview

This crate provides types for storing and manipulating data that changes over time, with automatic interpolation between keyframes. It supports uniform (constant) and animated (time-varying) values with multiple interpolation methods.

Features

• Scalar types: Boolean, Integer, Real, String.
• Color
• 2D types: Vector2, Matrix3,
• 3D types: Vector3, Point3, Normal3, Matrix4.
• Collection variants of all types.
• Linear, quadratic, and hermite interpolation.
• Motion blur sampling support.
• Token-based value mapping with ustr.

Example

use frame_tick::Tick;
use token_value_map::{TokenValueMap, Value};
use ustr::ustr;

// Create a token-value map for animation parameters
let mut params = TokenValueMap::new();

// Add uniform (constant) values
params.insert(ustr("radius"), Value::uniform(5.0));

// Add animated values with keyframes
let animated_position = Value::animated(vec![
    (Tick::new(0), 0.0),
    (Tick::new(30), 100.0),
    (Tick::new(60), 50.0),
]).unwrap();
params.insert(ustr("x_position"), animated_position);

// Interpolate animated value at any time
if let Some(value) = params.get(&ustr("x_position")) {
    let interpolated = value.interpolate(Tick::new(15)); // Returns 50.0
}