"""The game's Windows manifest, as a .res the exe links in (nx2/build.py): UTF-8 as the process's code page. host/ and gpu/vk keep paths as UTF-8 char strings and call Windows' A functions (GetModuleFileNameA, CreateFileA, fopen ...) with them. Without a manifest those take and give the system's ANSI code page (1252 on a Western Windows), and a game folder whose name it cannot spell (Japanese on a Western Windows, an emoji anywhere) came back as "?": the game found neither image.bin nor its log's folder and closed with nothing on screen. activeCodePage UTF-8 (Windows 10 1903 and newer) makes every A function and the C runtime's narrow file functions UTF-8 for the whole process, its DLLs too (triforce_vk.dll, SDL2, FFmpeg). host/hos_main.c says so in a message box when the Windows is too old for it and the folder's name needs it. (Triforce) longPathAware: where Windows' own LongPathsEnabled is on (Windows 10 1607 and newer, a setting of the PC's), the A and W functions and the C runtime's file functions take paths of MAX_PATH (260) and more, for the files the game finds in a deep folder (the game's own nn::fs paths add the long-path prefix themselves, host/nn_fs.c fs_wide; host/hos_paths.h's and gpu/vk/vk_paths.h's probe too). Without that setting it changes nothing. (Triforce) HOOKSHOT_SEGMENT_HEAP=1 at the build: heapType SegmentHeap (Windows 10 2004 and newer) puts the whole process on Windows' segment heap in place of the NT heap, its DLLs and the graphics driver too. Measured on an RX 6700 XT (AMD's Windows driver, a cold shader preparation): 76% of the driver's compile threads' samples waited on the NT heap's lock, 12 workers ran slower than 6, and the first part of the preparation took 1,478 s against 982 s on the segment heap; play, four pairs of runs, within the noise. Not measured on NVIDIA, Intel or Windows 10, and the heap is fixed when the process starts, so the arms are two exes. On by default since the lab's play A/B on an RTX card (11-22: no fps lost); HOOKSHOT_SEGMENT_HEAP=0: off. The log's "the shaders' preparation runs on" line says which heap the process has (gpu/vk/prepare_threads.h segment_heap). python nx2/win_manifest.py [out.res] """ import os import struct import sys MANIFEST = b""" UTF-8 true """ # ((Triforce) HOOKSHOT_SEGMENT_HEAP=1: the element manifest() puts after longPathAware) SEGMENT_HEAP = b""" SegmentHeap """ _SEGMENT_HEAP_AFTER = b"""true """ def segment_heap_asked(environ=None): """(Triforce) The exe on Windows' segment heap unless HOOKSHOT_SEGMENT_HEAP=0 (the NT heap, as before). On by default since the lab A/B of 11-22 (the Market, 3+3, one build each way on an RTX card: 81.4 against 80.6 fps, 1% low 59.9 against 58.0)""" return (os.environ if environ is None else environ).get("HOOKSHOT_SEGMENT_HEAP", "").strip() != "0" def manifest(segment_heap=False): """MANIFEST, with SEGMENT_HEAP in its windowsSettings when segment_heap""" if not segment_heap: return MANIFEST at = MANIFEST.index(_SEGMENT_HEAP_AFTER) + len(_SEGMENT_HEAP_AFTER) return MANIFEST[:at] + SEGMENT_HEAP + MANIFEST[at:] RT_MANIFEST = 24 CREATEPROCESS_MANIFEST_RESOURCE_ID = 1 # (the one an exe's loader reads) def res_entry(kind, name, data, flags=0x1030, language=0x0409): """one resource of a .res file (the format nx2/make_icon.py writes too): sizes, numeric type and name, flags, language""" header = struct.pack(" 1 else os.path.join(os.getcwd(), "hookshot_manifest.res")))