84e9d6ab60
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>
99 lines
9.8 KiB
Markdown
99 lines
9.8 KiB
Markdown
# Проверка 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`.
|