mirror of
https://github.com/optiscaler/OptiScaler.git
synced 2026-10-24 04:32:04 +00:00
160 lines
10 KiB
Markdown
160 lines
10 KiB
Markdown
|
|
|
|
OptiScaler is middleware that enables various upscaling technologies in DLSS2-only games. It allows non-Nvidia users to use upscaling by applying DLSS2 inputs to XeSS, FSR2, or FSR3. It also offers extensive customization options for all users, including those with Nvidia GPUs using DLSS.
|
|
|
|
Key aspects of OptiScaler:
|
|
- Enables XeSS, FSR2, and FSR3 in DLSS2-only games
|
|
- Provides tuning options for DLSS users
|
|
- Offers a wide range of tweaks and enhancements (RCAS & MAS, Output Scaling, DLSS Presets, Ratio & DRS Overrides etc.)
|
|
- Allows users to fine-tune their upscaling experience
|
|
- With version 0.7.0 and above experimental frame generation support
|
|
|
|
## Official Discord Server: [DLSS2FSR](https://discord.gg/2JDHx6kcXB)
|
|
|
|
*This project is based on [PotatoOfDoom](https://github.com/PotatoOfDoom)'s excellent [CyberFSR2](https://github.com/PotatoOfDoom/CyberFSR2).*
|
|
|
|
## Installation
|
|
> **Warning**: Do not use this mod with online games. It may trigger anti-cheat software and cause bans!
|
|
|
|
### Install as `non-nvngx` (For enabling all features like Frame Gen)
|
|
To overcome DLSS 3.7's signature check requirements, I implemented a method developed by **Artur** (creator of [DLSS Enabler](https://www.nexusmods.com/site/mods/757?tab=description)). Later, this method increased the compatibility of `OverlayMenu`, allowed OptiScaler to **spoof DXGI and Vulkan**, let users override the `nvapi64.dll` and even let users to force Anitsotropic Filtering and Mipmap Lod Bias. In short, this installation method allowed OptiScaler to provide more features to users.
|
|
|
|
Step-by-step installation (**Nvidia users please skip to step 3**):
|
|
1. We need an Nvidia signed dll file to bypass signature checks. All games that support DLSS come with `nvngx_dlss.dll`. Most of the time it's in the games exe folder (e.g. for Unreal Engine games it's `<path-to-game>\Binaries\Win64\`). Some games and engines keep these third party dll's in different folders (like `plugins`). So we need to find the `nvngx_dlss.dll` file and copy it to the games exe folder. If it's already in the games exe folder, make a copy of it.
|
|
2. Rename the copy of `nvngx_dlss.dll` in the games exe folder to `nvngx.dll`.
|
|
3. Rename OptiScaler's `nvngx.dll` to one of the [supported filenames](#optiscaler-supports-these-filenames) (I prefer `dxgi.dll`) [1].
|
|
4. Copy the renamed OptiScaler file to your game's executable folder.
|
|
5. If your GPU is not an Nvidia one, check [GPU spoofing options](Spoofing.md).
|
|
|
|
#### OptiScaler supports these filenames
|
|
* dxgi.dll
|
|
* winmm.dll
|
|
* version.dll
|
|
* wininet.dll
|
|
* winhttp.dll
|
|
* OptiScaler.asi (with an ASI loader)
|
|
|
|
*[1] Linux users should add renamed dll to overrides:*
|
|
```
|
|
WINEDLLOVERRIDES=dxgi=n,b %COMMAND%
|
|
```
|
|
|
|
If there is another mod (e.g. Reshade etc.) that uses the same filename (e.g. `dxgi.dll`), if you rename it with the `-original` suffix (e.g. `dxgi-original.dll`), OptiScaler will load this file instead of the original library.
|
|
|
|
Alternatively you can create a new folder called `plugins` and put other mods files in this folder. OptiScaler will check this folder and if it finds the same dll file (for example `dxgi.dll`), it will load this file instead of the original library.
|
|
|
|
|
|
**Please don't rename the ini file, it should stay as `nvngx.ini`**.
|
|
|
|
### Install as `nvngx.dll` (Limited features, FG and Overlay Menu will be disabled)
|
|
Step-by-step installation:
|
|
1. Download the latest relase from [releases](https://github.com/cdozdil/OptiScaler/releases).
|
|
2. Extract the contents of the archive next to the game executable file in your games folder. (e.g. for Unreal Engine games it's `<path-to-game>\Binaries\Win64\`) [1]
|
|
3. Run `EnableSignatureOverride.reg` from `DlssOverrides` folder and confirm merge. [2][3]
|
|
4. If your GPU is not an Nvidia one, check [GPU spoofing options](Spoofing.md).
|
|
|
|
*[1] This package contains latest version of `libxess.dll` and if game folder contains any older version of same library it would be overwritten. Consider backing up or renaming existing file.*
|
|
|
|
*[2] Normally Streamline and games check if nvngx.dll is signed, by merging this `.reg` file we are overriding this signature check.*
|
|
|
|
*[3] Adding signature override on Linux - There are many possible setups, this one will focus on steam games:*
|
|
* *Make sure you have protontricks installed*
|
|
* *Run in a terminal protontricks <steam-appid> regedit, replace <steam-appid> with an id for your game*
|
|
* *Press "registry" in the top left of the new window -> `Import Registry File` -> navigate to and select `EnableSignatureOverride.reg`*
|
|
* *You should see a message saying that you successfully added the entries to the registry*
|
|
|
|
*If your game is not on Steam, it all boils down to opening regedit inside your game's prefix and importing the file.*
|
|
|
|
## Update OptiScaler version when using DLSS Enabler
|
|
1. Delete/rename `dlss-enabler-upscaler.dll` in game folder
|
|
2. Extract `nvngx.dll` file from OptiScaler 7zip file to a temp folder
|
|
3. Rename `nvngx.dll` to `dlss-enabler-upscaler.dll`
|
|
4. Copy `dlss-enabler-upscaler.dll` from temp folder to the game folder
|
|
|
|
## Uninstallation
|
|
* Run `DisableSignatureOverride.reg` file
|
|
* Delete `EnableSignatureOverride.reg`, `DisableSignatureOverride.reg`, `nvngx.dll`, `nvngx.ini` files
|
|
* If there were a `libxess.dll` file and you have backed it up delete the new file and restore the backed up file. If you have overwrote old file **DO NOT** delete `libxess.dll` file. If there were no `libxess.dll` file it's safe to delete.
|
|
|
|
## How it works?
|
|
OptiScaler implements the necessary API methods of DLSS2 & NVAPI to act as a middleware. It interprets calls from the game and redirects them to the chosen upscaling backend, allowing games designed for one technology to use another.
|
|
|
|
## Features
|
|
* Supports multiple upscaling backends (XeSS, FSR 2.1.2, FSR 2.2.1, FSR 3.1 and DLSS)
|
|
* Experimental support for frame generation with version 0.7.0 and above
|
|
* Supports DLSS 3.7 and above (check [installation instructions](#install-as-non-nvngx))
|
|
* Supports DLSS-D (Ray Reconstruction) on Nvidia cards (Supports changing presets and using OptiScaler enchanchements)
|
|
* Ability to modify DLSS/DLSS-D presets on the fly
|
|
* Supports XeSS v1.3.x's Ultra Performance, NativeAA modes (**Not using XeSS 1.3.x scaling ratios**)
|
|
* An [in-game menu](https://github.com/cdozdil/OptiScaler/blob/master/Config.md) for tuning and saving settings on the fly (Shortcut key is **INSERT**)
|
|
* Full integration with [DLSS Enabler](https://www.nexusmods.com/site/mods/757) for DLSS-FG support
|
|
* **RCAS** support with **MAS** (Motion Adaptive Sharpening) for all Dx12 & Dx11 upscalers
|
|
* **Output Scaling** option (0.5x to 3.0x) for backends running on Dx12 & Dx11
|
|
* Supports DXGI spoofing (when running as `dxgi.dll`) as Nvidia GPUs (with XeSS detection to enable XMX on Intel Arc cards)
|
|
* Supports Vulkan spoofing (needs to be enabled from `nvngi.ini`) as Nvidia GPUs (not working for Doom Eternal)
|
|
* Supports loading specific `nvapi64.dll` file (when running in non-nvngx mode)
|
|
* Supports loading specific `nvngx_dlss.dll` file (when running in non-nvngx mode)
|
|
* Supports overriding scaling ratios
|
|
* Supports overriding DRS range
|
|
* Autofixes for [colored lights](https://github.com/cdozdil/OptiScaler/blob/master/Config.md#resource-barriers-dx12-only) on Unreal Engine & AMD graphics cards
|
|
* Autofixes for [missing exposure texture](https://github.com/cdozdil/OptiScaler/blob/master/Config.md#init-flags) information
|
|
* Ability to modify [Mipmap Lod Bias](https://github.com/cdozdil/OptiScaler/blob/master/Config.md#mipmap-lod-bias-override-dx12-only) value of game
|
|
|
|
## Configuration
|
|
Please check [this](Config.md) document for configuration parameters and explanations. *(Will be updated)*
|
|
|
|
## Known Issues
|
|
If you can't open in-game menu:
|
|
1. Please check that you have enabled DLSS from game options
|
|
2. Please try opening menu while you are in-game (while 3D rendering is happening)
|
|
3. There is a 200 frame delay before enabling in-game menu, please wait 10-15 seconds before opening menu.
|
|
4. If you are using RTSS (MSI Afterburner, CapFrameX) please enable this setting of RTSS and try updating RTSS.
|
|
|
|
|
|
Please check [this](Issues.md) document for rest of the known issues and possible solutions for them.
|
|
|
|
## Which APIs and Upscalers are Supported?
|
|
Currently OptiScaler can be used with DirectX 11, DirectX 12 and Vulkan but each API has different sets of upscaler options.
|
|
|
|
#### For DirectX 12
|
|
- XeSS 1.x.x (Default)
|
|
- FSR2 2.1.2, 2.2.1
|
|
- FSR3 3.1.0 & FSR2 2.3.2
|
|
- DLSS
|
|
|
|
|
|
#### For DirectX 11
|
|
- FSR2 2.2.1 (Default, native DX11)
|
|
- FSR3 3.1.1 (unofficial port to native DX11)
|
|
- XeSS 1.x.x, FSR2 2.1.2, 2.2.1, FSR3 3.1.0 & FSR2 2.3.2 (via background DX12 processing) [*]
|
|
- DLSS (native DX11)
|
|
|
|
[*] This implementations uses a background DirectX12 device to be able to use Dirext12 only upscalers. There is %10-15 performance penalty for this method but allows much more upscaler options. Also native DirectX11 implementation of FSR 2.2.1 is a backport from Unity renderer and has it's own problems which some of them avoided by OptiScaler. **These implementations does not support Linux** and will result black screen.
|
|
|
|
#### For Vulkan
|
|
- FSR2 2.1.2 (Default)
|
|
- FSR2 2.2.1
|
|
- FSR3 3.1.0 & FSR2 2.3.2
|
|
- DLSS
|
|
|
|
## Compilation
|
|
|
|
### Requirements
|
|
* Visual Studio 2022
|
|
|
|
### Instructions
|
|
* Clone this repo with all of its submodules.
|
|
* Open the OptiScaler.sln with Visual Studio 2022.
|
|
* Build the project
|
|
|
|
## Thanks
|
|
* @PotatoOfDoom for CyberFSR2
|
|
* @Artur for DLSS Enabler and helping me to implement NVAPI correctly
|
|
* @LukeFZ & @Nukem for their great mods and sharing their knowledge
|
|
* @FakeMichau for support, testing and feature creep
|
|
* @QM for continous testing efforts and helping me to reach games
|
|
* @Cryio, @krispy, @krisshietala, @Lordubuntu, @scz, @Veeqo for their hard work on [compatibility matrix](https://docs.google.com/spreadsheets/d/1qsvM0uRW-RgAYsOVprDWK2sjCqHnd_1teYAx00_TwUY)
|
|
* @RazzerBrazzer and DLSS2FSR community for all their support
|
|
|
|
## Credit
|
|
This project uses [FreeType](https://gitlab.freedesktop.org/freetype/freetype) licensed under the [FTL](https://gitlab.freedesktop.org/freetype/freetype/-/blob/master/docs/FTL.TXT) |