wouter/d4r
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Write Windows fork README in English

Browse Source
This commit is contained in:
Codex committed 2026-10-02 10:39:29 +03:00
1 parent cf43794450
commit eba26c3a76
1 file changed
+85 -84
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+85 -84
View File
@@ -1,102 +1,103 @@
# d4r для Windows / RDNA4 # d4r for Windows / RDNA4
Windows-форк [countervolts/d4r](https://github.com/countervolts/d4r) для запуска A Windows fork of [countervolts/d4r](https://github.com/countervolts/d4r) that
DLSS Super Resolution на **AMD Radeon RX 9070 XT / gfx1201** через D3D12, runs DLSS Super Resolution on **AMD Radeon RX 9070 XT / gfx1201** through
OptiScaler, ZLUDA и HIP. Целевые модели: **DLSS 4 preset K** и D3D12, OptiScaler, ZLUDA and HIP. The target models are **DLSS 4 preset K**
**DLSS 4.5 preset M**. Runtime работает непосредственно в Windows 11. and **DLSS 4.5 preset M**. The runtime runs directly on Windows 11.
**Статус: development / prerelease.** K и M работают на тестовой RX 9070 XT, **Status: development / prerelease.** K and M run on the tested RX 9070 XT,
включая 4K в Silent Hill 2. Текущий приоритет — производительность K. including 4K in Silent Hill 2. Improving K performance is the current priority.
## Скачать и запустить ## Download and run
[Готовые сборки](https://github.com/xdfnx-dev/d4r/releases) содержат Windows [Prebuilt releases](https://github.com/xdfnx-dev/d4r/releases) include the
shim, исправленный ZLUDA, изолированный HIP runtime, patched OptiScaler, Windows shim, patched ZLUDA, isolated HIP runtime, patched OptiScaler,
11 native K kernels, 5 native M kernels и исходники соответствующего commit. 11 native K kernels, 5 native M kernels and the corresponding committed sources.
Понадобятся Windows 11 x64, RX 9070 XT и D3D12 игра без anti-cheat. You need Windows 11 x64, an RX 9070 XT and a D3D12 game without anti-cheat.
Проверенный AMD driver: `32.0.31041.1004`. Другие GPU и драйверы пока The tested AMD driver is `32.0.31041.1004`. Other GPUs and drivers have not
не прошли такую же проверку. received the same validation.
Предоставьте собственные локальные `_nvngx.dll` и `nvngx_dlss.dll`. Supply your own local `_nvngx.dll` and `nvngx_dlss.dll`. The tested pair is
Проверенная пара: NGX `32.0.16.1714`, DLSS `310.9.1.0`. Native manifest NGX `32.0.16.1714` and DLSS `310.9.1.0`. The native manifest checks the
проверяет SHA256 DLSS DLL. NVIDIA binaries в сборку не включены. DLSS DLL's SHA256. NVIDIA binaries are excluded from the release.
Распакуйте ZIP и выполните команду из его каталога, подставив свои пути: Extract the ZIP and run this command from its directory, replacing the paths
with your game and local DLL locations:
```powershell ```powershell
.\windows-game.ps1 -GameExe "D:\Games\SILENT HILL 2\SHProto\Binaries\Win64\SHProto-Win64-Shipping.exe" -NgxCore "C:\Users\Administrator\d4r\_nvngx.dll" -DlssDll "C:\Users\Administrator\d4r\nvngx_dlss.dll" -Preset 11 -AsyncInterop .\windows-game.ps1 -GameExe "D:\Games\SILENT HILL 2\SHProto\Binaries\Win64\SHProto-Win64-Shipping.exe" -NgxCore "C:\Users\Administrator\d4r\_nvngx.dll" -DlssDll "C:\Users\Administrator\d4r\nvngx_dlss.dll" -Preset 11 -AsyncInterop
``` ```
В игре выберите upscaler, который перехватывает OptiScaler. `-Preset 11` Select an upscaler intercepted by OptiScaler in the game. `-Preset 11` selects
выбирает K, `-Preset 13` — M. Начинайте проверку M без `-AsyncInterop`: K; `-Preset 13` selects M. Start M testing without `-AsyncInterop`: the async
асинхронный путь сейчас проверяется прежде всего на K. Первый запуск может path is currently being tested primarily with K. The first launch may take
занять время на PTX compilation; следующие используют cache. time to compile PTX; subsequent launches reuse the cache.
Скрипт устанавливает `dxgi.dll`, конфигурацию OptiScaler и каталог `d4r` The script installs `dxgi.dll`, an OptiScaler configuration and a `d4r`
рядом с EXE, предварительно сохраняя заменяемые файлы. Вход и выход текущего directory beside the game EXE, backing up replaced files first. The current
кадра остаются в VRAM. Восстановление исходных файлов: frame's inputs and output stay in VRAM. Restore the original files with:
```powershell ```powershell
.\windows-game.ps1 -Action restore -GameExe "D:\Games\SILENT HILL 2\SHProto\Binaries\Win64\SHProto-Win64-Shipping.exe" .\windows-game.ps1 -Action restore -GameExe "D:\Games\SILENT HILL 2\SHProto\Binaries\Win64\SHProto-Win64-Shipping.exe"
``` ```
Подробные параметры установки и восстановления: See [docs/windows-game.md](docs/windows-game.md) for installation options,
[docs/windows-game.md](docs/windows-game.md). DLL requirements and restoration details.
## Что проверено ## Validation
| Проверка | Результат на RX 9070 XT | | Check | Result on RX 9070 XT |
| --- | --- | | --- | --- |
| Обнаружение GPU | HIP автоматически определяет `gfx1201`; проверяется D3D12/HIP LUID | | GPU detection | HIP automatically detects `gfx1201`; D3D12/HIP LUID is checked |
| HIP и CUDA через ZLUDA | Native HIP kernel и CUDA Driver API / PTX tests проходят | | HIP and CUDA through ZLUDA | Native HIP kernel and CUDA Driver API / PTX tests pass |
| D3D12 ↔ HIP | Shared VRAM buffers и fences; import/release lifetime test проходит | | D3D12 ↔ HIP | Shared VRAM buffers and fences; import/release lifetime test passes |
| K transformer | Все 11 native layers, NumPy/PTX/replay validation | | K transformer | All 11 native layers, NumPy/PTX/replay validation |
| M transformer | Все 5 native layers, 40 temporal captures, exact baseline | | M transformer | All 5 native layers, 40 temporal captures, exact baseline |
| Async K | Очередь кадров и Release/CreateFeature точно совпадают с synchronous RGB | | Async K | Queued frames and Release/CreateFeature match synchronous RGB exactly |
| Silent Hill 2 / K / 4K | 16 941 кадр с проверкой NaN/Inf, 203 292 native launches, 0 backend errors | | Silent Hill 2 / K / 4K | 16,941 frames checked for NaN/Inf, 203,292 native launches, 0 backend errors |
| Windows hardware tests | Все 16 CTest gates проходят | | Windows hardware tests | All 16 CTest gates pass |
Точные совпадения относятся к проверенным reference/control implementations Exact comparisons refer to this project's validated reference/control
этого проекта. Сравнение с DLSS на физической RTX ещё не выполнено. implementations. Comparison with DLSS on a physical RTX has not been performed.
Проверка одной игры не подтверждает совместимость со всеми D3D12 играми. Testing one game does not establish compatibility with every D3D12 game.
## Производительность и ограничения ## Performance and limitations
В локальной 4K сцене пользователь наблюдает около **62 FPS / 63% GPU** с In the local 4K scene, the user reports approximately **62 FPS / 63% GPU** with
async interop, против **49–51 FPS / 53%** в предыдущем synchronous варианте. async interop, compared with **49–51 FPS / 53%** in the earlier synchronous run.
Замеры также используют локально построенные и проверенные K output-store These measurements also use locally built and validated K output-store kernels.
kernels. Они содержат NVIDIA-derived code и в публичный ZIP не входят; Those objects contain NVIDIA-derived code and are excluded from the public ZIP.
команды их локальной сборки есть в Local build and validation commands are in
[docs/windows-performance.md](docs/windows-performance.md). [docs/windows-performance.md](docs/windows-performance.md).
Производительность K ещё дорабатывается. Замеры не являются контролируемым K performance remains under development. These readings are not a controlled
сравнением с FSR4. `-AsyncInterop` опционален и требует одной D3D12 command FSR4 comparison. `-AsyncInterop` is opt-in and requires one D3D12 command queue.
queue. Feature release и resource reconfiguration ожидают завершения GPU Feature release and resource reconfiguration wait for GPU consumers to finish;
consumers; обычная отправка кадра не удерживает CUDA mutex. ordinary frame submission does not hold the CUDA mutex.
M использует проверенную FP16-equivalent baseline. Native RDNA4 FP8 отдельно M uses the validated FP16-equivalent baseline. Native RDNA4 FP8 is separately
валидирован, но не показал выигрыша для полной сети и выключен по умолчанию. validated but has not demonstrated a full-network speedup and is disabled by
Windows preset L пока не валидирован. Frame Generation и DLSS 5 не входят default. Windows preset L is not validated. Frame Generation and DLSS 5 are
в текущую задачу. outside the current scope.
Package использует TheRock `10.2.0a20260929` / HIP `7.17.26386`. Stable HIP The package uses TheRock `10.2.0a20260929` / HIP `7.17.26386`. Stable HIP 7.2
7.2 воспроизводит leak при освобождении mapped external memory; поэтому reproduces a mapped external-memory release leak, so the validated package
закреплён отдельный TheRock runtime. GPU architecture не подменяется. pins a separate TheRock runtime. GPU architecture is never overridden.
## Сборка из исходников ## Build from source
```powershell ```powershell
git clone https://github.com/xdfnx-dev/d4r.git git clone https://github.com/xdfnx-dev/d4r.git
cd d4r cd d4r
``` ```
Подготовка закреплённых toolchains и patches описана в Pinned toolchain and source-patch setup is documented in
[docs/windows-rdna4-port.md](docs/windows-rdna4-port.md). Нужны CMake + Ninja, [docs/windows-rdna4-port.md](docs/windows-rdna4-port.md). You need CMake + Ninja,
LLVM/MinGW, Rust GNU toolchain, TheRock HIP, а для OptiScaler — MSVC v143 LLVM/MinGW, a Rust GNU toolchain, TheRock HIP and, for OptiScaler, MSVC v143
и Windows SDK. Setup-скрипты используют `.tools`; source dependencies — `external`. and the Windows SDK. Setup scripts use `.tools`; source dependencies use `external`.
После подготовки зависимостей выполните из корня репозитория: After preparing the dependencies, run from the repository root:
```powershell ```powershell
.\scripts\windows\build-zluda-windows.ps1 .\scripts\windows\build-zluda-windows.ps1
@@ -107,42 +108,42 @@ LLVM/MinGW, Rust GNU toolchain, TheRock HIP, а для OptiScaler — MSVC v143
.\scripts\windows\package-windows-game.ps1 -ArchivePath "$PWD\dist\windows-rdna4-game.zip" .\scripts\windows\package-windows-game.ps1 -ArchivePath "$PWD\dist\windows-rdna4-game.zip"
``` ```
Создание distributable ZIP требует committed source. Package включает manifest Creating a distributable ZIP requires committed source. The package includes
с hashes, dependency licenses, source patches и snapshot этого commit. a hash manifest, dependency licenses, source patches and a snapshot of that commit.
## Тесты и диагностика ## Tests and diagnostics
После сборки hardware gates: After building, run the hardware gates:
```powershell ```powershell
& .\.tools\python\cmake\data\bin\ctest.exe --test-dir build/windows-rdna4-therock --output-on-failure & .\.tools\python\cmake\data\bin\ctest.exe --test-dir build/windows-rdna4-therock --output-on-failure
``` ```
Async K regression с локальными NVIDIA DLL в корне репозитория: Run the async K regression with your local NVIDIA DLLs at the repository root:
```powershell ```powershell
.\scripts\windows\test-async-k.ps1 -ZludaRoot "$PWD\dist\zluda-windows-final" .\scripts\windows\test-async-k.ps1 -ZludaRoot "$PWD\dist\zluda-windows-final"
``` ```
Успех: `PASS`, exact RGB, finite output и `passed: true` в `validation.json`. Success requires `PASS`, exact RGB, finite output and `passed: true` in
Для ограниченного game test добавьте `-RunSeconds 120 -ValidateOutput` к `validation.json`. For a bounded game test, add `-RunSeconds 120 -ValidateOutput`
команде запуска. Скрипт сохраняет один ZIP с stdout/stderr, runtime/driver to the launch command. The script saves one ZIP containing stdout/stderr,
information, native/translated kernel records и OptiScaler logs. Для crash runtime/driver information, native/translated kernel records and OptiScaler logs.
диагностики используйте `-CaptureExceptions`. Use `-CaptureExceptions` when investigating a crash.
`-ProfileStages` измеряет host stages, `-ProfileCudaApi` — существующие CUDA `-ProfileStages` measures host stages; `-ProfileCudaApi` measures existing CUDA
API waits, `-ProfileGpuBoundary` вместе с `-AsyncInterop` — D3D12 GPU intervals API waits; `-ProfileGpuBoundary` with `-AsyncInterop` measures D3D12 GPU intervals
вокруг interop. `-ProfileKernels` синхронизирует HIP events и меняет scheduling. around interop. `-ProfileKernels` synchronizes HIP events and changes scheduling.
При замере обычного FPS оставляйте profiling и output scans выключенными. Leave profiling and output scans disabled when measuring ordinary FPS.
## Документация и лицензии ## Documentation and licenses
- [Архитектура, зависимости, milestones и результаты](docs/windows-rdna4-port.md). - [Architecture, dependencies, milestones and results](docs/windows-rdna4-port.md).
- [Game install / restore](docs/windows-game.md). - [Game installation and restoration](docs/windows-game.md).
- [Измерения K/M и FP8](docs/windows-performance.md). - [K/M and FP8 measurements](docs/windows-performance.md).
- [OptiScaler source patches](patches/optiscaler/README.md). - [OptiScaler source patches](patches/optiscaler/README.md).
- [ZLUDA source patches](patches/zluda). - [ZLUDA source patches](patches/zluda).
Проект основан на работе countervolts; Linux upstream code и документация This project builds on countervolts' work; Linux upstream code and documentation
сохранены для совместимости. Форк не связан с NVIDIA или AMD. Лицензия d4r: are retained for compatibility. The fork is not affiliated with NVIDIA or AMD.
[LICENSE](LICENSE); лицензии зависимостей включены в package. d4r's license is in [LICENSE](LICENSE); dependency licenses are included in the package.