diff --git a/docs/measurements/issue-126-effects-skip/README.md b/docs/measurements/issue-126-effects-skip/README.md new file mode 100644 index 0000000..b9582fc --- /dev/null +++ b/docs/measurements/issue-126-effects-skip/README.md @@ -0,0 +1,103 @@ +# 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 `, `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-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`). diff --git a/docs/measurements/issue-126-effects-skip/report.json b/docs/measurements/issue-126-effects-skip/report.json new file mode 100644 index 0000000..0f90635 --- /dev/null +++ b/docs/measurements/issue-126-effects-skip/report.json @@ -0,0 +1,118 @@ +{ + "issue": 126, + "point": 4, + "base": "c08b73729", + "engine_pin": "3428a571b", + "change": "7d77c09f0", + "method": "same-process same-frozen-tick A/B (temporary harness build, reverted); pair benches interleaved", + "scene": { + "world": "Polygon (copy)", + "resolution": [ + 2560, + 1440 + ], + "env": { + "HORIZON_HD_TAA": "0", + "HORIZON_HD_WIND": "0", + "HORIZON_HD_CLOUDS": "0", + "HORIZON_HD_VOLFOG": "0", + "HORIZON_HD_WATER": "0", + "HORIZON_HD_AO": "0" + }, + "tick_clock": "p[1020]=1 (no partial tick), blast start 0 life 4000", + "parity_frames": { + "32_blasts": [ + "/tmp/st4/new_623.png", + "/tmp/st4/old_623.png", + "/tmp/st4/new2_623.png", + "/tmp/st4/new_1603.png", + "/tmp/st4/old_1603.png", + "/tmp/st4/new2_1603.png" + ], + "one_blast": [ + "/tmp/st3/new_620.png", + "/tmp/st3/old_620.png", + "/tmp/st3/new2_620.png", + "/tmp/st3/new_1608.png", + "/tmp/st3/old_1608.png", + "/tmp/st3/new2_1608.png" + ] + } + }, + "pixel_parity": [ + { + "scene": "32 blasts, sky", + "tick": 623, + "k": 0.156, + "path": "march runs (fade>0)", + "old_vs_new_mean_255": 0.0054, + "px_over_20": 0, + "same_shader_floor_mean_255": 0.003, + "max": 1 + }, + { + "scene": "32 blasts, sky", + "tick": 1603, + "k": 0.401, + "path": "march skipped (fade=0)", + "old_vs_new_mean_255": 0.0075, + "px_over_20": 0, + "same_shader_floor_mean_255": 0.0069, + "max": 1 + }, + { + "scene": "one blast at 20 blocks, sky", + "tick": 620, + "k": 0.155, + "path": "march runs (fade>0)", + "old_vs_new_mean_255": 0.0455, + "px_over_20": 0, + "same_shader_floor_mean_255": 0.0597, + "max": 2 + }, + { + "scene": "one blast at 20 blocks, sky", + "tick": 1608, + "k": 0.402, + "path": "march skipped (fade=0)", + "old_vs_new_mean_255": 0.0436, + "px_over_20": 0, + "same_shader_floor_mean_255": 0.077, + "max": 2 + } + ], + "frame_time": [ + { + "scene": "32 blasts, late life", + "tick": 1606, + "new_median_ms": 79.274, + "old_median_ms": 79.628, + "old_minus_new_median_ms": 0.37, + "old_minus_new_mean_ms": 1.15, + "stdev_ms": 3.65, + "pairs": 10 + }, + { + "scene": "one blast at 20 blocks, late life", + "tick": 1604, + "new_median_ms": 15.493, + "old_median_ms": 16.302, + "old_minus_new_median_ms": 0.82, + "old_minus_new_mean_ms": 0.95, + "stdev_ms": 3.79, + "pairs": 16 + } + ], + "hd_bench_polygon_noon_static": { + "old_gpu_avg_ms": 18.06, + "new_gpu_avg_ms": 21.29, + "budget_ms": 18, + "vs_baseline_mean_255": 0.79, + "vs_baseline_pct_over_20": 0.58, + "note": "no blasts in the scene; the changed branch is not taken; budget exceeded in both runs (this session's same scene ranged 18-31 ms)" + }, + "tests": { + "cargo test airdef-mod": "121 passed, 0 failed", + "tools/test_hd_bench.py": "5 passed" + } +}