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

104 lines
7.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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`).