Files
airdef/docs/DLSS-TESTING.md
T
chexit 84e9d6ab60 Document the zero-step DLSS toolchain install
The quick-start build section no longer asks for an NVIDIA DLSS SDK or a
LunarG Vulkan SDK: `airdef.py all` downloads only the headers, static libs
and nvngx_dlss.dll it needs, caches them under .horizon-cache with a
version marker, and copies the fresh DLL beside horizon-client.exe. Keeps
the explicit DLSS_SDK/VULKAN_SDK override, the offline/failure fallback to
mods with native TAAU, and the remaining LLVM/clang build prerequisite.

Co-Authored-By: Kimi Code <noreply@moonshot.ai>
2026-11-21 15:40:00 +03:00

99 lines
9.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.
# Проверка DLSS SR на Windows / RTX
Это тестовая, а не релизная сборка #124. Она включает native DLSS Super Resolution через Vulkan и сохраняет обычный TAAU как fallback. Frame generation здесь нет; RTX 3060 его и не поддерживает.
## Переключатель 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: масштаб 2/3 по умолчанию действует, только когда DLSS включён и реально доступен.
Для A/B ниже `test-dlss.bat`/`test-native.bat` работают как раньше; если старт был с DLSS, оба режима можно снять и одним прогоном через `dlss off`/`dlss on` без перезапуска.
## Быстрый старт
1. Один раз запусти обычный Horizon Launcher, чтобы он подготовил ресурсы Minecraft 26.3.
2. Распакуй `airdef-dlss-windows-x86_64.zip`. Не удаляй `nvngx_dlss.dll`: он должен остаться рядом с `horizon-client.exe`. Если Windows сообщает об отсутствии `MSVCP140.dll` или `VCRUNTIME140.dll`, поставь Microsoft Visual C++ Redistributable 2015–2022 x64.
3. Запусти **`test-dlss.bat --world "Имя мира"**. Скрипт сам включит мод, `HORIZON_DLSS=1` и GPU pass timing.
4. В игре выполни одну и ту же последовательность:
```text
/airdef shader hd
/airdef deploy radar_track
/airdef deploy s400
/airdef damage off
/airdef wave shahed 8 300
```
Подожди около 20 секунд, пока начнётся налёт. Для движущихся моделей подойдёт и `/airdef move 2`.
5. Посмотри на ракеты/технику, сделай скриншот и запиши FPS/кадр. Не включай `HORIZON_HD_DEBUG_MOTION` при измерении качества или FPS.
6. Выйди и запусти **`test-native.bat --world "Имя мира"`**. Он использует TAAU с тем же масштабом 2/3 и тем же GPU timing. Повтори ту же сцену, ракурс и скриншоты.
Для честного A/B используй один мир и одну позицию камеры. Если налёт уже закончился, запусти следующий `/airdef wave shahed 8 300`. Не меняй разрешение окна или HD-настройки между прогонами.
## Что подтверждает, что DLSS действительно включён
В `%APPDATA%\horizon\logs\latest.log` должна быть строка вроде:
```text
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++, а также LLVM/clang — bindgen из `dlss_wgpu` требует `libclang`. Ветка — `kimi-work`.
NVIDIA DLSS SDK и Vulkan SDK ставить вручную больше не нужно: на Windows с NVIDIA RTX `airdef.py` сам скачивает всё, что читает `dlss_wgpu` при сборке, и кладёт `nvngx_dlss.dll` рядом с `horizon-client.exe`.
```powershell
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`:
1. Определяет новейший стабильный тег `v310.9.x` в [NVIDIA/DLSS](https://github.com/NVIDIA/DLSS) через GitHub API; при недоступности API берёт закреплённый `v310.9.1`.
2. Скачивает выборочно (не весь репозиторий): `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 МБ один раз.
3. Скачивает только заголовки [KhronosGroup/Vulkan-Headers](https://github.com/KhronosGroup/Vulkan-Headers) в `Include/`: полный LunarG SDK не нужен, `build.rs` линкует Vulkan сам.
4. Собирает с `--features mods,dlss`, передавая `DLSS_SDK` и `VULKAN_SDK` в окружение cargo, затем копирует свежий `nvngx_dlss.dll` рядом с собранным `horizon-client.exe`.
Кэш и повторные сборки:
```text
.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
```
Повторный запуск видит маркер и полный набор файлов и ничего не скачивает. Удалить кэш можно целиком — при следующей сборке он появится снова.
Ручное переопределение по-прежнему работает и имеет приоритет: если задать `DLSS_SDK` (корень с `include/nvsdk_ngx*.h` и `lib/Windows_x86_64/x64/`) и/или `VULKAN_SDK` (с `Include/vulkan/vulkan.h`), автоскачивание для этого компонента не выполняется. Если явный путь неполный, `airdef.py` предупреждает и собирает `mods`; чтобы вернуть автоскачивание, убери переменную.
При любой сетевой ошибке, недоступном GitHub или неполном скачивании сборка не падает: печатается предупреждение, ставится `--features mods`, и игра остаётся на native TAAU. На macOS и Linux, а также на Windows без RTX, автоскачивания нет — сразу `mods`.
Если `nvngx_dlss.dll` нужен отдельно (например, для ручной раскладки), он лежит в кэше: `.horizon-cache/dlss-sdk/<tag>/lib/Windows_x86_64/rel/nvngx_dlss.dll`. Его версия совпадает с самым новым тегом, который нашёл `airdef.py`.