49 lines
1.4 KiB
Markdown
49 lines
1.4 KiB
Markdown
# Transform 组件分析
|
||
|
||
## 组件职责
|
||
|
||
`Transform.*` 负责实体空间变换数据：
|
||
|
||
- 位置、旋转、朝向、缩放存储；
|
||
- 世界矩阵与逆矩阵计算；
|
||
- 脏标记记录与批量更新入口。
|
||
|
||
## 数据布局
|
||
|
||
`Transform.cpp` 采用并行数组（SoA）：
|
||
|
||
- `positions / rotations / orientations / scales`
|
||
- `to_world / inv_world`
|
||
- `has_transform`：矩阵缓存有效位
|
||
- `changes_from_previous_frame`：逐帧脏标记
|
||
|
||
## 创建与绑定
|
||
|
||
`transform::create(init_info, entity)` 使用 `entity_id` 的索引位定位槽位：
|
||
|
||
- 若槽位已存在，覆写其数据并标记脏；
|
||
- 若槽位不存在，扩容所有并行数组；
|
||
- 返回 `transform::component{ transform_id{ entity.get_id() } }`。
|
||
|
||
这说明 Transform 不维护独立 free list，而是复用实体索引空间。
|
||
|
||
## 读写策略
|
||
|
||
- 写接口（`set_rotation/position/scale`）只改数据与脏标记；
|
||
- `get_transform_matrices` 在读取时按需计算矩阵；
|
||
- 通过 `has_transform` 避免重复矩阵重算。
|
||
|
||
## 批量更新机制
|
||
|
||
`transform::update(cache, count)` 接收 `component_cache` 数组：
|
||
|
||
- 每条 cache 带 `flags` 指示写哪些字段；
|
||
- 逐条落地到内部并行数组；
|
||
- 适配脚本系统“先缓存，后统一提交”的帧内流程。
|
||
|
||
## 设计特点
|
||
|
||
- 读取快：索引直达；
|
||
- 可批处理：cache + flags；
|
||
- 低耦合：外部通过句柄和 cache 交互，不直接暴露内部数组。
|