106 lines
3.4 KiB
Markdown
106 lines
3.4 KiB
Markdown
|
# MSH animation
|
|||
|
|
|
|||
|
|
Документ описывает анимационные ресурсы MSH: `Res8`, `Res19` и runtime-интерполяцию.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 1.13. Ресурсы анимации: Res8 и Res19
|
|||
|
|
|
|||
|
|
- **Res8** — массив анимационных ключей фиксированного размера 24 байта.
|
|||
|
|
- **Res19** — `uint16` mapping‑массив «frame → keyIndex` (с per-node смещением).
|
|||
|
|
|
|||
|
|
### 1.13.1. Формат Res8 (ключ 24 байта)
|
|||
|
|
|
|||
|
|
```c
|
|||
|
|
struct AnimKey24 {
|
|||
|
|
float posX; // +0x00
|
|||
|
|
float posY; // +0x04
|
|||
|
|
float posZ; // +0x08
|
|||
|
|
float time; // +0x0C
|
|||
|
|
int16_t qx; // +0x10
|
|||
|
|
int16_t qy; // +0x12
|
|||
|
|
int16_t qz; // +0x14
|
|||
|
|
int16_t qw; // +0x16
|
|||
|
|
};
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Декодирование quaternion-компонент:
|
|||
|
|
|
|||
|
|
```c
|
|||
|
|
q = s16 * (1.0f / 32767.0f)
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 1.13.2. Формат Res19
|
|||
|
|
|
|||
|
|
Res19 читается как непрерывный массив `uint16`:
|
|||
|
|
|
|||
|
|
```c
|
|||
|
|
uint16_t map[]; // размер = size(Res19)/2
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Per-node управление mapping'ом берётся из заголовка узла Res1:
|
|||
|
|
|
|||
|
|
- `node.hdr2` (`Res1 + 0x04`) = `mapStart` (`0xFFFF` => map отсутствует);
|
|||
|
|
- `node.hdr3` (`Res1 + 0x06`) = `fallbackKeyIndex` и одновременно верхняя граница валидного `map`‑значения.
|
|||
|
|
|
|||
|
|
### 1.13.3. Выбор ключа для времени `t` (`sub_10012880`)
|
|||
|
|
|
|||
|
|
1) Вычислить frame‑индекс:
|
|||
|
|
|
|||
|
|
```c
|
|||
|
|
frame = (int64)(t - 0.5f); // x87 FISTP-путь
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Для строгой 1:1 эмуляции используйте именно поведение x87 `FISTP` (а не «упрощённый floor»), т.к. путь в оригинале опирается на FPU rounding mode.
|
|||
|
|
|
|||
|
|
2) Проверка условий fallback:
|
|||
|
|
|
|||
|
|
- `frame >= model.animFrameCount` (`model+0x9C`, из `NResEntry(Res19).attr2`);
|
|||
|
|
- `mapStart == 0xFFFF`;
|
|||
|
|
- `map[mapStart + frame] >= fallbackKeyIndex`.
|
|||
|
|
|
|||
|
|
Если любое условие истинно:
|
|||
|
|
|
|||
|
|
```c
|
|||
|
|
keyIndex = fallbackKeyIndex;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Иначе:
|
|||
|
|
|
|||
|
|
```c
|
|||
|
|
keyIndex = map[mapStart + frame];
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
3) Сэмплирование:
|
|||
|
|
|
|||
|
|
- `k0 = Res8[keyIndex]`
|
|||
|
|
- `k1 = Res8[keyIndex + 1]` (для интерполяции сегмента)
|
|||
|
|
|
|||
|
|
Пути:
|
|||
|
|
|
|||
|
|
- если `t == k0.time` → взять `k0`;
|
|||
|
|
- если `t == k1.time` → взять `k1`;
|
|||
|
|
- иначе `alpha = (t - k0.time) / (k1.time - k0.time)`, `pos = lerp(k0.pos, k1.pos, alpha)`, rotation смешивается через fastproc‑интерполятор quaternion.
|
|||
|
|
|
|||
|
|
### 1.13.4. Межкадровое смешивание (`sub_10012560`)
|
|||
|
|
|
|||
|
|
Функция смешивает два сэмпла (например, из двух animation time-позиций) с коэффициентом `blend`:
|
|||
|
|
|
|||
|
|
1) получить два `(quat, pos)` через `sub_10012880`;
|
|||
|
|
2) выполнить shortest‑path коррекцию знака quaternion:
|
|||
|
|
|
|||
|
|
```c
|
|||
|
|
if (|q0 + q1|^2 < |q0 - q1|^2) q1 = -q1;
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
3) смешать quaternion (fastproc) и построить orientation‑матрицу;
|
|||
|
|
4) translation писать отдельно как `lerp(pos0, pos1, blend)` в ячейки `m[3], m[7], m[11]`.
|
|||
|
|
|
|||
|
|
### 1.13.5. Что хранится в `Res19.attr2`
|
|||
|
|
|
|||
|
|
При загрузке `sub_10015FD0` записывает `NResEntry(Res19).attr2` в `model+0x9C`.
|
|||
|
|
Это поле используется как верхняя граница frame‑индекса в п.1.13.3.
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|