aboutsummaryrefslogtreecommitdiff
path: root/docs
Commit message (Collapse)AuthorAgeFilesLines
* feat: close stage 0-2 audit groundworkValentin Popov5 days3-25/+20
| | | | | | | | | | | | Remove legacy SDL/OpenGL adapters from the workspace and introduce winit/Vulkan adapter boundaries for the rendered composition root. Add reproducible toolchain and xtask CI coverage for formatting, tests, clippy, docs, policy, deny, acceptance auditing, and hosted OS matrix evidence. Strengthen Stage 1 data contracts with byte-first paths, VFS hardening, structured diagnostics, RsLi writer/edit scaffolding, corpus reporting, and resource error classification. Advance Stage 2 asset preparation by moving mission loading through assets/runtime boundaries, materializing prototype graph data, preserving provenance, and adding inspection/viewer integration. Record the Stage 0-2 audit input, acceptance roadmap, coverage updates, and documentation notes for follow-up evidence.
* fix: harden path lookup and mark gl backend gapValentin Popov6 days1-6/+13
|
* feat: implement FParkan architecture foundationValentin Popov6 days2-0/+46
| | | | Add the modular fparkan workspace, domain crates, adapters, apps, xtask policy/CI, acceptance evidence, and licensed corpus gates for the macOS-focused roadmap foundation.
* docs: rewrite MkDocs documentationValentin Popov7 days43-2559/+6279
|
* chore: remove Python tooling and resource viewerValentin Popov7 days11-28/+14
|
* updated docsValentin Popov2026-02-192-0/+26
|
* feat: add terrain-core, tma, and unitdat crates with parsing functionalityValentin Popov2026-02-192-0/+158
| | | | | | | | - Introduced `terrain-core` crate for loading and processing terrain mesh data. - Added `tma` crate for parsing mission files, including footer and object records. - Created `unitdat` crate for reading unit data files with validation of structure. - Implemented error handling and tests for all new crates. - Documented object registry format and rendering pipeline in specifications.
* Документирование и обновление ↵Valentin Popov2026-02-1924-1302/+1032
| | | | | | | | | спецификаций - Обновлены спецификации `runtime-pipeline`, `sound`, `terrain-map-loading`, `texture`, `ui` и `wear`. - Добавлены разделы о статусе покрытия и оставшихся задачах для достижения 100% завершенности. - Внесены уточнения по архитектурным ролям, минимальным контрактам и требованиям к toolchain для каждой подсистемы. - Уточнены форматы данных и правила взаимодействия между компонентами системы.
* feat: Enhance model and texture loading with improved error handling and new ↵Valentin Popov2026-02-192-0/+22
| | | | | | | | | | | | features - Introduced `LoadedModel` and `LoadedTexture` structs for better encapsulation of model and texture data. - Added functions to load models and textures from archives, including support for resolving textures based on materials and wear entries. - Implemented error handling for missing textures, materials, and wear entries. - Updated the rendering pipeline to support texture loading and binding, including command-line arguments for texture customization. - Enhanced the `texm` crate with new decoding capabilities for various pixel formats, including indexed textures. - Added tests for texture decoding and loading to ensure reliability and correctness. - Updated documentation to reflect changes in the material and texture resolution process.
* feat(render-parity): add deterministic frame comparison toolValentin Popov2026-02-191-0/+77
| | | | | | | | | - Introduced `render-parity` crate for comparing rendered frames against reference images. - Added command-line options for specifying manifest and output directory. - Implemented image comparison metrics: mean absolute difference, maximum absolute difference, and changed pixel ratio. - Created a configuration file `cases.toml` for defining test cases with global defaults and specific parameters. - Added functionality to capture frames from `render-demo` and save diff images on discrepancies. - Updated documentation to include usage instructions and CI model for automated testing.
* Refactor documentation structure and add new specificationsValentin Popov2026-02-1910-2831/+785
| | | | | | | | - Updated MSH documentation to reflect changes in material, wear, and texture specifications. - Introduced new `render.md` file detailing the render pipeline process. - Removed outdated sections from `runtime-pipeline.md` and redirected to `render.md`. - Added detailed specifications for `Texm` texture format and `WEAR` wear table. - Updated navigation in `mkdocs.yml` to align with new documentation structure.
* Refactor code structure for improved readability and maintainabilityValentin Popov2026-02-122-333/+616
|
* feat: добавить экспорт в формат OBJ для ↵Valentin Popov2026-02-121-49/+364
| | | | рендеринга террейна и опциональных полигонов
* Add terrain map documentation validatorValentin Popov2026-02-121-17/+496
| | | | This commit introduces a new Python script, `terrain_map_doc_validator.py`, which validates terrain and map documentation assumptions against actual game data. The validator checks for the presence and correctness of various data chunks in the `Land.msh` and `Land.map` files, reporting any issues found during the validation process. It also generates a summary report of the validation results, including counts of errors and warnings, and statistics related to the map and mesh data.
* feat: обновить заголовки разделов в ↵Valentin Popov2026-02-122-99/+99
| | | | документации по FXID и NRes для улучшения структуры
* Implement feature X to enhance user experience and fix bug Y in module ZValentin Popov2026-02-121-282/+654
|
* feat: улучшить документацию по материалам и ↵Valentin Popov2026-02-121-8/+165
| | | | текстурам, добавить детали о сборке и парсинге
* Refactor materials and Texm documentation for clarity and completenessValentin Popov2026-02-122-248/+1016
| | | | | | | | - Updated the structure and content of the materials and Texm documentation to provide a comprehensive overview of the material subsystem in the engine. - Enhanced sections on identifiers, architecture, material layout, and runtime storage. - Improved explanations of material attributes, animation modes, and parsing behavior. - Added detailed specifications for toolchain interactions, including lossless write rules and validation recommendations. - Included pseudocode examples for parsing MAT0 and Texm formats to aid in understanding.
* Добавлены спецификации для сетевой ↵Valentin Popov2026-02-1216-1411/+1495
| | | | подсистемы, системы звука, загрузки ландшафта, интерфейса пользователя и пайплайна выполнения. Обновлен файл навигации mkdocs.yml для включения новых документов.
* Add MSH geometry export and preview rendering toolsValentin Popov2026-02-113-366/+1311
| | | | | | - Implemented msh_export_obj.py for exporting NGI MSH geometry to Wavefront OBJ format, including model selection and geometry extraction. - Added msh_preview_renderer.py for rendering NGI MSH models to binary PPM images, featuring a primitive software renderer with customizable parameters. - Both tools utilize the same NRes parsing logic and provide command-line interfaces for listing models and exporting or rendering geometry.
* Add .gitignore for Python and project-specific files; implement archive ↵Valentin Popov2026-02-101-5/+18
| | | | | | | | | roundtrip validator - Updated .gitignore to include common Python artifacts and project-specific files. - Added `archive_roundtrip_validator.py` script for validating NRes and RsLi formats against real game data. - Created README.md for the tools directory, detailing usage and supported signatures. - Enhanced nres.md with practical nuances and empirical checks for game data.
* feat: добавление документации по эффектам и ↵Valentin Popov2026-02-101-0/+69
| | | | частицам
* feat: добавление документации по модели ↵Valentin Popov2026-02-101-0/+314
| | | | ресурсов MSH/AniMesh
* feat: добавление документации по текстурам ↵Valentin Popov2026-02-101-0/+90
| | | | и материалам
* Add detailed documentation for NRes and RsLi resource formatsValentin Popov2026-02-094-1615/+705
| | | | | - Introduced a comprehensive markdown file `nres.md` detailing the structure, header, and operations of the NRes and RsLi formats. - Updated `mkdocs.yml` to reflect the new documentation structure, consolidating NRes and RsLi under a single entry.
* feat: обновление документации по ↵Valentin Popov2026-02-053-190/+203
| | | | алгоритмам декомпрессии и добавление файлов .gitkeep в директории libs и tools
* Add NRes format documentation and decompression algorithmsValentin Popov2026-02-053-0/+1602
| | | | | | - Created `huffman_decompression.md` detailing the Huffman decompression algorithm used in NRes, including context structure, block modes, and decoding methods. - Created `overview.md` for the NRes format, outlining file structure, header details, file entries, and packing algorithms. - Updated `mkdocs.yml` to include new documentation files in the navigation structure.
* Initial MkDocsValentin Popov2024-02-061-0/+17