From f654da3d8be7eb754c7a7b2c1cffc3fd9e2ee37e Mon Sep 17 00:00:00 2001 From: Valiantsin Dzerakh Date: Thu, 29 Oct 2026 17:20:03 +0300 Subject: [PATCH] List the performance and diagnostics keys in totk.ini.example with what each does and its default The file pointed at the Advanced tab for them; it now has every key the tab shows, grouped as the tab groups them, and a [diagnostics] section for trace and the flight recorder. Co-Authored-By: Claude Opus 5.5 --- totk.ini.example | 86 +++++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 81 insertions(+), 5 deletions(-) diff --git a/totk.ini.example b/totk.ini.example index 58cdfa0e..e7adbab8 100644 --- a/totk.ini.example +++ b/totk.ini.example @@ -16,10 +16,81 @@ # highfps_fix = 1 [performance] -# A thread waiting for a virtual core interrupts the owner when it runs game code (0 = off, the old scheduling). +# The keys of this section and of [diagnostics] are for testing and troubleshooting, and take effect at the next start. +# The Advanced tab of the settings menu (F1) shows all of them except zstd_native and zstd_check. + +# Scheduling. +# A thread waiting for a virtual core interrupts the owner when it runs game code: 1 = on, 2 = priority inheritance +# without the interrupt, 0 = off (the old scheduling). # async_preempt = 1 -# Replay NVN submissions on their own thread, at most one frame behind the game (1 = on). +# Replay NVN submissions on their own thread, at most one frame behind the game (1 = on). Adds up to a frame of latency. # replay_async = 0 +# 1 lifts the virtual core gate: guest threads run without the console's limit of one thread per core. +# free_cores = 0 +# Windows timer resolution of 1 ms for steadier frame pacing (0 = the Windows default). +# timer_1ms = 1 + +# Shaders and pipelines. +# Draws whose pipeline is still building: default waits on a reserved worker; draw is the previous scheduling. +# pipe_wait = default +# Which draws are dropped instead of waiting for their pipeline: strict (only draws into per-frame passes), any (also +# draws into passes whose target the previous frame rendered) or fullscreen (those and full-screen draws). +# pipe_skip = fullscreen +# Build shader stage libraries in the background ahead of time, and the threads for it (1 to 16; default: a quarter of +# the CPU threads). +# lib_prebuild = 1 +# lib_prebuild_threads = 4 +# Build known pipelines ahead of time. +# pipe_prebuild = 1 +# Threads that translate known shaders at start (1 to 64; default: half the CPU threads, at most 16). +# prewarm_xlate = 8 +# Vulkan graphics pipeline library. 0 if the driver misbehaves with it. +# gpl = 1 + +# Textures and memory. +# ASTC texture decoding: native (the GPU's own ASTC support), gpu (a compute shader), cpu, or auto (native when the GPU +# has it, gpu otherwise). +# astc = auto +# Game memory shared with the GPU: auto (mirror on a discrete GPU, import on an integrated one), import (host memory +# imported into Vulkan), mirror (pools used as buffers get a copy in video memory) or verify (mirror plus a check of +# every copy; slow). +# memory = auto +# A new texture created over a live texture's memory starts with that content instead of empty. +# tex_alias = 1 +# Host zstd decoder in place of the game's (0 = the game's), and a check that decodes every call both ways and logs +# the differences (1 = on; slow). +# zstd_native = 1 +# zstd_check = 0 + +# Render fixes. +# Wait for the game to finish rewriting level-of-detail data before the GPU reads it: stops objects flashing in the +# wrong place and a flat far field for a frame. +# lod_guard = 1 +# Fill the driver-reserved constant bank c0 (storage sizes, dispatch size, point size, base instance) instead of zeros. +# fix_c0 = 1 +# New GPU memory pools start zero-filled, as Switch memory does. +# fix_zero = 1 +# Optimisations, 0 turns each off: skip bindings that did not change, remember shader lookups, reuse the previous +# draw's pipeline when its state repeats, remember texture descriptors between draws, update descriptors in bulk, +# skip push constants that did not change. +# bind_skip = 1 +# shader_memo = 1 +# pipe_memo = 1 +# tex_memo = 1 +# desc_template = 1 +# push_skip = 1 +# Submit GPU work in parts every N draws between passes so the GPU starts earlier (0 to 1000; 0 = off), each part at +# least split_us microseconds long (0 to 20000). +# split_draws = 64 +# split_us = 1000 + +# Vulkan. +# Vulkan validation layer: checks every call and slows the game down a lot. Needs the layer installed (Vulkan SDK). +# vk_validation = 0 +# Dynamic vertex input, 0 or 1. Default: on, except on Intel's older integrated GPU drivers (Vulkan 1.3.215 and older). +# vk_dyn_vertex = 1 +# Pin the shader subgroup size to 32 when the GPU allows it. +# vk_subgroup_pin = 1 [display] # Presentation mode: mailbox (default when the driver offers it, vsync otherwise), fifo (vsync) or immediate. @@ -92,6 +163,11 @@ # Folder with RomFS mod files that replace or add game files. Default: none. # romfs_mods = -# The Advanced tab of the settings menu (F1) has more keys: scheduling, shaders and pipelines, textures and memory, -# render fixes, Vulkan and diagnostics. They are for troubleshooting; the menu shows each one with its default and -# writes it here when you change it. +[diagnostics] +# Extra lines in the log, comma separated: svc, host, ipc, fs, gfx, perf, sched, audio, present or all. The menu's +# Performance log sets perf (frame timings). Default: none. +# trace = perf +# Flight recorder: keeps the last frames and saves them to a flight folder next to the folder of totk.exe when a frame +# takes longer than flight_spike_ms (0 to 60000). +# flight = 0 +# flight_spike_ms = 100