engine: the Resolution Scale slider drives HD render scale (DLSS included)
build / mod (push) Failing after 33s

Pin horizon to 4e441de6a (agent/resolution-scale): hd::scale_override used
to pin the HD world at 2/3 whenever DLSS was enabled and its SDK open, so
the Resolution Scale slider (50-200%) was ignored — pixel-identical image
and unchanged FPS at every step. Now the slider drives the world target and
the DLSS render size live, no restart: film quality, then HORIZON_HD_SCALE,
then the slider; with DLSS the render scale caps at the output (100% keeps
the 2/3 auto ratio, above 100% renders at the output — supersampling is
native TAAU's with DLSS off), without DLSS the slider applies as-is
including above 1. The jitter and motion globals match the new size on the
very frame it changes; the NGX context is kept while the render size fits
its dynamic-resolution range, and the histories reset on every scale
change. The #143 motion/jitter contract (MVJittered, render-pixel jitter,
MV scale [1,1]) is intact.

Verified on Mac (M5/Metal, no DLSS device): lib suite 1243 passed, new GPU
test the_world_target_follows_the_resolution_slider (50/100/200% target
sizes + live resize + hd_scale precedence), taau_gpu_smoke_still_surface_ab,
non-dlss build, and a Windows-gnu cross-check of the dlss-gated code against
the NGX v310.9.1 headers. DLSS evaluation awaits RTX.

Docs: DLSS-TESTING.md documents the scale semantic, the live-update
mechanism and the RTX verification checklist (slider changes the DLSS
render size + FPS, no shaking regression, context reuse, fallback logs);
HD-RENDERER.md's scale references follow the slider.

