Files
airdef/docs/measurements/issue-126-effects-skip/README.md
T
chexit d8d9913770
build / mod (push) Failing after 29s
Issue #126 point 4: same-tick A/B parity and timing record
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>
2026-11-21 13:51:13 +03:00

7.8 KiB
Raw Blame History

Issue #126, пункт 4: пропуск рэймарча огненного шара при нулевом fade — проверка

Мёртвая работа в airdef-mod/shaders/effects.wgsl (раздел «2. Fireballs and their smoke»). Счёт и картинка не менялись ни на пиксель; меняется только то, что при fade == 0 цикл марша больше не крутится.

Изменение

// было (для каждого шара): 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).