Point horizon at b4c68a78b (the slider is monotonic: 100% renders 1:1 DLAA, 80% no longer renders larger than 100%). Update the scale docs and pin test-dlss.bat to HORIZON_HD_SCALE=0.67 for the upscaling A/B (empty would now be DLAA at the slider's 100%). Co-Authored-By: Kimi Code <noreply@moonshot.ai>
29 KiB
Проверка DLSS SR на Windows / RTX
Это тестовая, а не релизная сборка #124. Она включает native DLSS Super Resolution через Vulkan и сохраняет обычный TAAU как fallback. Frame generation здесь нет; RTX 3060 его и не поддерживает.
Temporal stability: дрожь с DLSS и мерцание native TAAU (ветка agent/dlss-temporal-stability)
Что исправлено
DLSS (сильная дрожь всего изображения). Буфер motion в G-buffer — это current→previous в джиттеренных пикселях рендера (оба кадра со своим джиттером). Флаги создания DLSS-контекста не включали MVJittered, поэтому NGX использовал векторы как есть и применял переданный jitter_offset — джиттер камеры учитывался дважды, отсюда «дрожит адски». Исправление: флаг DlssFeatureFlags::JitteredMotionVectors (horizon/crates/horizon-client/src/gfx/hd/dlss.rs, коммит f536fa958). С ним NGX сам вычитает разницу джиттеров из векторов по per-frame jitter_offset.
Контракт сверен по первоисточникам (не по догадкам):
- NVIDIA DLSS Programming Guide (редакция 31 марта 2026, SDK 310.x — тот же, что оборачивает
dlss_wgpu6.0.0),doc/DLSS_Programming_Guide_Release.pdfиз NVIDIA/DLSS:- §3.6/3.6.1: векторы — current→previous, в пикселях render-разрешения, начало координат сверху слева, y вниз; формат RG16F/RG32F. Наш буфер (
Rg16Float,terrain.wgsl/entity.wgslmotion_pixels) ровно такой. - §3.6.2:
MVJittered=1— «DLSS then internally subtracts jitter from the motion vectors using the jitter offset values provided during the Evaluate call»;MVLowRes=1— векторы в render-разрешении (NGX сам их dilate'ит). Оба флага теперь стоят. - §3.6.3:
InMVScaleX/Y = 1.0, если масштабирование не нужно. Пиксельные векторы не масштабируются —motion_vector_scale: [1,1]оставлен. Важно: совет{1/renderWidth, 1/renderHeight}из гайда Streamline относится к константеsl::Constants::mvecScaleсамого Streamline: его плагин (source/plugins/sl.dlss/dlssEntry.cpp) умножает её обратно на renderWidth и передаёт в NGXMV.Scale = 1.0для pixel-space (mvecPixelSpace ? 1.0f : mvecScale.x * renderWidth).dlss_wgpuзовёт NGX напрямую, без Streamline, поэтому у нас 1.0. - §3.7.3:
jitter_offset— джиттер текущего кадра в пикселях render-таргета, в той же системе координат, что векторы (y вниз), в пределах ±0.5.scene.jitter_pxименно такой. - §3.8.1:
DepthInverted=1для reversed-Z — уже стоял.
- §3.6/3.6.1: векторы — current→previous, в пикселях render-разрешения, начало координат сверху слева, y вниз; формат RG16F/RG32F. Наш буфер (
- Заголовок NGX
include/nvsdk_ngx_defs.h(NVIDIA/DLSS): флагNVSDK_NGX_DLSS_Feature_Flags_MVJittered = 1 << 2. - Исходник Streamline
dlssEntry.cpp:motionVectorsJittered == eTrue → MVJittered, jitter передаётся как есть.
Native TAAU (слабое мерцание, особенно на воде). Две причины найдены и исправлены (коммиты 26ee82398, acfb379aa):
- Вода анимируется без геометрического движения: волны наклоняют нормали, преломление/SSR-отражение/блики меняются каждый кадр, а motion-буфер на пикселях воды несёт движение только дна. История TAA конфликтовала с кадром — мерцание. Теперь TAA-проход читает собственную глубину воды (binding 7) и снижает вес истории там, где вода анимируется быстрее всего — вблизи камеры (до 0.8 для
fs_taa, до 0.7 дляfs_taau, спад до 96 блоков; дальняя вода с медленными волнами сохраняет полный вес). Это reactive mask; качество не снижается, TAA не выключается. - Листва и растения качаются на ветру, но motion-буфер знал только камеру (
prev_clipстроился из текущей wind-позиции). Теперь предыдущая позиция вершины вычисляется с ветром прошлого кадра (Globals.hd_motion.zw= прошлые секунды/сила ветра,terrain.wgslwind_offset_at) — листва несёт собственное движение, мерцание кроны и дальней лесополосы уходит.
Тени: каскады уже привязаны к текселям в мировых координатах (hd::cascades, f64 snap) — crawl отсутствует; дальняя каскада перерисовывается через кадр (HORIZON_HD_SHADOW_FAST), её матрица между перерисовками сдвигается за камерой — это корректно. Точность motion на дальних дистанциях достаточная: f16 хранит субпиксельные значения точно, f32-разница clip-координат на 500 блоках даёт ошибку ~1e-4 px.
Что проверить на RTX (порядок)
- Собрать с DLSS:
py tools\airdef.py all(веткаagent/dlss-temporal-stability), запуститьtest-dlss.bat --world "Имя мира". В%APPDATA%\horizon\logs\latest.logдолжна быть строкаDLSS Super Resolution: [1706, 960] -> [2560, 1440](для 1440p при масштабе 2/3) и не должно бытьusing native TAAU/DLSS evaluation failed. - Статичная сцена — главный тест. Встать неподвижно, смотреть на дальние статичные объекты (горы, строения) 10–15 секунд. Изображение не должно дрожать/вибрировать. Затем медленно повернуть камеру — не должно быть smear/ghosting на статичном мире. Для увеличения используй встроенный Windows Screen Magnifier (Win+«+», отключить «Smooth edges of images and text») — гайд §8.4.1.
- Движение:
/airdef move 2или/airdef wave shahed 8 300— движущиеся модели не должны двоиться/размазываться; дым и вспышки смотреть отдельно. - Вода и листва, DLSS off (
dlss offчерез меню мода или контрольный сокет, без перезапуска): постоять у воды с ветром — мерцание/«вибрация» воды и кроны должны заметно уменьшиться против старой сборки. Блики на воде остаются живыми (это анимация, не артефакт). - Motion-визуализация (отдельный прогон, не для замера качества):
HORIZON_HD_DEBUG_MOTION=1— на статичной сцене векторы должны быть почти нулевыми (субпиксельная разница джиттеров), без крупных пятен. Это проверяет буфер, который видит NGX. - Скриншоты одного ракурса: DLSS on / DLSS off, статика и движение; лог обоих прогонов.
Опционально (для глубокой отладки джиттера): dev-версия nvngx_dlss.dll (фича debug_overlay у dlss_wgpu + DLSS_SDK с dev-профилем) даёт оверлей §8.2 и jitter-отладку §8.4: offsets всегда внутри ±0.5, хоткеи CTRL+ALT+F9/F10 меняют знак/оси джиттера на лету.
Если дрожь осталась: варианты по порядку (быстрая итерация)
Все правки — в horizon/crates/horizon-client/src/gfx/hd/dlss.rs (движок, ветка agent/dlss-temporal-stability), пересборка только игры.
- Вариант A (проверка знака/осей джиттера). В
render()передаватьjitter_offset: [jitter[0], -jitter[1]](или[-jitter[0], jitter[1]], или поменять оси местами). По документации наша система координат совпадает с NGX, так что это маловероятно, но гайд §8.4.1 советует именно это при остаточной дрожи. Признак: дрожь уменьшается при одном из знаков/осей. - Вариант B (нормализация Streamline).
motion_vector_scale: Some([1.0 / self.world[0] as f32, 1.0 / self.world[1] as f32]). Противоречит §3.6.3 для сырого NGX (и исходнику Streamline), но дёшево проверяется. Признак: если дрожь была от масштаба, картинка сразу стабилизируется; если станет хуже/размазаннее — вернуть[1,1]. - Вариант C (неджиттеренный буфер вместо флага). Убрать
JitteredMotionVectorsизFEATURE_FLAGSи добавить конверсионный проход перед NGX: новыйRg16Float-таргет world-размера, fullscreen-шейдер пишетmotion.xy + frame.taa_params.zw - frame.prev_jitter.xy(в точности коррекцияfs_taau, taa.wgsl:234), вDlssSuperResolutionRenderParameters.motion_vectorsподать его. Это зеркальный путь: NGX получает векторы без джиттера и использует их напрямую (§3.6.2, флаг=0). Признак: если флаг MVJittered в драйверной версии NGX работает иначе, чем описано, этот путь стабилизирует картинку.
Если дрожь ушла, но только вода/анимированные материалы двоится под DLSS — это отдельная задача: у NGX есть входы transparency/responsivity mask, dlss_wgpu передаёт их пустыми; native-путь теперь имеет reactive mask для воды.
Что проверено на Mac, а что ждёт RTX
Проверено (macOS, Metal, без DLSS-устройства): вся сюита cargo test -p horizon-client --lib — 1242 passed / 0 failed; GPU A/B smoke taau_gpu_smoke_still_surface_ab (Apple M5): исправленный decode даёт ошибку 0.0048 на уровне собственного пространственного фильтра (0.00478) и разброс по фазам 0.0029 против 0.0156 у старого decode; shader-валидация naga + трансляция HLSL для всех HD-шейдеров и terrain/entity; раскладка HdFrame/Globals; детерминизм джиттера и репроекции (численные тесты на всех фазах Halton); сборка бинарника без фичи dlss. Сам dlss.rs на Mac не компилируется (cfg windows/linux + feature) — флаг и тест the_feature_flags_match_the_motion_contract проверятся на Windows-сборке.
Ждёт RTX: собственно NGX-оценка (стабильность статики, движение, вода), тест флага в cargo test -p horizon-client --features dlss --lib gfx::hd::dlss, визуальное сравнение воды/листвы с reactive mask и wind-motion.
Переключатель DLSS
В сборках с фичей dlss DLSS теперь включён по умолчанию, а не только через HORIZON_DLSS=1:
- Меню мода: N → Огонь, ремонт, эффекты… → DLSS (NVIDIA). Строка показывает состояние; на устройстве без DLSS переключение — мягкий no-op («недоступен»), запрос сохраняется и применяется при следующем запуске, если устройство его поддерживает.
- Команда контрольного сокета:
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 (слайдер 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). Приоритет, первое совпадение выигрывает:
- Film quality (
render.set-film-quality, захват) — мир в полный размер окна. HORIZON_HD_SCALE(0.25–1, читается один раз при старте) — явное dev-переопределение, сильнее слайдера.- DLSS оценивает кадр (запрос включён + SDK открыт): слайдер — это render-размер, ограниченный размером выхода (апскейлер не рендерит больше выхода), монотонно: 100% = render 1:1 (DLAA, neural AA без апскейла), ниже 100% — DLSS апскейл (50% → половина, 80% → 0.8, 67% ≈ Quality); выше 100% мир рендерится в размер выхода (суперсэмплинг >1 — только native TAAU с выключенным DLSS).
- Иначе (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 заменяет слайдер (0.67, 0.5, 1.0); taau_gpu_smoke_still_surface_ab проходит; вся сюита cargo test -p horizon-client --lib; сборка без фичи dlss.
Что ждёт RTX (обязательно проверить):
- Слайдер 50 / 80 / 100 / 200% при включённом DLSS: в
latest.logстрокаDLSS Super Resolution: [w, h] -> [W, H]меняет render-размер (для 1440p: 50% → [1280, 720], 80% → [2048, 1152], 100% → [2560, 1440] (DLAA, 1:1), 200% → [2560, 1440]); картинка и FPS меняются от 50/80/100 (100% = DLAA, тяжелее апскейла); 200% при DLSS даёт render в размер выхода (не суперсэмплинг). - Статичная сцена после каждого переключения слайдера 10–15 с: нет дрожи/вибрации (регрессия #143), нет ghosting после смены масштаба (первый кадр с
InReset). - Движение (
/airdef move 2, налёт): модели не двоятся; дым/вспышки как раньше. - Живой прогон слайдера туда-сюда: без перезапуска, без микрофризов от пересоздания контекста на каждом шаге (в логе — строки размера, но не шторм пересозданий; reuse в диапазоне NGX). Если NGX Auto не принимает render-размер вне своего диапазона — в логе будет
DLSS context creation failed/DLSS evaluation failedи fallback на native TAAU; прислать лог. - DLSS off → слайдер 200%: суперсэмплинг native TAAU (мир 2× окна, FPS ниже, картинка чище); DLSS on → возврат к capped-масштабу.
HORIZON_HD_SCALE=0.67по-прежнему переопределяет слайдер; film quality — полный размер.
Быстрый старт
-
Один раз запусти обычный Horizon Launcher, чтобы он подготовил ресурсы Minecraft 26.3.
-
Распакуй
airdef-dlss-windows-x86_64.zip. Не удаляйnvngx_dlss.dll: он должен остаться рядом сhorizon-client.exe. Если Windows сообщает об отсутствииMSVCP140.dllилиVCRUNTIME140.dll, поставь Microsoft Visual C++ Redistributable 2015–2022 x64. -
Запусти **
test-dlss.bat --world "Имя мира"**. Скрипт сам включит мод,HORIZON_DLSS=1` и GPU pass timing. -
В игре выполни одну и ту же последовательность:
/airdef shader hd /airdef deploy radar_track /airdef deploy s400 /airdef damage off /airdef wave shahed 8 300Подожди около 20 секунд, пока начнётся налёт. Для движущихся моделей подойдёт и
/airdef move 2. -
Посмотри на ракеты/технику, сделай скриншот и запиши FPS/кадр. Не включай
HORIZON_HD_DEBUG_MOTIONпри измерении качества или FPS. -
Выйди и запусти
test-native.bat --world "Имя мира". Он использует TAAU с тем же масштабом 2/3 и тем же GPU timing. Повтори ту же сцену, ракурс и скриншоты.
Для честного A/B используй один мир и одну позицию камеры. Если налёт уже закончился, запусти следующий /airdef wave shahed 8 300. Не меняй разрешение окна или HD-настройки между прогонами.
Что подтверждает, что DLSS действительно включён
В %APPDATA%\horizon\logs\latest.log должна быть строка вроде:
DLSS Super Resolution: [1280, 720] -> [1920, 1080]
Не должно быть using native TAAU, FeatureNotSupported, no DLSS context или DLSS evaluation failed. Само наличие повышенного FPS не считается подтверждением backend.
Скрипты включают HORIZON_SHADER_PACK_TIMING=1, поэтому в лог попадают GPU pass timings. Сравнивай не только средний FPS, но и микрофризы, дым, вспышки и движущиеся ракеты.
Что прислать
%APPDATA%\horizon\logs\latest.logпосле DLSS-прогона.- Скриншоты одного ракурса с DLSS и native TAAU, желательно с движущейся техникой/ракетой и отдельно с дымом.
- Скриншот FPS/debug overlay обоих режимов или текстовые значения FPS.
- Если есть артефакты: кратко, что именно не так и меняется ли оно при движении камеры.
- Сохранения миров присылать не нужно.
Если игра не запускается
- Сначала проверь, что
nvngx_dlss.dllлежит рядом сhorizon-client.exeи ресурсы подготовлены лаунчером. - При ошибке про Vulkan/NGX пришли
latest.log: там должна быть конкретная причина. Не подменяй её догадкой про драйвер. - При
FeatureNotSupportedили другом сбое игра должна продолжить работу через native TAAU; это будет видно в логе. Такой запуск не является успешным тестом DLSS. test-native.batнужен только для сравнения; он не включает DLSS.
Сборка самостоятельно вместо готового архива
Нужны только Rust (с x86_64-pc-windows-msvc и wasm32-unknown-unknown) и Visual Studio Build Tools с C++. Ветка — kimi-work.
NVIDIA DLSS SDK, Vulkan SDK и LLVM ставить вручную больше не нужно: на Windows с NVIDIA RTX airdef.py сам скачивает всё, что читает dlss_wgpu при сборке (включая libclang.dll для bindgen), и кладёт nvngx_dlss.dll рядом с horizon-client.exe.
git clone --branch kimi-work https://gitea.maoniao.team/chexit/airdef.git
cd airdef
rustup target add x86_64-pc-windows-msvc wasm32-unknown-unknown
py tools\airdef.py all
all делает fork, game, mod, install. На Windows + RTX шаг game:
- Определяет новейший стабильный тег
v310.9.xв NVIDIA/DLSS через GitHub API; при недоступности API берёт закреплённыйv310.9.1. - Скачивает выборочно (не весь репозиторий):
include/*.h,lib/Windows_x86_64/x64/nvsdk_ngx_d.libиnvsdk_ngx_s.lib,lib/Windows_x86_64/rel/nvngx_dlss.dll(~59 МБ). Итог — около 67 МБ один раз. - Скачивает только заголовки KhronosGroup/Vulkan-Headers в
Include/: полный LunarG SDK не нужен,build.rsлинкует Vulkan сам. - Ищет уже установленный
libclang.dll(LIBCLANG_PATH,PATH,C:\Program Files\LLVM\bin, LLVM из Visual Studio). Если его нет — скачивает NuGet-пакетlibclang.runtime.win-x64(~34 МБ) и распаковывает из него толькоruntimes/win-x64/native/libclang.dll. - Собирает с
--features mods,dlss, передаваяDLSS_SDK,VULKAN_SDKиLIBCLANG_PATHв окружение cargo, затем копирует свежийnvngx_dlss.dllрядом с собраннымhorizon-client.exe.
Кэш и повторные сборки:
.horizon-cache/dlss-sdk/<tag>/ include/ + lib/Windows_x86_64/{x64,rel} + airdef-install.json
.horizon-cache/vulkan-headers/<tag>/ Include/vulkan/ + Include/vk_video/ + airdef-install.json
.horizon-cache/libclang/<version>/ libclang.dll + airdef-install.json
Повторный запуск видит маркер и полный набор файлов и ничего не скачивает. Удалить кэш можно целиком — при следующей сборке он появится снова.
Ручное переопределение по-прежнему работает и имеет приоритет: если задать DLSS_SDK (корень с include/nvsdk_ngx*.h и lib/Windows_x86_64/x64/), VULKAN_SDK (с Include/vulkan/vulkan.h) и/или LIBCLANG_PATH (каталог с libclang.dll), автоскачивание для этого компонента не выполняется. Если явный путь неполный, airdef.py предупреждает и собирает mods; чтобы вернуть автоскачивание, убери переменную.
Ручная альтернатива для libclang: winget install LLVM.LLVM, затем задать LIBCLANG_PATH на каталог bin установленного LLVM (там лежит libclang.dll).
При любой сетевой ошибке, недоступном GitHub/nuget.org, неполном скачивании или если libclang так и не нашёлся, сборка не падает: печатается предупреждение, ставится --features mods, и игра остаётся на native TAAU. На macOS и Linux, а также на Windows без RTX, автоскачивания нет — сразу mods.
Если bindgen всё же пишет Unable to find libclang, проверь LIBCLANG_PATH: он должен указывать на каталог, в котором лежит libclang.dll (не на сам файл). Удобно один раз выполнить winget install LLVM.LLVM и указать C:\Program Files\LLVM\bin.
Если nvngx_dlss.dll нужен отдельно (например, для ручной раскладки), он лежит в кэше: .horizon-cache/dlss-sdk/<tag>/lib/Windows_x86_64/rel/nvngx_dlss.dll. Его версия совпадает с самым новым тегом, который нашёл airdef.py.