valentineus/fparkan

Fork 0

Files

Valentin Popov a281ffa32e

Test / Lint (push) Failing after 1m10s

Details

Test / Test (push) Has been skipped

Details

Test / Render parity (push) Has been skipped

Details

feat: Enhance model and texture loading with improved error handling and new 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.

2026-02-19 05:19:18 +04:00

3.2 KiB

Raw Blame History

render-demo

Тестовый рендерер Parkan-моделей на Rust (SDL2 + OpenGL ES 2.0).

Назначение

Проверить, что nres + msh-core + render-core дают рабочий draw-path на реальных ассетах.
Проверить текстурный path WEAR -> MAT0 -> Texm на реальных ассетах.
Служить минимальным reference-приложением.

Запуск

cargo run -p render-demo --features demo -- \
  --archive "testdata/Parkan - Iron Strategy/animals.rlb" \
  --model "A_L_01.msh" \
  --lod 0 \
  --group 0

Параметры:

--archive (обязательный): NRes-архив с .msh entry.
--model (опционально): имя модели; если не задано, берётся первая .msh.
--lod (опционально, default 0).
--group (опционально, default 0).
--width, --height (опционально, default 1280x720).
--angle (опционально): фиксированный угол поворота вокруг Y (в радианах).
--spin-rate (опционально, default 0.35): скорость вращения в интерактивном режиме.
--texture <name>: явное имя Texm (override авто-резолва).
--texture-archive <path>: путь к архиву текстур (по умолчанию textures.lib рядом с --archive).
--material-archive <path>: путь к material.lib (по умолчанию соседний material.lib).
--wear <name.wea>: имя wear-entry внутри модельного архива (по умолчанию <model_stem>.wea).
--no-texture: отключить текстуры и рендерить однотонным цветом.

Авто-резолв текстуры

Если не передан --texture, демо пытается взять текстуру из игровых данных:

model.msh -> model.wea (первый wear-материал),
material.lib (MAT0) по имени материала с fallback DEFAULT,
первая непустая textureName фаза материала,
загрузка Texm из textures.lib (или lightmap.lib как fallback).

Детерминированный снимок кадра

Для parity-проверок используется headless-сценарий с фиксированными параметрами:

cargo run -p render-demo --features demo -- \
  --archive "testdata/Parkan - Iron Strategy/animals.rlb" \
  --model "A_L_01.msh" \
  --lod 0 \
  --group 0 \
  --width 1280 \
  --height 720 \
  --angle 0.0 \
  --capture "target/render-parity/current/animals_a_l_01.png"

Явный выбор текстуры:

cargo run -p render-demo --features demo -- \
  --archive "testdata/Parkan - Iron Strategy/animals.rlb" \
  --model "A_L_01.msh" \
  --texture "PG09.0"

Ограничения

Используется только базовая texture-фаза (без полной material/fx анимации).
Вывод через glDrawArrays(GL_TRIANGLES) из расширенного triangle-list (позиции+UV).

3.2 KiB Raw Blame History Unescape Escape

render-demo

Назначение

Запуск

Авто-резолв текстуры

Детерминированный снимок кадра

Ограничения

3.2 KiB

Raw Blame History