aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorValentin Popov <valentin@popov.link>2026-07-18 08:36:29 +0300
committerValentin Popov <valentin@popov.link>2026-07-18 08:36:29 +0300
commit697cbbfd36bb8d82dd2b419bc181889cc3c46f6a (patch)
tree0af8dc6b98b634bc804e700746d0c1582e9eea45 /docs
parentf75601a86a9202f8f226ac04a1238b3660071915 (diff)
downloadfparkan-697cbbfd36bb8d82dd2b419bc181889cc3c46f6a.tar.xz
fparkan-697cbbfd36bb8d82dd2b419bc181889cc3c46f6a.zip
feat(runtime): bound static preview asset loading
Diffstat (limited to 'docs')
-rw-r--r--docs/rendering/renderer_truth_table.md10
-rw-r--r--docs/tomes/05-render.md8
2 files changed, 14 insertions, 4 deletions
diff --git a/docs/rendering/renderer_truth_table.md b/docs/rendering/renderer_truth_table.md
index 26b113a..14cf198 100644
--- a/docs/rendering/renderer_truth_table.md
+++ b/docs/rendering/renderer_truth_table.md
@@ -35,10 +35,12 @@
- `apps/fparkan-game` по умолчанию выдает `render-planning` JSON report поверх
synthetic window descriptor и `VulkanPlanningBackend`. Opt-in `--backend static-vulkan`
уже создаёт native `winit` window и передаёт первую подготовленную MSH модели миссии в
- `VulkanSmokeRenderer` с пустым списком materials (явный white-fallback). Это не является
- rendered acceptance: fresh GOG `MISSIONS/Autodemo.00/data.tma` test не дошёл до окна за
- локальный 120-second runner limit, поэтому нет live report, pixel artifact или validation
- evidence именно для game path.
+ `VulkanSmokeRenderer` с пустым списком materials (явный white-fallback). Режим использует
+ отдельный bounded preview loader: normal `load_mission` по-прежнему готовит все reachable
+ assets, тогда как preview останавливает asset preparation после первого root с mesh-backed
+ model. Это не является rendered acceptance: fresh GOG `MISSIONS/Autodemo.00/data.tma` test
+ с этим scope всё равно не дошёл до окна за локальный 120-second runner limit, поэтому нет
+ live report, pixel artifact или validation evidence именно для game path.
- `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 be60d30..34bf873 100644
--- a/docs/tomes/05-render.md
+++ b/docs/tomes/05-render.md
@@ -951,6 +951,14 @@ WEAR/MAT0/TEXM material data, or establish a game camera. A GOG
limit before the window/report, so this mode has implementation and unit/lint
evidence only, not a corpus GPU acceptance claim.
+The preview now asks `load_mission_static_preview` for assets. Normal mission
+loading remains full and transactional; the preview scope walks root spans in
+TMA order and stops asset preparation after the first mesh-backed model. It is
+therefore not a hidden relaxation of gameplay validation. A second GOG
+`Autodemo.00` attempt with this narrower asset scope still exceeded 120 seconds
+before opening a window, which locates the remaining startup cost before the
+Vulkan draw loop but does not identify it as terrain versus graph work.
+
`Land.msh` использует отдельный geometry-only bridge: validated `TerrainFace28`
сохраняет source triangle order, а его positions и packed UV0 попадают в тот же
static vertex/index upload path. Для текущего диагностического viewer XZ bounds