aboutsummaryrefslogtreecommitdiff
path: root/docs/specs
Commit message (Collapse)AuthorAgeFilesLines
* feat: add terrain-core, tma, and unitdat crates with parsing functionalityValentin Popov9 days2-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 Popov9 days24-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 Popov10 days2-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 Popov10 days1-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 Popov10 days10-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.