engine: the Resolution Scale slider drives HD render scale (DLSS included)
build / mod (push) Failing after 33s
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:
+25
-1
@@ -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
@@ -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`.
|
||||
|
||||
Reference in New Issue
Block a user