Skip to content

Debugging Guide

File Locations

PathDescription
<game directory>/config/super_resolution/config.tomlMain configuration file
<game directory>/config/super_resolution/librariesNative library files
<game directory>/config/super_resolution/debugDumped shader code (when enabled)
<game directory>/config/super_resolution/error_logsShader compilation error reports
<game directory>/config/super_resolution/shader_cachesShader cache files

Debug Mode

How to Enable

Enable it in the in-game configuration screen, or set enable_debug = true in config.toml.

What It Does

  • GPU resources created by SR (textures, framebuffers, shaders, etc.) will be labeled, making them visible and identifiable in graphics debugging tools such as NVIDIA Nsight Graphics and RenderDoc.
  • GPU operations performed by SR will be wrapped in debug groups, so you can see clearly where each operation begins and ends in a frame capture.

Shader Code Dump

How to Enable

Enable it in the in-game configuration screen, or set debug_dump_shader = true in config.toml.

What It Does

When enabled, SR writes all internal shader code to the debug folder.

Each file is named using the following format:

<shader name>.<shader type>.<graphics API>.<code type>.glsl

The <code type> field will be one of:

ValueDescription
sourceThe raw shader source as passed to the compiler, before any macro insertion.
preprocessedThe shader code after Glslang preprocessing — macros expanded, includes resolved, ready to compile directly.