d8d9913770
build / mod (push) Failing after 29s
The temporary in-session shader switch (harness build, reverted) renders the same frozen tick with both effects.wgsl versions: old-vs-new differs by at most 1-2/255, no pixel over 5/255, and no more than two frames of the same shader differ. Frame time is below the in-game noise floor on M5 (32 screen-filling late-life fireballs: +0.37 ms median, sigma 3.6). Includes the hd_bench polygon_noon run and test counts. Co-Authored-By: Kimi Code <noreply@moonshot.ai>
104 lines
7.8 KiB
Markdown
104 lines
7.8 KiB
Markdown
# Issue #126, пункт 4: пропуск рэймарча огненного шара при нулевом fade — проверка
|
||
|
||
Мёртвая работа в `airdef-mod/shaders/effects.wgsl` (раздел «2. Fireballs and their smoke»). Счёт и
|
||
картинка не менялись ни на пиксель; меняется только то, что при `fade == 0` цикл марша больше не
|
||
крутится.
|
||
|
||
## Изменение
|
||
|
||
```wgsl
|
||
// было (для каждого шара): ds, затем сразу цикл
|
||
for (var s = 0; s < steps; s++) { ... let n = fbm(...); ... }
|
||
|
||
// стало
|
||
if fade > 0.0 {
|
||
for (var s = 0; s < steps; s++) { ... } // тот же цикл, тот же выход по trans < 0.02
|
||
}
|
||
// свечение огня после марша осталось; оно само под `if heat > 0.0`
|
||
```
|
||
|
||
Почему картинка та же: при `fade == 0` на каждом шаге `density = shape * (1.2 + n*2.0) * fade == 0`,
|
||
значит `absorb = 1 - exp(0) == 0`, `lit += trans * absorb * c` ничего не добавляет, а
|
||
`trans *= 1 - absorb` не меняет `trans`. HD-ветка гасит `fade` уже к `k = 0.28`
|
||
(`1 - smoothstep(0.08, 0.28, k)`), поэтому у позднего шара марш (6–14 вызовов `fbm` на пиксель)
|
||
не виден, но выполнялся. Свечение (`heat = 1 - smoothstep(0.05, 0.55, k)`) живёт до `k = 0.55` и
|
||
вынесено из нового условия; второй `if heat > 0.0` убирает только заведомо нулевое слагаемое.
|
||
|
||
Шаги, разрешение, плотность, семплирование, свет и туннели не тронуты.
|
||
|
||
## Стенд
|
||
|
||
- Apple M5, Metal, 2560×1440 offscreen; engine pin `3428a571b`, база мода `c08b73729`, правка
|
||
`7d77c09f0` (только `effects.wgsl`).
|
||
- Мир `Polygon` — копия в `run-home/saves` рабочего дерева (оригинальные сохранения не трогались),
|
||
свежий `HORIZON_HOME` в `run-home-bench/home` на прогон.
|
||
- Сцена: spectator, `tp @s 40.5 76 40.5 135 <pitch>`, `time set 6000`,
|
||
`advance_time/advance_weather false`, `weather clear`, `doMobSpawning false`,
|
||
`randomTickSpeed 0`, `kill @e[type=!minecraft:player]`, HUD скрыт; `HORIZON_HD_TAA=0`,
|
||
`HORIZON_HD_WIND=0`, `HORIZON_HD_CLOUDS=0`, `HORIZON_HD_VOLFOG=0`, `HORIZON_HD_WATER=0`,
|
||
`HORIZON_HD_AO=0`. В кадре только небо и один/32 шара: никакого дрейфа LOD и сущностей.
|
||
- Все прогоны игры — под `flock -x /tmp/airdef-bench.lock` (один клиент за раз).
|
||
|
||
## Пиксельный паритет: A/B на одном замороженном кадре
|
||
|
||
Кросс-процессные прогоны расходятся (LOD/стриминг, партиклы, интерполяция настроек мода по
|
||
частичному тику), поэтому сравнение сделано **в одном процессе**: временная сборка мода (в коммит
|
||
не входит, дерево после неё чистое) содержала
|
||
|
||
- `testblast` — ставит шар(ы) в фиксированной мировой точке с `start 0, life 4000`, так что
|
||
состояние зависит только от абсолютного тика;
|
||
- выбор шейдера файлом `<HORIZON_HOME>/horizon-mods/.horizon-mod-data/airdef/harness-command`
|
||
(`old` — `effects.wgsl` из `7d77c09f0~1`, `new` — из `7d77c09f0`; обе версии вкомпилированы);
|
||
- настройки мода (`set-params`, `set-lights`, `set-smoke`) выталкиваются каждый кадр, иначе хост
|
||
интерполирует последние два тика по частичному тику и кадр «плывёт» даже на паузе.
|
||
|
||
Игра ставится на паузу без меню (F3+Esc) в нужном тике, затем на **этом же тике** снимаются кадры
|
||
`new → old → new` (переключение шейдера — запись файла). `p[1020] = 1` в харнессе убирает частичный
|
||
тик из часов эффектов.
|
||
|
||
Результаты (2560×1440, кадр целиком; `mean` — средняя разница по каналам из 255, методика
|
||
`tools/hd_bench.py`: `compare_runs`, движущиеся пиксели маскируются по размаху между `new` и `new2`):
|
||
|
||
| сцена | тик | k | путь | old-vs-new mean | >20/255 | шум того же шейдера (new-vs-new2) |
|
||
|---|---|---|---|---|---|---|
|
||
| 32 шара, небо | 623 | 0.156 | активный марш | 0.0054 | 0 | 0.0030 |
|
||
| 32 шара, небо | 1603 | 0.401 | fade = 0, марш пропущен | 0.0075 | 0 | 0.0069 |
|
||
| 1 шар 20 блоков, небо | 620 | 0.155 | активный марш | 0.0455 | 0 | 0.0597 |
|
||
| 1 шар 20 блоков, небо | 1608 | 0.402 | fade = 0, марш пропущен | 0.0436 | 0 | 0.0770 |
|
||
|
||
Покадрово: максимум расхождения **1/255** (32 шара) и **2/255** (один шар), пикселей с разницей
|
||
> 5/255 — **ноль**; разница old-vs-new не больше, чем у двух кадров одного и того же шейдера.
|
||
То есть правка невидима и в активном пути, и в пропущенном.
|
||
|
||
## Пиксельный паритет в штатной сцене hd_bench
|
||
|
||
`tools/hd_bench.py --only polygon_noon` (Polygon, полдень, статичное окружение
|
||
`HORIZON_HD_WIND/CLOUDS/VOLFOG=0`), старый мод против нового, под локом:
|
||
|
||
- old: GPU 18.06 мс; new: GPU 21.29 мс (бюджет 18 мс превышен в обоих — это шум/нагрузка стенда:
|
||
тот же кадр в этой сессии давал 18–31 мс);
|
||
- сравнение кадров new к базе old: средняя разница 0.79/255, пикселей >20/255 — 0.58% (порог 5%),
|
||
т.е. в пределах мерцания TAA между прогонами; в этой сцене нет взрывов, ветка правки не
|
||
выполняется.
|
||
|
||
## Время кадра (честно)
|
||
|
||
Парные `bench` на одном замороженном кадре, шейдеры чередуются каждую секунду (снимает дрейф
|
||
частот/тепла), сцена — небо, late-life шары невидимы:
|
||
|
||
| сцена | тик | new, медиана | old, медиана | old − new |
|
||
|---|---|---|---|---|
|
||
| 32 шара (каждый ~полэкрана) | 1606 | 79.27 мс | 79.63 мс | +0.37 мс (mean +1.15, σ 3.65, N=10) |
|
||
| 1 шар на 20 блоках | 1604 | 15.49 мс | 16.30 мс | +0.82 мс (mean +0.95, σ 3.79, N=16) |
|
||
|
||
Разброс между парами больше эффекта, знак нестабилен: на M5 выигрыш **ниже шума** измерения кадра.
|
||
Это ожидаемо — экономится один 7-шаговый `fbm`-марш по площади шара на пиксель, доли миллисекунды
|
||
на типичном кадре; замер требует изоляции прохода мода (в таймингах паков прохода мода нет).
|
||
|
||
## Что проверено
|
||
|
||
- `cargo test` в `airdef-mod`: 113 lib + 1 `core_boundary` + 2 `saturation` + 5 `scenarios` = 121,
|
||
0 падений.
|
||
- `python3 tools/test_hd_bench.py`: 5 тестов OK.
|
||
- Шаги/плотность/свет/туннели не менялись: см. diff `7d77c09f0` (только `effects.wgsl`).
|