113 lines
3.3 KiB
Markdown
113 lines
3.3 KiB
Markdown
# FXID
|
||
|
||
Документ описывает контейнер ресурса эффекта и формат команд эффекта.
|
||
|
||
---
|
||
|
||
## 3.2. Контейнер ресурса эффекта
|
||
|
||
Эффекты в игровых архивах хранятся как NRes‑entries типа:
|
||
|
||
- `0x44495846` (`"FXID"`).
|
||
|
||
Парсер эффекта находится в `Effect.dll!sub_10007650`.
|
||
|
||
## 3.3. Формат payload эффекта
|
||
|
||
### 3.3.1. Header (первые 60 байт)
|
||
|
||
```c
|
||
struct FxHeader60 {
|
||
uint32_t cmdCount; // +0x00
|
||
uint32_t globalFlags; // +0x04
|
||
float durationSec; // +0x08 (дальше умножается на 1000.0)
|
||
uint32_t unk0C; // +0x0C
|
||
uint32_t flags10; // +0x10 (используются биты 0x40 и 0x400)
|
||
uint8_t reserved[0x2C];// +0x14..+0x3B
|
||
};
|
||
```
|
||
|
||
Поток команд начинается строго с `offset 0x3C`.
|
||
|
||
### 3.3.2. Командный поток
|
||
|
||
Каждая команда начинается с `uint32 cmdWord`, где:
|
||
|
||
- `opcode = cmdWord & 0xFF`;
|
||
- `enabled = (cmdWord >> 8) & 1` (копируется в `obj+4`).
|
||
|
||
Размер команды зависит от opcode и прибавляется в **байтах** (`add edi, ...` в ASM):
|
||
|
||
| Opcode | Размер записи |
|
||
|--------|---------------|
|
||
| 1 | 224 |
|
||
| 2 | 148 |
|
||
| 3 | 200 |
|
||
| 4 | 204 |
|
||
| 5 | 112 |
|
||
| 6 | 4 |
|
||
| 7 | 208 |
|
||
| 8 | 248 |
|
||
| 9 | 208 |
|
||
| 10 | 208 |
|
||
|
||
Никакого межкомандного выравнивания нет: следующая команда сразу после `size(opcode)`.
|
||
|
||
## 3.4. Runtime-классы команд (vtable mapping)
|
||
|
||
В `sub_10007650` для каждого opcode создаётся объект конкретного типа:
|
||
|
||
- `op1` → `off_1001E78C`
|
||
- `op2` → `off_1001F048`
|
||
- `op3` → `off_1001E770`
|
||
- `op4` → `off_1001E754`
|
||
- `op5` → `off_1001E360`
|
||
- `op6` → `off_1001E738`
|
||
- `op7` → `off_1001E228`
|
||
- `op8` → `off_1001E71C`
|
||
- `op9` → `off_1001E700`
|
||
- `op10` → `off_1001E24C`
|
||
|
||
`flags10 & 0x400` включает глобальный runtime-флаг менеджера эффекта (`manager+0xA0`).
|
||
|
||
## 3.5. Алгоритм загрузки эффекта (1:1)
|
||
|
||
```c
|
||
read header60
|
||
ptr = data + 0x3C
|
||
for i in 0..cmdCount-1:
|
||
op = ptr[0] & 0xFF
|
||
obj = new CommandClass(op)
|
||
obj->enabled = (ptr[0] >> 8) & 1
|
||
obj->raw = ptr
|
||
manager.attach(obj)
|
||
ptr += sizeByOpcode(op)
|
||
```
|
||
|
||
Ошибка формата:
|
||
|
||
- неизвестный opcode;
|
||
- выход за пределы буфера до обработки `cmdCount`;
|
||
- непустой «хвост» после `cmdCount` команд (для строгого валидатора).
|
||
|
||
## 3.6. Проверка на реальных данных
|
||
|
||
Для `testdata/nres/effects.rlb` (923 entries):
|
||
|
||
- `opcode` всегда в диапазоне `1..10`;
|
||
- stream полностью покрывает payload без хвоста;
|
||
- частоты opcode:
|
||
- `1: 618`
|
||
- `2: 517`
|
||
- `3: 1545`
|
||
- `4: 202`
|
||
- `5: 31`
|
||
- `7: 1161`
|
||
- `8: 237`
|
||
- `9: 266`
|
||
- `10: 160`
|
||
- `6` в этом наборе не встретился, но поддерживается парсером.
|
||
|
||
---
|
||
|