totk.ini.example: sync_ahead no longer needs shadow storage on a discrete GPU; without it the GPU reads the game's memory in place behind guards, and only memory = import still refuses the switch

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Valiantsin DzerakhandClaude Opus 5.5 committed 2026-11-21 14:48:26 +03:00
1 parent 54b4e092cd
commit 9422939cb7
1 file changed
+6 -3
+6 -3
View File
@@ -70,11 +70,14 @@
# game waits once for the GPU to finish the frame it presented last; with 1 that wait covers the frame before it
# instead. On Great Sky Island (Linux, RX 9070 XT) with shadow_defer = 1 this took about 73 to 100 fps. Costs one more
# frame of input delay, and frame times vary more from frame to frame than with 0. GPU results the game reads back every frame after that wait, for example its depth queries, can be a frame old; a result it reads only once is waited for.
# Works on 1.1.0, 1.2.1 and 1.4.3. Needs shadow storage (shadow below), which is on by default on Linux and
# Wine and needs shadow = 1 on native Windows; without it the setting is ignored and the log says so.
# Works on 1.1.0, 1.2.1 and 1.4.3. With shadow storage (shadow below; on by default on Linux and Wine) the GPU
# reads copies of the game's memory; without it, on a discrete GPU (memory = mirror or auto), the GPU reads the
# game's memory in place and guards copy or wait for what the game rewrites while the GPU still reads it (no shadow
# copies, about 1 ms a frame less on a weak CPU). With memory = import and no shadow storage the setting is ignored
# and the log says so.
# sync_ahead = 0
# Shadow storage, 0 or 1: each CPU-visible memory pool of the game gets a host-visible copy that the GPU reads, in
# place of importing the game's memory. Default: on under Linux and Wine, off on native Windows. sync_ahead needs it.
# place of importing the game's memory. Default: on under Linux and Wine, off on native Windows.
# Costs about 0.2 ms a frame and doubles the memory of those pools (about 1.1 GB; docs/building.md). Read at start.
# shadow = 0
# With sync_ahead = 1: when the game changes memory the GPU still reads, queue the copy into the GPU's shadow of that