# `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
```rust
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
}
```
## License
Licensed under either of
- Apache License, Version 2.0
([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
- BSD-3-Clause license
([LICENSE-BSD](LICENSE-BSD) or https://opensource.org/licenses/BSD-3-Clause)
- MIT license
([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
- Zlib license
([LICENSE-ZLIB](LICENSE-ZLIB) or http://opensource.org/licenses/Zlib)
at your option.
### Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
quad-licensed as above, without any additional terms or conditions.