ANR README

README проекта с github.com/apex-compute/ANR. Одним файлом markdown: README.md.

Apex Compute

Apex Neural Rendering (ANR)

Apex Neural Rendering by Apex Compute.

ANR FG Beta

  1. Download a package from Releases:
    • anr-fg-full: for games without OptiScaler.
    • anr-fg-addon: for games that already use OptiScaler.
  2. Close the game, extract the package and run the installer with the folder of the game's .exe:
    • Windows: install.cmd
    • Linux and Steam Deck (Proton): sh install.sh "<folder>", then set the game's launch options to the line it prints: WINEDLLOVERRIDES="dxgi=n,b" %command%, or winmm=n,b in Vulkan games
  3. In the game, turn on frame generation (the NVIDIA option where the game offers several).

To uninstall, run uninstall.cmd or sh uninstall.sh with the same folder.

Supported GPUs

On Windows 10 and 11, and on Linux and SteamOS with Proton.

Results and problems

Please post them as issues:

OptiScaler is GPL-3.0; its source for each release is attached to the release.

Record and compare frame generation

nr-record records the inputs a game gives its frame generation, losslessly. You can then replay a recording through any frame generation DLL you have (ANR FG, a game's DLSS-G nvngx_dlssg.dll) and compare the results as videos or images. nr-record includes no frame generation.

Requirements:

  1. Install. Download nr-record-1.2-windows.zip or nr-record-1.2-linux.tar.gz from the FG-V.B18 release and extract it. Close the game and run the installer with the folder of the game's .exe:

    • Windows: install.cmd "<folder>". No launch option is needed.
    • Linux and Steam Deck (Proton): sh install.sh "<folder>". Set the game's Steam launch options to WINEDLLOVERRIDES="dxgi=n,b" %command% (the ANR FG installer prints the same line). Do not set this on Windows: the game may not start.

    The installer copies nr-record into OptiScaler/custom/ and sets FGNvngxReplacement=nr-record in OptiScaler.ini (it keeps the original). When you are not recording, ANR FG generates the frames, or DLSS-G if ANR FG is not installed (forward in nr-record/dlssg/nr_record.ini). uninstall.cmd or sh uninstall.sh with the same folder removes nr-record and restores OptiScaler.ini. To install by hand: copy capture/OptiScaler/custom/nr-record into OptiScaler/custom/, set FGNvngxReplacement=nr-record, and set forward to ..\..\Apex Neural Rendering FG\dlssg\nvngx_dlssg.dll or nvidia.

  2. Record. Turn on DLSS frame generation in the game. F6 starts and stops a recording; F9 records the next 8 frames. Each start and stop beeps. While recording, the game shows only real frames. Recordings go to %LOCALAPPDATA%\nr-record\ (Windows) or ~/.local/share/nr-record/ (Proton). A frame takes about 26 MB at 3840x2160 and 6 MB at 1806x972. nr-record/dlssg/nr_record-<date>-<time>.log lists what was recorded.

    To record the upscaler's inputs instead (super resolution, D3D12 games): open OptiScaler's menu (Insert), pick nr-record in the upscaler list, and press F6 to start and stop. It upscales with the upscaler OptiScaler.ini names (DLSS on NVIDIA, else FSR, or XeSS) and records that output too. Pick your upscaler again afterwards. Replay these recordings with --generator dlss, fsr or xess (replay).

  3. Replay. On Windows, in the package folder (REC is a recording's folder):

    tools\nr-record.exe info REC
    tools\nr-replay.exe --record REC --out out\anr --generator provider --dll "<ANR FG folder>\nvngx_dlssg.dll" --label "ANR FG" --stream - | tools\nr-video.exe video - --out out\anr.mp4
    tools\nr-replay.exe --record REC --out out\dlssg --generator nvidia --dll "<game>\nvngx_dlssg.dll" --label DLSS-G --stream - | tools\nr-video.exe video - --out out\dlssg.mp4
    tools\nr-video.exe project out\anr.mp4 out\dlssg.mp4 --out out\cmp.compare.json --labels "ANR FG" DLSS-G
    

    On Linux, one command runs both replays under Proton's Wine and writes both videos, a side-by-side video and the compare project:

    python3 tools/nr_replay_wine.py --record REC --out cmp --video \
        --generator provider --dll "<ANR FG folder>/nvngx_dlssg.dll" --label "ANR FG" \
        --b-generator nvidia --b-dll "<game>/nvngx_dlssg.dll" --b-label DLSS-G
    

    For images, replay with --raw instead of --stream and run nr-video png.

  4. Compare. viewer/renderer --compare --project cmp/compare.json (Windows: viewer\renderer.exe --compare --project out\cmp.compare.json) plays both videos in sync, with a divider, side by side view, pixel zoom and marks, and exports videos and images. From the command line: --compare-export PROJECT --out FILE --very-high. viewer/renderer --captures lists your recordings and regenerates their frames with each generator.

Docs: recording, format, replay and videos, viewer.

Build: bazel build //record:nr-record //record/replay:nr-video //renderer; Windows parts: bazel build --config=windows_cross //record/capture:package //record/replay:nr-replay.

Citation

@software{apex_neural_rendering,
  author = {{Apex Compute}},
  title  = {Apex Neural Rendering (ANR)},
  year   = {2026},
  url    = {https://github.com/apex-compute/ANR},
  note   = {https://apexcompute.com/neural-rendering}
}

ANR (apex-compute/ANR)

Ищем в базе…

2.6K ·GitHub
Что это такое?Apex Neural Rendering (ANR) — это набор функций ИИ-графики от Apex Compute. Сейчас в бета-версии только ANR FG, часть с генерацией кадров. Суперразрешение и реконструкция лучей помечены как «Скоро бета».
Это мод для игры или отдельная программа?Это дополнение для игр, а не отдельная программа. Оно устанавливается в папку игры и работает через OptiScaler, заменяя собственную генерацию кадров игры.
Как это запустить?Скачайте anr-fg-full (для игр без OptiScaler) или anr-fg-addon (для игр, где уже используется OptiScaler) со страницы Releases. Закройте игру, распакуйте архив и запустите install.cmd в Windows или sh install.sh в Linux и Steam Deck, указав папку с .exe-файлом игры. В Linux задайте параметр запуска, который выводит установщик, например WINEDLLOVERRIDES='dxgi=n,b' %command%. Затем включите генерацию кадров в игре.
Что нужно, чтобы записывать и сравнивать кадры?Нужна игра на D3D12 или Vulkan с генерацией кадров DLSS, пакет anr-fg-full (в него входит OptiScaler), Windows 10/11 или Linux с Proton, а также ffmpeg и ffprobe в PATH. Для воспроизведения записей DLSS-G нужна видеокарта серии RTX 40 или 50.
Уже можно пользоваться?Не полностью. ANR FG пока в бета-версии, суперразрешение и реконструкция лучей помечены как «Скоро бета», а основной исходный код ANR «скоро появится».
Какие видеокарты и системы поддерживаются?NVIDIA серий RTX 20, 30, 40 и 50, а также GTX 16; AMD Radeon серий RX 5000, 6000, 7000 и 9000, а также Steam Deck; Intel Arc серий A и B. Работает на Windows 10/11, а также на Linux или SteamOS с Proton.
Что делает nr-record?Он записывает входные данные, которые игра передает генерации кадров, без потерь качества. Затем эти записи можно воспроизвести через ANR FG или DLSS-G и сравнить результаты в виде видео или изображений во встроенном просмотрщике.
Можно ли записывать и входные данные апскейлера?Да. В играх на D3D12 в меню OptiScaler можно выбрать nr-record и записать входные данные суперразрешения. Воспроизводить их можно с параметром --generator dlss, fsr или xess.
Как сообщить о результатах производительности или о проблемах?Для производительности запустите тестовый набор из релиза и прикрепите его файл результатов к issue. При проблемах укажите игру, видеокарту и драйвер, ОС, настройки и самый свежий лог nrfg.
Автор
apex-compute
Размер
0.8 MB
Звёзды
2.6K
Возраст
7 д
Коммиты · 90 дней