From 9745206f2a5494e3f27bb60555f589f8685bbf80 Mon Sep 17 00:00:00 2001 From: Valiantsin Dzerakh Date: Sat, 31 Oct 2026 07:45:41 +0300 Subject: [PATCH] Document the ultrawide sizes, the fit default of aspect and the 1.4.3 limit Wide sizes other than the four the installer prepares get the wide camera with a 16:9 HUD stretched over it. aspect = fit letterboxes a 16:9 game in a wider window where it used to stretch. Ultrawide is 1.4.3 only. Co-Authored-By: Claude Opus 5.5 --- README.md | 2 +- docs/architecture.md | 9 ++++++++- totk.ini.example | 11 +++++++---- 3 files changed, 16 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 13e75988..a5f0fe75 100644 --- a/README.md +++ b/README.md @@ -27,7 +27,7 @@ Report problems as issues, following [CONTRIBUTING.md](CONTRIBUTING.md). - Linux and the Steam Deck - Mods made for emulators: unpack a mod into a `mods` folder -- Custom aspect ratios, including ultrawide +- Ultrawide on 1.2.1 (1.4.3 has it for 2560x1080, 3440x1440, 3840x1600 and 5120x2160; other shapes get the wide camera with a 16:9 HUD) - VRR ## Installing diff --git a/docs/architecture.md b/docs/architecture.md index 28a29bf7..29967538 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -93,7 +93,14 @@ Every guest thread is a host thread. TotK assumes Horizon's scheduler: three app - Resolution. Patch sets make the game read its output, swapchain and scene sizes from the patch page (MacNativeGames' sites); `resolution.c` sets them from `output_res` and `render_scale` and grows the texture heap and the application pool to match. When the window is larger than the output, `vk_fsr.c` runs AMD FSR 1 (EASU, - RCAS) on the present. + RCAS) on the present. An `output_res` that is not 16:9 (more than 1% off, `res_is_16x9`) also switches on the + `aspect` patch set (1.4.3 only), which hands the output's ratio to the camera, and `romfs.c` `overlay_init` loads the + `romfs-patches-x` overlay for it when it exists (`tools/make_romfs_patches.py --aspect`, laid out by + `tools/ultrawide_layout.py`; the installer builds four sizes: 2560x1080, 3440x1440, 3840x1600, 5120x2160). Other + shapes, such as 16:10 or 32:9, get the wide camera and the 16:9 HUD stretched over it. 1.2.1 has no camera patch: a + wide size there keeps the 16:9 view. The `aspect` setting (`fit`, the default; `stretch`) decides what the present does + when the window's shape differs from the output's: `fit` letterboxes, where a 16:9 game in a wider window used to be + stretched. - Occlusion queries never block the CPU; a result that is not ready counts as visible. - ASTC textures are uploaded as they are where the device reports `textureCompressionASTC_LDR`, and decoded by a compute shader everywhere else (`vk_astc.c`, `TOTK_ASTC`). The CPU decoder (`tex_astc*.c`) is the fallback and the test oracle. - Draw state. A draw whose program, bound state and textures repeat reuses the previous draw's shaders and skips rebuilding its descriptor sets; descriptor sets are written through update templates (`vk_exec_draw.c`, `vk_pipeline.c`). diff --git a/totk.ini.example b/totk.ini.example index 6bbc3537..c8807dc5 100644 --- a/totk.ini.example +++ b/totk.ini.example @@ -110,8 +110,10 @@ # gpu_name = NVIDIA # Game resolution: the size the game draws its picture and interface in (1280x720 to 7680x4320). Above 1920x1080 the # game's texture heap and memory pool grow with it. A size wider than 16:9, such as 3440x1440 on a 21:9 monitor, widens -# the camera's view to that shape and lays the HUD out for it (1.4.3; the installer prepares the UI for 2560x1080, -# 3440x1440, 3840x1600 and 5120x2160). Read at start. +# the camera's view to that shape and lays the HUD out for it. That is 1.4.3 only (1.2.1 keeps the 16:9 view), and the +# installer prepares the UI layout for four sizes: 2560x1080, 3440x1440, 3840x1600 and 5120x2160. Any other shape +# (16:10, 32:9) gets the camera's view but a 16:9 HUD, stretched over the picture, unless you build its layout with +# tools/make_romfs_patches.py --aspect WxH (wider than 16:9 only). Read at start. # output_res = 1920x1080 # 3D render scale: the scene's size relative to the game resolution, game (5/6, the game's own 1600x900 at 1080p) or # a percentage (25 to 400, at most 4096 pixels a side); above 100 supersamples the scene (anti-aliasing). Read at start. @@ -121,8 +123,9 @@ # upscaler = fsr # sharpness = 80 # Picture shape when the window's shape differs from the game resolution's (a 16:9 picture in a 21:9 fullscreen -# window): fit keeps it, with black bars at the sides or above and below; stretch fills the window. Changes while the -# game runs take effect at once. +# window): fit, the default, keeps the shape, with black bars at the sides or above and below, so a 16:9 game in a wider +# window is no longer stretched as it used to be; stretch fills the window. Changes while the game runs take effect at +# once. # aspect = fit [language]