Upscaling with DLSS and FSR

UNIGINE provides support for two advanced upscaling technologies: NVIDIA DLSS (Deep Learning Super Sampling) and AMD FSR 2 (FidelityFX Super Resolution 2). These technologies enable upscaling on a wide range of devices from different manufacturers.

These upscaling technologies are used to render high-resolution images based on the lower resolution source. If both upscalers are available, you can choose between them, or you can turn off upscaling at all. We suggest using the DLSS technology as it produces high-quality results with fewer visual artifacts.

The DLSS and FSR 2 upscalers have specific requirements and compatibility restrictions determining whether the application supports these features.

The upscalers are initialized on render initialization. To verify whether they are supported and initialized after application startup, you can do one of the following:

• Check the Render section of the console output.
• Run the dlss_info and/or fsr_info console commands.

For example, the Render section may provide the following information:

---- Render ----
DLSS is supported
DLSS Streamline version: 2.4.0
DLSS NGX version: 3.7.0
FSR is supported
FSR Version: 2.2.2
FSR Max Contexts: 8
FSR RAM Scratch Size: 10 MB

If the upscaler is not supported, a corresponding message will be displayed in the console.

DLSS#

DLSS is not supported
Not an Nvidia GPU

FSR 2#

FSR is not implemented, FSR is currently available only for DX12

For DLSS technology to work properly with UNIGINE, additional environment configuration is required.

1. Follow this link to download the NVIDIA Streamline SDK, which serves as a wrapper for DLSS and all its features.

2. Click Access Github.

   

3. Before proceeding, review the license details and make sure you accept all of its terms and conditions:

   Notice

   1. On the page that opens, find the license.txt file in the list of files and folders.

      

   2. Open the file and read the text carefully.

   3. Switch to the repository homepage by clicking Streamline.

      

   4. Find the NVIDIA Nsight Perf SDK License (28Sept2022).pdf file mentioned in the license.txt in the same list of files and folders.
   5. Open it and read the license carefully.
   6. If you accept all of the terms and conditions, proceed with the following steps.
4. Switch to the repository homepage by clicking Streamline as you did previously.

5. On the page that opens, click the green Code button and select Download ZIP from the drop-down list.

   

6. Navigate to the folder containing the downloaded Streamline-main.zip archive. This is typically the Downloads folder.
7. Extract the ZIP archive. By default, it is extracted to the Streamline-main folder. However, you can rename it if necessary.

8. Before proceeding, review the license details and make sure you accept all of its terms and conditions:

   Notice

   1. Open the Streamline-main/bin/x64 folder and find the nvngx_dlss.license.txt text file.
   2. Open the file and read the license carefully.
   3. If you accept all of the terms and conditions, proceed with the following steps.

9. Close the file, return to the Streamline-main/bin/x64 folder and find the following files:

   Notice

   You don't need to install the Streamline SDK. Simply navigate to the folder.
   • nvngx_dlss.dll
   • nvngx_dlss.license.txt
   • sl.common.dll
   • sl.dlss.dll
   • sl.interposer.dll

10. Copy these files to the bin folder of your UNIGINE project:

    Notice

    By copying the license file, you confirm that you accept all the terms and conditions it provides.
    1. Find your project in the UNIGINE SDK Browser and select Other Actions -> Open folder.

       

    2. In the directory that opens, find and open the bin folder.
    3. Copy the 5 files listed above.

11. Return to the Streamline-main root folder and find the following license files:

    • license.txt
    • NVIDIA Nsight Perf SDK License (28Sept2022).pdf

12. Copy these files to the root folder of your UNIGINE project.

    Notice

    By copying the license files, you confirm that you accept all the terms and conditions it provides.
13. The changes will be applied at the next application start-up. So, if you have UnigineEditor opened, restart it to apply changes.

14. In UnigineEditor, open the console and check that DLSS is available. The corresponding information is provided in the Render section:

    

    Notice

    If DLSS is not available, the corresponding message will be shown in the console.

To use DLSS for the scene, enable it in one of the following ways and specify settings:

• Via the UnigineEditor interface:

  

• Using the render_upscale_mode console command:

  Source code

  render_upscale_mode 2

Before applying FSR 2 upscaling, you should check if it is available. In UnigineEditor, open the console and check the information provided in the Render section:

To use FSR 2 for the scene, enable it in one of the following ways and specify settings:

• Via the UnigineEditor interface:

  

• Using the render_upscale_mode console command:

  Source code

  render_upscale_mode 1

Depending on the current upscale mode, the set of settings differs. Please refer to the Upscalers article.

By default, upscaling is applied before all post-processing effects are rendered. However, you can choose to apply upscaling after rendering the post-process effects.

It can be done via the console using the render_upscale_post command or in UnigineEditor by toggling the Upscale After Post Effects parameter.

A context is a single call per upscaling operation. The number of contexts that can be upscaled with FSR 2 is limited and can defined by the fsr_max_contexts console command. The recommended number of contexts is 8. Specifying the number of contexts is necessary when rendering into multiple viewports: the number of the viewports must correspond to the number of contexts.