This project combines Streamline (https://gitlab-master.nvidia.com/streamline/sdk) and Donut (https://gitlab-master.nvidia.com/nvrhi/donut) to create a sample app demonstrating a Streamline integration.
- Ensure you have Cmake 3.20+ and the vulkan sdk (https://vulkan.lunarg.com) on your system.
- Ensure that a VK-compatible dxc.exe is available in your system
PATH. The best way to do this is to install a recent (1.2.198.1 or newer) Vulkan SDK from https://www.vulkan.org/ and ensure that itsbindirectory is in the build machine's systemPATH. - Clone this repository, then run in the commandline:
git submodule update --init --recursive - Copy your streamline SDK contents (
bin,lib,includeand, optionally,scripts) into thestreamlinefolder - Use Cmake to make the project solution (or use
make.bat). Cmake will attempt to locate plugins by searching first thestreamline/bin/x64and then thestreamline/bin/x64/developmentfolders forsl.interposer.dll. If found, it will load all SL plugin DLLs from the folder wheresl.interposer.dllwas located. - Open the solution and build (or use
build.bat) - Run the executable (or use
run.bat)
- D3D11 and D3D12 are integrated using the advanced 'hooking' mechanism by which we have two seperate native/proxy devices and swapchains that are passed into specific api calls. We statically link sl.interposer.lib instead of D3D libs.
- Vulkan is integrated using the basic mechanism, by which streamline hooks all of the api calls. We dynamically link sl.interposer.dll instead of vulkan-1.dll.
- Runing make.bat with
-AMD_AGS, adds support for AMD AGS, and shows how devs might go about integrating SL around this.
| Arguments | Effect |
|---|---|
| -width 1920 | Sets width |
| -height 1080 | Sets height |
| -fullscreen | Sets fullscreen (by default game runs in windowed) |
| -verbose | Allows vebose info level logging logging |
| -logToFile | Logs to file |
| -debug | Enables NVRHI and Graphics API validation Layer |
| -noSigCheck | Does not do streamline dll signiture check |
| -vsync | Enables Vsync |
| -sllog | Enables streamline logging |
| -scene "/myscene.fbx" | Loads a custom scene |
| -maxFrames 100 | Sets number of frames to render before the app shuts down |
| -Reflex_mode 1 | Sets Reflex mode: 1:On 2:Boost |
| -Reflex_fpsCap 60 | Sets Refex FPS cap to a given number |
| -DLSS_mode 1 | Sets the DLSS mode startup: 0:Off 1:MaxPerf 2:Balanced 3:MaxQual 4:UtraPerf 5:UltraQual |