diff options
| author | Valentin Popov <valentin@popov.link> | 2026-02-19 10:07:04 +0300 |
|---|---|---|
| committer | Valentin Popov <valentin@popov.link> | 2026-02-19 10:07:04 +0300 |
| commit | 0d7ae6a017b8b2bf26c5c14c39cb62b599e8262d (patch) | |
| tree | 6398ba4a13d22656af75395db6de2e4f84d6c875 /docs/specs/fxid.md | |
| parent | a281ffa32ea615670d369503692f057b2dc60e6f (diff) | |
| download | fparkan-0d7ae6a017b8b2bf26c5c14c39cb62b599e8262d.tar.xz fparkan-0d7ae6a017b8b2bf26c5c14c39cb62b599e8262d.zip | |
Документирование и обновление спецификаций
- Обновлены спецификации `runtime-pipeline`, `sound`, `terrain-map-loading`, `texture`, `ui` и `wear`.
- Добавлены разделы о статусе покрытия и оставшихся задачах для достижения 100% завершенности.
- Внесены уточнения по архитектурным ролям, минимальным контрактам и требованиям к toolchain для каждой подсистемы.
- Уточнены форматы данных и правила взаимодействия между компонентами системы.
Diffstat (limited to 'docs/specs/fxid.md')
| -rw-r--r-- | docs/specs/fxid.md | 18 |
1 files changed, 16 insertions, 2 deletions
diff --git a/docs/specs/fxid.md b/docs/specs/fxid.md index 22d02d8..f723e17 100644 --- a/docs/specs/fxid.md +++ b/docs/specs/fxid.md @@ -3,7 +3,7 @@ `FXID` — бинарный формат эффекта в движке Parkan: Iron Strategy. Эта страница задаёт контракт формата и исполнения на уровне, достаточном для 1:1 порта рендера/симуляции эффектов и для lossless-инструментов. -Связанный контейнер: [NRes / RsLi](nres.md). +Связанные контейнеры: [NRes](nres.md), [RsLi](rsli.md). ## 1. Контейнер @@ -185,4 +185,18 @@ struct ResourceRef64 { ## 11. Статус валидации - Формальные инварианты FXID зафиксированы в `tools/msh_doc_validator.py` и `tools/fxid_abs100_audit.py`. -- В текущем рабочем окружении нет полного набора игровых архивов (`testdata` без payload), поэтому массовая повторная проверка корпуса здесь не выполнялась. +- На полном retail-корпусе `testdata/Parkan - Iron Strategy` проверено `923/923` FXID payload без ошибок. + +## 12. Статус покрытия и что осталось до 100% + +Закрыто: + +1. Контейнер FXID, fixed-size командный поток, opcode-покрытие `1..10`. +2. Базовый runtime-контур исполнения эффекта. +3. Корпусная валидация формата на retail-данных. + +Осталось: + +1. Полная field-level семантика payload каждого opcode для авторинга новых эффектов «с нуля». +2. Формальная спецификация всех `time_mode` веток на уровне точных числовых формул и edge-case поведения. +3. Полный набор пиксельных parity-тестов FX (оригинал vs новый рендер) на фиксированных сценах. |
