From c8dd5f989f63d3d61e74e32eba22dbf9298cf24d Mon Sep 17 00:00:00 2001 From: Valentin Popov Date: Sat, 18 Jul 2026 09:52:20 +0400 Subject: feat(game): bind preview diffuse materials --- docs/rendering/renderer_truth_table.md | 12 +++++++----- docs/tomes/05-render.md | 14 ++++++++------ 2 files changed, 15 insertions(+), 11 deletions(-) (limited to 'docs') diff --git a/docs/rendering/renderer_truth_table.md b/docs/rendering/renderer_truth_table.md index 00f756d..0700dbb 100644 --- a/docs/rendering/renderer_truth_table.md +++ b/docs/rendering/renderer_truth_table.md @@ -13,7 +13,7 @@ | `RecordingBackend` | No | No | Optional CPU-side IDs only | `covered-planning` | Stable command capture for backend-neutral tests | Native window, Vulkan, GPU resource lifetime, pixels | | `NullBackend` | No | No | Optional CPU-side IDs only | Usually `covered` for validation-only rows | Command stream framing and bounds validation | Capture stability, GPU execution, pixels | | `VulkanAssetRenderer` | Yes | Yes | Yes | `covered-gpu` | Static original asset rendering: MSH/Texm/WEAR/MAT0/terrain through Vulkan | Animation/FX parity unless explicitly wired | -| `fparkan-game --backend static-vulkan` | Yes, GOG `Autodemo.00` | Yes, static MSH draw | First MSH from first mission root | `covered-gpu` only for the narrow static-preview bridge | Opt-in mission-to-native-window bootstrap, static MSH projection and synchronized teardown telemetry | Full mission scene, texture/material binding, placed transforms/orientation, camera, gameplay, original-runtime parity | +| `fparkan-game --backend static-vulkan` | Yes, GOG `Autodemo.00` | Yes, static MSH draw | First MSH from first mission root; first MAT0 diffuse TEXM per used selector | `covered-gpu` only for the narrow static-preview bridge | Opt-in mission-to-native-window bootstrap, static MSH projection, selector-keyed diffuse descriptor upload and synchronized teardown telemetry | Full mission scene, later MAT0 phases/animation, lightmaps, placed transforms/orientation, camera, gameplay, original-runtime parity | | Future rendered `fparkan-game` mode | Yes | Yes | Yes | `covered-gpu` plus original-evidence IDs | Mission-driven render snapshot execution and pixel capture | Original-runtime parity for animation/FX/x87 without dedicated captures | ## Rules @@ -35,14 +35,16 @@ - `apps/fparkan-game` по умолчанию выдает `render-planning` JSON report поверх synthetic window descriptor и `VulkanPlanningBackend`. Opt-in `--backend static-vulkan` уже создаёт native `winit` window и передаёт первую подготовленную MSH модели миссии в - `VulkanSmokeRenderer` с пустым списком materials (явный white-fallback). Режим использует + `VulkanSmokeRenderer` вместе с первым diffuse TEXM из MAT0 для каждого реально используемого + `Batch20.material_index`. Режим использует отдельный first-root preview loader: normal `load_mission` по-прежнему готовит все reachable assets и весь graph, тогда как preview строит graph и готовит assets только для первого mission root. `--load-progress ` writes the last entered loader phase synchronously for timeout diagnosis. Fresh GOG `MISSIONS/Autodemo.00/data.tma` run passed in 38.7 seconds with - one presented frame, native 1280×720 swapchain (2 images), 7,372,800-byte readback hash - `10681850560830502773`, and validation warnings/errors `0/0`. This is `covered-gpu` evidence - for that narrow static-preview bridge only, not full-scene or original-renderer parity. + one presented frame, native 1280×720 swapchain (2 images), one original diffuse material + descriptor, 7,372,800-byte readback hash `12332214764918703197`, and validation + warnings/errors `0/0`. This is `covered-gpu` evidence for that narrow static-preview bridge + only, not full-scene or original-renderer parity. - `apps/fparkan-viewer` сейчас inspection-only CLI и не открывает live Vulkan asset viewer. - Следующий реальный milestone для rendered acceptance: `VulkanAssetRenderer` diff --git a/docs/tomes/05-render.md b/docs/tomes/05-render.md index b689c08..cc65092 100644 --- a/docs/tomes/05-render.md +++ b/docs/tomes/05-render.md @@ -941,16 +941,18 @@ not the default planning path. It visits only the first mission root, selects its prepared MSH model, sends it through the existing static XZ clip-space projection and renders a requested number of frames through `VulkanSmokeRenderer`; teardown rejects validation warnings/errors and reports -swapchain/readback telemetry. It deliberately supplies no material textures, -so the renderer's documented white fallback is used. +swapchain/readback telemetry. For each used `Batch20.material_index`, it resolves +the positional prepared WEAR material and uploads mip 0 of that material's first +MAT0 diffuse texture request as a selector-keyed descriptor. This is a narrow bootstrap from mission assets to a live Vulkan renderer. It -does not render every placed object, apply TMA transforms or orientation, bind -WEAR/MAT0/TEXM material data, or establish a game camera. Fresh GOG +does not render every placed object, apply TMA transforms or orientation, select +later MAT0 phases or animation, bind lightmaps, or establish a game camera. Fresh GOG `MISSIONS/Autodemo.00/data.tma` evidence now proves the narrow GPU bridge: one presented frame completed in 38.7 seconds with a native 1280×720 two-image -swapchain, 7,372,800-byte synchronized readback (FNV-1a -`10681850560830502773`) and validation warnings/errors `0/0`. This is not a +swapchain, one selector-keyed original diffuse descriptor, 7,372,800-byte +synchronized readback (FNV-1a `12332214764918703197`) and validation +warnings/errors `0/0`. This is not a full-scene or original-renderer pixel-parity claim. The preview now asks `load_mission_static_preview` for both graph and assets. -- cgit v1.2.3