Issue #126 point 4: same-tick A/B parity and timing record
build / mod (push) Failing after 29s
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>
This commit is contained in:
@@ -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 <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`).
|
||||
@@ -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"
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user