diff options
Diffstat (limited to 'docs/index.md')
| -rw-r--r-- | docs/index.md | 102 |
1 files changed, 32 insertions, 70 deletions
diff --git a/docs/index.md b/docs/index.md index ea17a63..b6e62f4 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,72 +1,34 @@ # FParkan -FParkan -- самостоятельная техническая книга о восстановлении игрового движка -Iron3D из *Parkan: Iron Strategy*. Она ведёт от запуска оригинальной программы -и карты DLL к форматам ресурсов, загрузке миссии, геометрии, материалам, -рендеру, поведению, звуку, сети и плану чистой совместимой реализации. - -Сайт оформлен как онлайн-книга: тома читаются последовательно, а справочник -используется как быстрый доступ к форматам, проверочным правилам и границам -доказанного знания. - -## Источник истины и синхронизация - -Каталог `docs/` — единственный рабочий источник истины для FParkan. 18 июля -2026 года его содержательно сопоставили с книгой FParkan в Notion; результат, -маршрутизация статей и сознательно исключённые цели зафиксированы в -[сверке](baseline/notion-reconciliation.md). Актуальные локальные материалы -содержат и последующие результаты разработки. Notion больше не -является местом внесения изменений: новые факты, исправления и решения -фиксируются только здесь, в томе, справочнике или evidence-документе, которому -они принадлежат. - -При расхождении приоритет имеют более новое локальное доказательство и текущий -scope проекта: самостоятельный runtime ориентирован исключительно на Windows и -Vulkan. Исторические упоминания других ОС в старых внешних заметках не -расширяют поддерживаемую платформу. - -Действующий dependency-ordered план `stage 0--5` находится в -[Vulkan revision для Windows](baseline/vulkan-revision-plan.md). Это -редакторская локальная версия: она включает недостающие контрактные требования -из Notion, но не переносит снятые с проекта Linux/macOS и hosted-CI цели. - -## Как читать - -Если вы впервые разбираете игровой движок, начните с тома I и II. Там вводится -лексика, доказательная политика, модульная архитектура и жизненный цикл кадра. - -Если нужна реализация совместимого движка, читайте тома III--VII линейно: -ресурсы, миссии, мир, рендер, интерактивные подсистемы и порядок работ. - -Если вы проверяете выводы, переходите к тому VIII и приложениям. Там собраны -уровни уверенности, corpus gates, открытые вопросы и критерии закрытия. - -## Восемь томов - -1. **Путеводитель и методика** -- назначение книги, маршруты чтения, язык - предметной области и правила проверки. -2. **Запуск, архитектура и игровой цикл** -- `iron_3d.exe`, пятнадцать DLL, - сервисы, World3D, очередь объектов и границы кадра. -3. **Ресурсная система и форматы** -- NRes, RsLi, кэши, имена, `objects.rlb`, - unit DAT и сквозное разрешение ресурсов. -4. **Мир, миссии и runtime** -- TMA, ландшафт, ареалы, маршруты, создание мира - и свойства размещённых объектов. -5. **Геометрия, материалы и рендер** -- MSH, анимация, WEAR, MAT0, Texm, FXID, - свет, атмосфера и полный render frame. -6. **Поведение, управление, звук и сеть** -- AI, Behavior, Wizard, Control, - ввод, камера, звук и DirectPlay-слой. -7. **Руководство по полной реализации** -- целевая архитектура, этапы работ, - тестовый контур, точность, скорость и критерий совместимости. -8. **Справочник и доказательная база** -- ABI, конфигурация, статистика - корпусов, границы знания и глоссарий. - -## Политика доказательств - -Специфические утверждения об Iron3D принимаются только после локальной проверки -на исполняемых файлах, DLL, демоверсии, полных каталогах Частей 1 и 2 или на -взаимных инвариантах реальных ресурсов. Внешние описания и текущий код FParkan -могут подсказывать вопросы, но не заменяют проверку. - -Неизвестные поля не получают правдоподобных имён. Пока смысл не закрыт, -документация фиксирует raw layout, границы, безопасное чтение и lossless -сохранение. +Эта книга рассказывает, как устроен движок *Паркан: Железная стратегия* и как +FParkan воспроизводит его работу на Rust и Vulkan. Начнём с простого вопроса: +что должно произойти между выбором миссии и появлением первого кадра? +Ответ связывает архивы, модели, поверхность карты, камеру, свет и поведение +объектов в одну программу. + +Главы читаются последовательно. Для знакомства с игровой разработкой +подойдут первые две; подробные структуры файлов можно искать в справочнике. + +1. [Путеводитель](tomes/01-guide.md): основные понятия и чтение бинарных структур. +2. [Архитектура и игровой цикл](tomes/02-architecture.md): запуск, мир и кадр. +3. [Ресурсы](tomes/03-resources.md): архивы, имена и связи файлов. +4. [Миссии и ландшафт](tomes/04-world.md): размещение объектов и поверхность. +5. [Геометрия и рендер](tomes/05-render.md): путь от вершины до пикселя. +6. [Поведение, управление и звук](tomes/06-behavior.md): интерактивный мир. +7. [Работа над движком](tomes/07-implementation.md): код, тесты и проверка результата. +8. [Устройство оригинальной программы](tomes/08-evidence.md): DLL, адреса и конфигурация. + +В справочнике можно быстро сверить [NRes](reference/nres.md), +[RsLi](reference/rsli.md), [TMA](reference/tma.md), [MSH](reference/msh.md), +[материалы](reference/materials.md), [Texm](reference/texm.md), +[кадр рендера](reference/render-frame.md), [атмосферу и небо](reference/atmosphere.md) +и [эффекты окружения](reference/environment-effects.md). Таблица DLL находится +в [описании оригинальных модулей](reference/original-binaries.md). + +В [глоссарии](appendices/glossary.md) собраны термины, а в +[открытых вопросах](appendices/knowledge-boundaries.md) — ещё не восстановленное +поведение. Описание алгоритма оригинала и возможности текущего приложения +различаются явно. Предположение остаётся предположением, пока его не +подтверждают игровые файлы или код оригинала. + +Команды запуска и проверки приведены в [README](../README.md). |