Crate aada 

aada —— 纯 Rust 的 2D 骨骼动画引擎库

兼容 Spine 4.x 导出格式（JSON + atlas）。本库只负责 求解到“分层 Mesh + 各 Mesh 渲染设置“为止，之后的绘制交给渲染器（bevy 集成在独立的 aada-bevy crate 中）。无渲染器依赖，仅依赖 glam / serde。

架构

• cacl：纯计算（仿射矩阵、贝塞尔曲线采样），与数据无关。
• data::store：导入层。把 spine JSON / atlas 解析为可 serde 序列化的中间结构， 再经 to_rt() 转成运行时索引化数据。
• data::runtime：运行时层。索引化的静态数据集合 + 每帧引擎管线。
• custom_index / vec_map / utils / error：索引容器与通用工具。

核心设计：解析期一次性把名称解析为强类型索引（BoneIdx / SlotIdx / MeshIdx / SkinIdx / AnimIdx 等），运行时零字符串查找、全部走索引。静态数据（骨骼层级、皮肤、 网格、动画）与可变状态（data::runtime::skeleton::Pose 每帧变换、约束状态）分离。

快速开始

use aada::prelude::*;

// 1. 构建运行时（spine JSON + atlas 文本）
let (rt, _pages) = build_rt(
    &"{\"skeleton\":{}}".to_string(),
    &"example.png\nsize: 1024, 1024".to_string(),
)
.unwrap();

// 2. 按名称取索引（之后全走索引）
let anim = rt.animates.get_index("walk").unwrap();
let skin = rt.skins.get_index("default").unwrap();

// 3. 每帧走分步管线（config 跨帧复用，连续时间采样 O(1) 加速），
//    中间可插入自定义逻辑（如约束前操纵骨骼、覆盖约束参数）
let mut config = AnimateConfig::new();
for t in 0..60 {
    let sampled = rt.sample(anim, &mut config, t as f32 / 60.0);
    let mut pose = rt.pose_from_sample(&sampled); // 可在此修改 pose（约束前骨骼操纵）
    let state = rt.constraint_state(&sampled); // 可在此覆盖约束参数
    rt.apply_constraint_state(&mut pose, &state);
    let payloads = rt.build_payloads(&[skin], &sampled, &mut pose);
    // payloads: Vec<MeshPayload>，顺序即渲染顺序（靠后覆盖靠前）
}

Modules

cacl

custom_index

类型化索引基础设施：解析期把名称一次性映射为强类型索引，运行时零字符串查找。

data

error

引擎统一错误类型。

prelude

常用类型的预导入模块：use aada::prelude::*; 一次引入引擎最常用的类型与函数。

utils

通用小工具：默认值便捷函数、Option 写回 trait、占位类型宏、BMP 编码。

vec_map

基于 Vec 的保序 Map：保持插入顺序并像 map 一样序列化/反序列化。

Macros

new_index

生成强类型索引类型的宏。

placeholder_type

创建占位符类型的宏：支持各种 trait，但任何实例化都会 panic。