[FrameGeneration] ; Select frame generation method ; auto/fsr3 (DLSS Enabled selects best FSR 3 version for the game), fsr30, fsr31, dlssg (latter supported only by RTX cards) Generator=auto ; HIGHLY EXPRIMENTAL!! Forces Frame Generation in games that do not support it natively, when switching to on, DLSS upscaler will activate DLSS Frame Generation (or FSR3 equivalent). ; this feature requires you to drop two additional files sl.dlss_g.dll and nvngx_dlssg.dll into the folder where sl.interposer.dll file is located. ; for now game also needs to support and have the Reflex feature active (otherwise you will experience a pink tinted image). ; off (default), on TranslateDLSS=off ; Override Reflex mode configured by the game ; Use experimental "inject" option to inject Reflex into the games that do not support Reflex at all (this option requires DLSS upscaler to be switched on) ; on, boost, off, inject Reflex=on ; EXPERIMENTAL: Enable Reflex emulation on non NVIDIA GPUs (this setting is ignored entirely NVIDIA GPUs, on which real Reflex feature is used). ; if set to auto mode it reduces the latency and stabilizes the framerates by using AntiLag2 (on AMD RDNA1 and better GPUs) or LatencyFlex (any other GPU not compatible with native Reflex feature) ; switch to "noop" if you experience stuttering, unstable FPS or temporal game hanging/slowdown ; switch to "on" to force the usage of LatencyFlex/AntiLag2 even if real Reflex is supported (auto value can be used on AMD/INTEL GPUs instead, as DLSS Enabler will switch to LatencyFlex/AntiLag2 in such cases) ; auto, on, off, noop ReflexEmulation=auto ; Maximum frame rate (including the generated frames) ; off (default), vsync (experimental, might not work with VRR displays) or any number, ie 60, 144.. FramerateLimit=off ; EXPERIMENTAL: Controls how the frames should be generated ; auto - default behavior, dynamic - frames are generated only if GPU cannot produce real frames below the "FramerateLimit" specified in the setting above. FrameGenerationMode=auto [DeepDVC] ; HIGHLY EXPRIMENTAL!! This option can be used to inject DeepDVC into games that do not support this feature natively (but is limited to real RTX cards for now) ; this feature requires you to drop two additional files sl.deepdvc.dll and nvngx_deepdvc.dll into the folder where sl.interposer.dll file is located. ; auto (default), true, false Enable=auto ; Controls the intensity (used only with Enable=true setting) ; available range: 0.0-1.0 Intensity=0.5 ; Controls the saturation boost (used only with Enable=true setting) ; available range: 0.0-1.0 Intensity=0.75 ; ------------------------------------------------------- [Upscalers] ; ------------------------------------------------------- ; Select upscaler for Dx11 games ; fsr22 (native dx11), fsr31 (native dx11), xess (with dx12), fsr21_12 (dx11 with dx12), fsr22_12 (dx11 with dx12), fsr31_12 (dx11 with dx12), dlss - Default (auto) is fsr22 Dx11Upscaler=auto ; Select upscaler for Dx12 games ; xess, fsr21, fsr22, fsr31, dlss - Default (auto) is xess Dx12Upscaler=auto ; Select upscaler for Vulkan games ; fsr21, fsr22, fsr31, dlss - Default (auto) is fsr21 VulkanUpscaler=auto ; ------------------------------------------------------- [FrameGen] ; ------------------------------------------------------- ; Enables FSR3.1 frame generation swapchain ; without this option OptiScaler will disable all FG features ; true or false - Default (auto) is true UseFGSwapChain=auto ; Enables FSR3.1 frame generation ; true or false - Default (auto) is false Enabled=auto ; Enables FSR3.1 frame generation debug view ; true or false - Default (auto) is false DebugView=auto ; Enables async FSR3.1 frame generation ; true or false - Default (auto) is false AllowAsync=auto ; Enables HUD fix FSR3.1 frame generation ; Might cause crashes, specially with Async ; true or false - Default (auto) is false HUDFix=auto ; Delays HUDless image capture ; Might cause crashes, specially if set too high ; integer value above > 0 - Default (auto) is 0 HUDLimit=auto ; ------------------------------------------------------- [Dx11withDx12] ; ------------------------------------------------------- ; Syncing meathods for Dx11 with Dx12 ; ; Valid values are; ; 0 - No syncing (fastest, most prone to errors) ; 1 - Fence ; 2 - Fences + Flush ; 3 - Fences + Event ; 4 - Fences + Flush + Event ; 5 - Query Only ; Default (auto) is 1 TextureSyncMethod=auto ; Default (auto) is 5 CopyBackSyncMethod=auto ; Start output copy back sync after or before Dx12 execution ; true or false - Default (auto) is true SyncAfterDx12=auto ; Delay some operations during creation of D11wDx12 features to increase compatibility ; true or false - Default (auto) is false UseDelayedInit=auto ; Prefer using D3D11_RESOURCE_MISC_SHARED, which is lower level ; and a bit more performant and possibly less compatible ; true or false - Default (auto) is false DontUseNTShared=auto ; ------------------------------------------------------- [XeSS] ; ------------------------------------------------------- ; Building pipeline for XeSS before init ; true or false - Default (auto) is true BuildPipelines=auto ; Creating heap objects for XeSS before init ; true or false - Default (auto) is true CreateHeaps=auto ;Select XeSS network model ; 0 = KPSS | 1 = Splat | 2 = Model 3 | 3 = Model 4 | 4 = Model 5 | 5 = Model 6 ; Default (auto) is 0 NetworkModel=auto ; Path of libxess.dll ; Default (auto) is same folder as mod dll LibraryPath=auto ; ------------------------------------------------------- [FSR] ; ------------------------------------------------------- ; 0.0 to 180.0 - Default (auto) is 60.0 VerticalFov=auto ; If vertical fov is not defined will be used to calculate vertical fov ; 0.0 to 180.0 - Default (auto) is off HorizontalFov=auto ; Sets camera near value for FSR and above ; 0.0 to max float value - Default (auto) is 0.0001 CameraNear=auto ; Sets camera far value for FSR and above ; 0.0 to max float value - Default (auto) is 0.9999 CameraFar=auto ; Enables debug view for FSR3.X upscaler ; true or false - Default (auto) is false DebugView=auto ; Selects upscaler backend for FSR3.X ; 0 = FSR 3.1.0 | 1 = FSR 2.3.2 ; 0 or 1 (for now) - Default (auto) is 0 UpscalerIndex=auto ; Sets velocity factor for FSR3.1.1 and above ; 0.0 to 1.0 - Default (auto) is 1.0 VelocityFactor=auto ; Use raw DLSS reactive mask as transparency mask ; true or false - Default (auto) is true UseReactiveMaskForTransparency=auto ; Bias to apply DLSS reactive mask when using with FSR ; Higher the value, more bias on new frame ; 0.0 - 0.9 - Default (auto) is 0.45 DlssReactiveMaskBias=auto ; ------------------------------------------------------- [DLSS] ; ------------------------------------------------------- ; Enables calls to original NVNGX ; true or false - Default (auto) is true Enabled=auto ; Path of nvngx.dll / _nvngx.dll ; Default (auto) is path defined in registry LibraryPath=auto ; Path of nvngx_dlss.dll ; Default (auto) is means override disabled NVNGX_DLSS_Path=auto ; Set this to true to enable custom render preset overrides ; true or false - Default (auto) is false RenderPresetOverride=auto ; Render presets for quality settings ; 0 = Default | 1 = A | 2 = B | 3 = C | 4 = D | 5 = E | 6 = F | 7 = G ; Default (auto) is 0 RenderPresetDLAA=auto RenderPresetUltraQuality=auto RenderPresetQuality=auto RenderPresetBalanced=auto RenderPresetPerformance=auto RenderPresetUltraPerformance=auto ; ------------------------------------------------------- [Menu] ; ------------------------------------------------------- ; Enables new overlay ImGui menus ; without this option OptiScaler will disable all FG features ; true or false - Default (auto) is when OptiScaler is nvngx.dll false otherwise true OverlayMenu=auto ; In-game ImGui menu scale ; 1.0 to 2.0 - Default (auto) is 1.0 Scale=auto ; Shortcut key for opening menu ; Integer value - Default (auto) is 45 -> VK_INSERT (0x2D), previous default key VK_HOME is 36 (0x24) ShortcutKey=auto ; For all keycode values you can check this address ; https://learn.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes ; Enables advanced settings ; true or false - Default (auto) is false AdvancedSettings=auto ; Extends scaling ratio limits to 0.1 - 6.0 ; true or false - Default (auto) is false ExtendedLimits=auto ; ------------------------------------------------------- [Hooks] ; ------------------------------------------------------- ; Skip hooking of local nvngx files and only hook nvngx at registry ; Needed for Uniscaler + FG ; true or false - Default (auto) is false HookOriginalNvngxOnly=auto ; ------------------------------------------------------- [Spoofing] ; ------------------------------------------------------- ; Enables Nvidia GPU spoofing for DXGI ; true or false - Default (auto) is true Dxgi=auto ; Skips DXGI GPU spoofing when caller method in the list (example: slInit|slGetPluginFunction|nvapi_QueryInterface) ; Be careful this will disable spoofing for rest of the calls also does not work on Linux ; true or false - Default (auto) is disabled DxgiBlacklist=auto ; Spoof amount of VRAM for DXGI ; Spoofed amount in GBs - Default (auto) is disabled DxgiVRAM=auto ; Enables Nvidia GPU spoofing for Vulkan ; true or false - Default (auto) is false Vulkan=auto ; Enables Nvidia extension spoofing for Vulkan ; true or false - Default (auto) is false VulkanExtensionSpoofing=auto ; Spoofed GPU name ; Default (auto) is NVIDIA GeForce RTX 4090 SpoofedGPUName=auto ; ------------------------------------------------------- [Plugins] ; ------------------------------------------------------- ; Path that will be searched for same filename plugins (dxgi.dll, winmm.dll, etc.) ; Default is .\plugins Path=auto ; Loads SpecialK64.dll from game's exe folder ; Please put a SpecialK.dxgi file next to SpecialK64.dll ; to set SpecialK's working mode otherwise it will not be activated ; true or false - Default (auto) is false LoadSpecialK=auto ; ------------------------------------------------------- [NvApi] ; ------------------------------------------------------- ; Override loading of nvapi64.dll ; true or false - Default (auto) is false OverrideNvapiDll=auto ; If nvapi override enabled and file path defined here ; will try to load it from here, otherwise will check current folder for nvapi64.dll ; true or false - Default (auto) local folder NvapiDllPath=auto ; ------------------------------------------------------- [Sharpness] ; ------------------------------------------------------- ; Override DLSS sharpness paramater with fixed shapness value ; true or false - Default (auto) is false OverrideSharpness=auto ; Strength of sharpening, ; value range between 0.0 and 1.0 (while using upper limit is RCAS 1.3) - Default (auto) is 0.3 Sharpness=auto ; ------------------------------------------------------- [OutputScaling] ; ------------------------------------------------------- ; Enable output scaling option for Dx12 and Dx11 with Dx12 backends ; true or false - Default (auto) is false Enabled=auto ; Output scaling ratio ; 0.5 - 3.0 - Default (auto) is 1.5 Multiplier=auto ; Enable FSR for upscaling & downscaling, otherwise bicubic will be used ; true or false - Default (auto) is true UseFsr=auto ; ------------------------------------------------------- [CAS] ; ------------------------------------------------------- ; Enables RCAS sharpening ; true or false - Default (auto) is false Enabled=auto ; Enable motion sharpness ; true or false - Default (auto) is false MotionSharpnessEnabled=auto ; Sharpening will be added or removed according to motion length ; value range between -1.0 and 1.0 - Default (auto) is 0.8 MotionSharpness=auto ; How much a pixel should move before motion sharpness applied ; 0.0 - 100.0 - Default (auto) is 0.0 MotionThreshold=auto ; How much a pixel should move to reach maximum MotionSharpness value ; Values between MotionThreshold and this value will use be used to scale sharpness value ; 0.0 - 100.0 - Default (auto) is 10.0 MotionScaleLimit=auto ; Enable debug highlighting for motion sharpening ; Reddish hue for added greenish for reduced sharpness ; true or false - Default (auto) is false MotionSharpnessDebug=auto ; ------------------------------------------------------- [Log] ; ------------------------------------------------------- ; Log file, if undefined OptiScaler.log file in current folder ; Default (auto) is OptiScaler.log in same folder LogFile=auto ; Verbosity level of file logs ; 0 = Trace / 1 = Debug / 2 = Info / 3 = Warning / 4 = Error ; Default (auto) is 2 = Info LogLevel=auto ; Log to console (Log level is always 2 (Info) for performance reasons) ; true or false - Default (auto) is false LogToConsole=auto ; Log to file ; true or false - Default (auto) is false LogToFile=auto ; Log to NVNGX API ; true or false - Default (auto) is false LogToNGX=auto ; Open console window for logs ; true or false - Default (auto) is false OpenConsole=auto ; When set to false creates a new log file for every OptiScaler session ; true or false - Default (auto) is true SingleFile=auto ; ------------------------------------------------------- [InitFlags] ; ------------------------------------------------------- ; Force add ENABLE_AUTOEXPOSURE to init flags ; Some Unreal Engine games needs this, fixes colors specially in dark areas ; true or false - Default (auto) is DLSS value AutoExposure=auto ; Force add HDR_INPUT_COLOR to init flags ; true or false - Default (auto) is DLSS value HDR=auto ; Force add INVERTED_DEPTH to init flags ; true or false - Default (auto) is DLSS value DepthInverted=auto ; Force add JITTERED_MV flag to init flags ; true or false - Default (auto) is DLSS value JitterCancellation=auto ; Force add HIGH_RES_MV flag to init flags ; true or false - Default (auto) is DLSS value DisplayResolution=auto ; Force remove RESPONSIVE_PIXEL_MASK from init flags ; true or false - Default (auto) is true DisableReactiveMask=auto ; ------------------------------------------------------- [UpscaleRatio] ; ------------------------------------------------------- ; Set this to true to enable the internal resolution override ; true or false - Default (auto) is false UpscaleRatioOverrideEnabled=auto ; Set the forced upscale ratio value ; Default (auto) is 1.3 UpscaleRatioOverrideValue=auto ; ------------------------------------------------------- [QualityOverrides] ; ------------------------------------------------------- ; Set this to true to enable custom quality mode overrides ; true or false - Default (auto) is false QualityRatioOverrideEnabled=auto ; Set custom upscaling ratio for each quality mode ; ; Default (auto) values: ; DLAA : 1.0 ; Ultra Quality : 1.3 ; Quality : 1.5 ; Balanced : 1.7 ; Performance : 2.0 ; Ultra Performance : 3.0 QualityRatioDLAA=auto QualityRatioUltraQuality=auto QualityRatioQuality=auto QualityRatioBalanced=auto QualityRatioPerformance=auto QualityRatioUltraPerformance=auto ; ------------------------------------------------------- [DRS] ; ------------------------------------------------------- ; Set this to true to enable limiting DRS min resolution to rendering resolution ; true or false - Default (auto) is false DrsMinOverrideEnabled=auto ; Set this to true to enable limiting DRS max resolution to rendering resolution ; true or false - Default (auto) is false DrsMaxOverrideEnabled=auto ; ------------------------------------------------------- [Hotfix] ; ------------------------------------------------------- ; Override mipmap lod bias for textures ; -15.0 - 15.0 - Default (auto) is disabled MipmapBiasOverride=auto ; Override max anisotropy for textures ; 2, 4, 8, 16 - Default (auto) is disabled AnisotropyOverride=auto ; Rounds internal resolutions width and height to multiple of this value ; 2, 4, 8, 16 ... - Default (auto) is disabled RoundInternalResolution=auto ; Skips upscaling of n frames ; n is integer number - Default (auto) is disabled SkipFirstFrames=auto ; Restore last used compute signature after upscaling ; true or false - Default (auto) is false RestoreComputeSignature=auto ; Restore last used graphics signature after upscaling ; true or false - Default (auto) is false RestoreGraphicSignature=auto ; Use precompiled shaders for RCAS, Output Scaling ans Mask Bias ; true or false - Default (auto) is true UsePrecompiledShaders=auto ; Color texture resource state to fix for rainbow colors on AMD cards (for mostly UE games) ; For UE engine games on AMD, set it to D3D12_RESOURCE_STATE_RENDER_TARGET (4) ; Default (auto) is state correction disabled ColorResourceBarrier=auto ; Default (auto) is state correction disabled MotionVectorResourceBarrier=auto ; Default (auto) is state correction disabled DepthResourceBarrier=auto ; Default (auto) is state correction disabled ColorMaskResourceBarrier=auto ; Default (auto) is state correction disabled ExposureResourceBarrier=auto ; Default (auto) is state correction disabled OutputResourceBarrier=auto ; Use generic appid with NGX, fixes OptiScaler preset override not working with certain games ; true or false - Default (auto) is false UseGenericAppIdWithDlss=auto ; These settings defines each resources initial resource ; state and add resource barrier for correct state ; ; Common resource barrier states ; ---------------------------------------------------- ; D3D12_RESOURCE_STATE_COMMON = 0, ; D3D12_RESOURCE_STATE_VERTEX_AND_CONSTANT_BUFFER = 1, ; D3D12_RESOURCE_STATE_INDEX_BUFFER = 2, ; D3D12_RESOURCE_STATE_RENDER_TARGET = 4, ; D3D12_RESOURCE_STATE_UNORDERED_ACCESS = 8, ; D3D12_RESOURCE_STATE_DEPTH_WRITE = 16, ; D3D12_RESOURCE_STATE_DEPTH_READ = 32, ; D3D12_RESOURCE_STATE_NON_PIXEL_SHADER_RESOURCE = 64, ; D3D12_RESOURCE_STATE_PIXEL_SHADER_RESOURCE = 128, ;------------------------------------------------------ ; ; All state values can be checked from here ; https://learn.microsoft.com/en-us/windows/win32/api/d3d12/ne-d3d12-d3d12_resource_states