Co-Authored-By: Kimi Code <noreply@moonshot.ai>
This commit is contained in:
2026-11-22 12:05:45 +03:00
parent 24f3485ebb
commit b8049674bb
3 changed files with 33 additions and 7 deletions
+25 -1
View File
@@ -61,10 +61,34 @@
- Команда контрольного сокета: `dlss on|off|status` (`available` — открыт ли DLSS-девайс, `dlss` — запрос игрока).
- Настройка `dlss:true|false` в `horizon-graphics.txt`; `HORIZON_DLSS=1|0` по-прежнему переопределяет её при старте.
Выключение переходит на native TAAU со следующего кадра: разделённые истории #137 делают переход чистым в обе стороны (NGX сбрасывается при возобновлении, первый native кадр не читает устаревшую историю). Включение после старта с выключенным DLSS применяется при следующем запуске — девайс открывается под DLSS только при старте. Разрешение рендера остаётся выбором игрока в настройках Horizon: масштаб 2/3 по умолчанию действует, только когда DLSS включён и реально доступен.
Выключение переходит на native TAAU со следующего кадра: разделённые истории #137 делают переход чистым в обе стороны (NGX сбрасывается при возобновлении, первый native кадр не читает устаревшую историю). Включение после старта с выключенным DLSS применяется при следующем запуске — девайс открывается под DLSS только при старте. Разрешение рендера — выбор игрока в настройках Horizon (слайдер Resolution Scale, см. ниже).
Для A/B ниже `test-dlss.bat`/`test-native.bat` работают как раньше; если старт был с DLSS, оба режима можно снять и одним прогоном через `dlss off`/`dlss on` без перезапуска.
## Масштаб разрешения (Resolution Scale) и DLSS
**Баг (исправлен, ветка `agent/resolution-scale`).** Слайдер Resolution Scale (50–200%, `horizon-graphics.txt` `resolutionScale`) писал `world_post.scale`, но при включённом HD решение о масштабе мира принимал `hd::scale_override()`: с DLSS (включён + девайс открыт) он **всегда** возвращал `Some(2/3)`, и `world_post.prepare()` брал `hd_scale.unwrap_or(scale)` — слайдер не читался вовсе. Картинка и FPS не менялись от 50/80/100/200%. Без DLSS и без `HORIZON_HD_SCALE` слайдер работал (native TAAU), поэтому баг был виден только на RTX.
**Семантика после исправления** (`hd::scale_override(slider)`, чистое решение `scale_for`, юнит-тест `the_resolution_slider_drives_hd_scale`). Приоритет, первое совпадение выигрывает:
1. **Film quality** (`render.set-film-quality`, захват) — мир в полный размер окна.
2. **`HORIZON_HD_SCALE`** (0.25–1, читается один раз при старте) — явное dev-переопределение, сильнее слайдера.
3. **DLSS оценивает кадр** (запрос включён + SDK открыт): слайдер — это render-размер, ограниченный размером выхода (апскейлер не рендерит больше выхода). На **дефолтных 100%** DLSS сохраняет своё авто-соотношение **2/3**; любое другое значение — явный render-масштаб (50% → половина, 80% → 0.8); **выше 100%** мир рендерится в размер выхода (суперсэмплинг >1 — только native TAAU с выключенным DLSS).
4. **Иначе (native TAAU)** — слайдер как есть, 0.5–2.0, включая суперсэмплинг; при 1.0 без HD/FXAA мир рисуется прямо в экран (как раньше, бит-в-бит).
**Живое обновление.** `set_world_post` (слайдер) пишет `world_post.scale`; `hd_scale` пересчитывается каждый кадр до джиттера, поэтому джиттер и motion-буфер (`Globals.hd_motion.xy`) соответствуют размеру мира этого же кадра. `world_post.prepare()` пересоздаёт таргет при смене размера, `Hd::resize` → `Taa::resize` сбрасывает истории и зовёт `Dlss::resize(world, out)`. Контекст NGX создаётся под размер выхода; render-размер передаётся в каждой evaluate через `partial_texture_size`, поэтому при смене слайдера контекст **сохраняется**, пока новый render-размер вписывается в `render_resolution_range()` контекста (динамическое разрешение NGX); вне диапазона или при смене размера окна — пересоздание. Пересоздание ждёт idle девайса (`DlssSuperResolution::drop`), поэтому reuse важен для живого слайдера. Первая evaluate после смены масштаба идёт с `InReset` (истории сброшены в `Taa::resize`) — ghosting между масштабами исключён. Контракт motion/jitter #143 не тронут: `MVJittered`, `MVLowRes`, `jitter_offset` в render-пикселях, `motion_vector_scale [1,1]`.
**Что проверено на Mac (M5/Metal, без DLSS-устройства):** юнит-тест приоритета (все ветки, включая DLSS-арифметику — она платформенно-независима); GPU-тест `gfx::world_post::tests::the_world_target_follows_the_resolution_slider` — таргет мира следует за слайдером 50/100/200% (960×540 / 1920×1080 / 3840×2160), live-ресайз без пересоздания `Post`, `hd_scale` заменяет слайдер (2/3, 0.5, 1.0); `taau_gpu_smoke_still_surface_ab` проходит; вся сюита `cargo test -p horizon-client --lib`; сборка без фичи `dlss`.
**Что ждёт RTX (обязательно проверить):**
1. Слайдер 50 / 80 / 100 / 200% при включённом DLSS: в `latest.log` строка `DLSS Super Resolution: [w, h] -> [W, H]` меняет render-размер (для 1440p: 50% → [1280, 720], 80% → [2048, 1152], 100% → авто [1706, 960], 200% → [2560, 1440]); картинка и FPS меняются от 50/80/100; 200% при DLSS даёт render в размер выхода (не суперсэмплинг).
2. Статичная сцена после каждого переключения слайдера 10–15 с: нет дрожи/вибрации (регрессия #143), нет ghosting после смены масштаба (первый кадр с `InReset`).
3. Движение (`/airdef move 2`, налёт): модели не двоятся; дым/вспышки как раньше.
4. Живой прогон слайдера туда-сюда: без перезапуска, без микрофризов от пересоздания контекста на каждом шаге (в логе — строки размера, но не шторм пересозданий; reuse в диапазоне NGX). Если NGX Auto не принимает render-размер вне своего диапазона — в логе будет `DLSS context creation failed` / `DLSS evaluation failed` и fallback на native TAAU; прислать лог.
5. DLSS off → слайдер 200%: суперсэмплинг native TAAU (мир 2× окна, FPS ниже, картинка чище); DLSS on → возврат к capped-масштабу.
6. `HORIZON_HD_SCALE=0.67` по-прежнему переопределяет слайдер; film quality — полный размер.
## Быстрый старт
1. Один раз запусти обычный Horizon Launcher, чтобы он подготовил ресурсы Minecraft 26.3.
+7 -5
View File
@@ -47,7 +47,7 @@ cd .. && rm -f horizon-patches/*.patch && git -C horizon format-patch -q $(cat H
## Конвейер кадра (HD включён)
Цели мира (G-буфер, AO, освещение, пост-проход мода) — в «масштабированном» разрешении мира (`world_post`; при `HORIZON_HD_SCALE` < 1 оно меньше окна), цели после TAA (история, bloom, tonemap) — в разрешении окна. HDR — `Rgba16Float`. Глубина камеры — reversed-Z
Цели мира (G-буфер, AO, освещение, пост-проход мода) — в «масштабированном» разрешении мира (`world_post`; масштаб — слайдер Resolution Scale настроек Horizon, `HORIZON_HD_SCALE` переопределяет его, при DLSS 100% = авто 2/3; при масштабе < 1 оно меньше окна), цели после TAA (история, bloom, tonemap) — в разрешении окна (или мира, если он суперсэмплирован больше окна). HDR — `Rgba16Float`. Глубина камеры — reversed-Z
(`Depth32Float`, 1 = близко, 0 = далеко). Позиции везде относительно камеры (camera-relative), мир — в `f64`
на CPU.
@@ -94,7 +94,7 @@ cd .. && rm -f horizon-patches/*.patch && git -C horizon format-patch -q $(cat H
совпадают, history UV = current UV + motion/render_size; вода, прозрачность и небо используют прежний
depth/camera fallback. Джиттер добавляется к
`view_projection` только при HD (публичная матрица без джиттера); рука и HUD рисуются после tonemap и не дрожат.
**TAAU**: если мир меньше окна (`HORIZON_HD_SCALE=0.67`), тот же проход (`fs_taau`, в таймингах `hd taau`) восстанавливает
**TAAU**: если мир меньше окна (слайдер Resolution Scale < 100%, авто DLSS 2/3 или `HORIZON_HD_SCALE=0.67`), тот же проход (`fs_taau`, в таймингах `hd taau`) восстанавливает
полное разрешение. История, bloom и tonemap — в разрешении окна. Для каждого пикселя выхода берётся 3×3 выборки мира
вокруг (с учётом джиттера в `taa_params.zw`), веса — полином, аппроксимирующий Lanczos-2, по расстоянию от центра
пикселя выхода до выборки; variance clip в YCoCg по тем же 3×3; глубина — ближайшая из 2×2; история (Catmull-Rom,
@@ -248,7 +248,7 @@ HORIZON_HD_TAA=0 --out run-home-bench/out/taa-off` — A/B; `--baseline run-home
Каждый пункт — самостоятельная задача. Перед началом прочитай `gfx/hd/mod.rs` (контракты) и файл нужного прохода.
1. **TAAU — временной апскейлер** (поверх TAA) — СДЕЛАНО (патч 18, см. статус; масштаб — `HORIZON_HD_SCALE`, переопределяет «масштаб разрешения» настроек Horizon только для HD; поля в `HdSettings` нет). Осталось: LOD-bias текстур террейна, MetalFX. Исходное ТЗ: Мир и G-буфер рендерятся в `render_scale` (например 0.67),
1. **TAAU — временной апскейлер** (поверх TAA) — СДЕЛАНО (патч 18, см. статус; масштаб — слайдер Resolution Scale настроек Horizon, живой, без перезапуска; `HORIZON_HD_SCALE` — явное dev-переопределение поверх слайдера, film quality — полный размер; поля в `HdSettings` нет). Приоритет и DLSS-взаимодействие — `hd::scale_override(slider)` / `scale_for` и тест `the_resolution_slider_drives_hd_scale`; с DLSS слайдер capped на 1 (апскейлер), 100% = авто 2/3, >100% — render в размер выхода; суперсэмплинг >1 — native TAAU без DLSS. Исправлен баг: раньше DLSS всегда пинил мир на 2/3 и слайдер игнорировался (ветка `agent/resolution-scale`, см. `docs/DLSS-TESTING.md`). Осталось: LOD-bias текстур террейна, MetalFX. Исходное ТЗ: Мир и G-буфер рендерятся в `render_scale` (например 0.67),
TAA-проход восстанавливает полное разрешение: история в полном разрешении, текущий кадр семплируется с учётом
джиттера (Catmull-Rom/Lanczos-веса по субпиксельной позиции), клиппинг окрестности как в TAA. Настройка
масштаба (`HORIZON_HD_SCALE` или поле в `HdSettings`). Цель: при 0.67 картинка близка к нативной, FPS заметно
@@ -257,8 +257,10 @@ HORIZON_HD_TAA=0 --out run-home-bench/out/taa-off` — A/B; `--baseline run-home
world+linearize → NGX → delinearize; native TAAU остаётся fallback. #137 довёл порядок до контракта:
film/tonemap/UI/capture/present записываются в encoder после delinearize и отправляются одним submit
без CPU sync (раньше они читали `taa.target` до записи NGX), а готовность нативной истории отделена от
истории NGX — первый fallback-кадр после DLSS не читает пустую/устаревшую native history. По умолчанию DLSS рендерит world 2/3,
`HORIZON_HD_SCALE` переопределяет это. Сборка требует `DLSS_SDK` (v310.9.1), `VULKAN_SDK`, clang и
истории NGX — первый fallback-кадр после DLSS не читает пустую/устаревшую native history. Render-размер DLSS — слайдер Resolution Scale
(capped на размер выхода; на дефолтных 100% — авто 2/3), `HORIZON_HD_SCALE` переопределяет это; контекст NGX живёт под размер выхода,
render-размер едет в каждой evaluate (`partial_texture_size`) и меняется вживую без пересоздания, пока вписывается в диапазон NGX.
Сборка требует `DLSS_SDK` (v310.9.1), `VULKAN_SDK`, clang и
`--features dlss`; runtime DLL/SO и NVIDIA notices нужны рядом с приложением, не в Git. Полный `cargo xwin build`
на MSVC и prerelease `v0.4.0-dlss-rc1` опубликованы; реальный RTX/Vulkan runtime ещё не проверен.
A/B инструкция — `docs/DLSS-TESTING.md`.
+1 -1
Submodule horizon updated: 182d553508...4e441de6af