Skip to content

game: add experimental Breath of the Wild display options - #2809

Draft
reis-lucas wants to merge 1 commit into
seedds:mainfrom
reis-lucas:botw-display-options
Draft

reis-lucas wants to merge 1 commit into
seedds:mainfrom
reis-lucas:botw-display-options

Conversation

@reis-lucas

@reis-lucas reis-lucas commented Nov 15, 2026 •

Copy link
Copy Markdown

What and why

Add opt-in Mac display controls for Breath of the Wild 1.9.0 while preserving the original 16:9 and render-resolution defaults. The camera uses the drawable aspect, the HUD remains centered, and docked 3D resolution can be raised independently to 1080, 1200 or 1440 lines. Both controls require the corresponding verified-build capability.

This is a draft, not a claim of complete ultrawide compatibility. Textured map layers now receive the same centering transform as their markers; decoded movies retain their original aspect using the existing movie-pacing signal. Full-width solid fades/backings remain eligible to cover the sides.

Remaining blockers: inventory Link has a separate camera and can appear stretched; pause-menu captures and L/R transitions can show duplicate/clipped layers; in-engine event cameras have not been validated. Attempts to squeeze every rendered picture introduced additional compositing defects and were rejected. The Slate is deliberately centered at 16:9 with side margins, rather than stretching its map or decoration. Other aspect ratios and a full playthrough remain unverified.

Camera/UI work adapts ComicBit's zelda-native-widescreen branch and credits MacNativeGames (MIT). Resolution/render-pool sites credit v0lumehi/nxnative PR #76. The new state words avoid the existing render-scale and taller-screen fields.

Checked

  • BOTW 01007EF00011E000, v1114112 / 1.9.0, M4 Pro 48 GB, macOS 27.2.1. Manual tests used copied saves and a 1290x540 window matching 3440x1440's aspect ratio.
  • Exercised outdoor gameplay, inventory, System/Adventure Log transitions, map pan/zoom/recenter, Album, loading, and replay of memory 15 (Return of Calamity Ganon). The memory changed from stretched full-width playback to proportionate 16:9 playback. Map pins and terrain remained aligned in the tested views. This is visual validation, not a full-game guarantee or a controlled 60 FPS benchmark.
  • Camera/host-state tests, including zero defaults and movie suppression/resumption, passed. Pure layout tests: 47 checks passed. Targeted Python camera/patch/documentation tests: 10 passed with Capstone/Unicorn available.
  • Full graphics suite blocked by 10 argument-count errors in the untouched t_dlss_scaler.m; reproduced on pristine upstream 23790f8d.
  • Python lint reports dependency-sensitive Unicorn import findings in untouched files and baseline drift. C lint reports pre-existing/unrelated findings and baseline drift; the changed loader passes the focused check. These are not claimed green.
  • Full Python tools suite: 1,719 tests, one failure (test_env_switches, reproduced on pristine upstream), 16 skipped.
  • Initial full BOTW comparison flagged a frame-pacing REGRESSION: 59.9 → 59.2 FPS, p99 17.22 → 33.18 ms; no new RED errors and no lost shaders. The two-run repeat with a shared warmed archive did not reproduce the timing regression (baseline 59.2–59.3 FPS / ~33.2 ms p99; candidate 59.9 FPS / 17.21 ms p99), but still reports REGRESSION for a screenshot difference above its tolerance. The visual difference remains unresolved; this is not a green validation result.

Only BOTW is selected for runtime regression: only its verified build advertises the new capabilities; other games stay on the zero/default path. The impact report also names shared NVN entry points, so broader game coverage and iOS remain unchecked.

Front ends

Front-ends: expose DM_WIDESCREEN for CAMERA_ASPECT and DM_RENDER_RESOLUTION for RENDER_RESOLUTION on Mac. Both default to zero; resolution choices are 0/1080/1200/1440. The bundled settings UI supports both and keeps the HUD centered.

Docs

  • Findings, limits and local checks are recorded in dm/games/01007EF00011E000/README.md; settings and generated patch documentation are updated.
  • Shader chain unchanged; no chain-version bump.
  • No game files, keys, saves, extracted assets or diagnostic memory dumps are included.

Initial full regression report

regress.py check (full): REGRESSION

Baseline 23790f8d 23790f8, candidate worktree 23790f8 (+ uncommitted changes); Apple M4 Pro, macOS 27.2.1, Xcode 27.2; 617.2 s

game status shaders (base → cand) newly failing newly building changed MSL interface (new / known) boot fps p50 frame p99 ms peak MB prepare s new RED
The Legend of Zelda Breath of the Wild 01007EF00011E000 REGRESSION 19592/19592 → 19592/19592 0 0 0 0 / 0 ok 59.9 → 59.2 17.22 → 33.18 3130 → 3143 0.05 → 0.05 0

The Legend of Zelda Breath of the Wild 01007EF00011E000: REGRESSION

  • REGRESSION: frame p99 17.22 → 33.18 ms (+92.7 %)
  • CHANGED: screenshot at 60 s moved (RGB 6.04)
    • screenshots (s: dHash bits / RGB diff / baseline noise): 60: 9/6.04/0, 80: 9/5.42/0
    • baseline: exit None, first frame 2.1 s, max frame 6458, reached True, prepare 0.05 s, prebuild 187.2 s (15767 built, 0 failed), fps 59.9, p50/p99 16.66/17.22 ms, peak 3130 MB
    • candidate: exit None, first frame 1.3 s, max frame 6486, reached True, prepare 0.05 s, prebuild 177.5 s (15767 built, 0 failed), fps 59.2, p50/p99 16.66/33.18 ms, peak 3143 MB
    • time: chain 30.6 s, smoke 586.3 s

Warmed two-run comparison

The candidate is commit b5843287. Both revisions used the same warmed pipeline archive, with two 110-second runs each. This is a default-settings check, not a benchmark of the optional higher-resolution mode.

regress.py check (full): REGRESSION

Baseline 23790f8d 23790f8, candidate worktree b584328; Apple M4 Pro, macOS 27.2.1, Xcode 27.2; 462.8 s

game status shaders (base → cand) newly failing newly building changed MSL interface (new / known) boot fps p50 frame p99 ms peak MB prepare s new RED
The Legend of Zelda Breath of the Wild 01007EF00011E000 REGRESSION 19592/19592 → 19592/19592 0 0 0 0 / 0 ok 59.3 → 59.9 33.2 → 17.21 3103 → 3107 0.05 → 0.05 0

The Legend of Zelda Breath of the Wild 01007EF00011E000: REGRESSION

  • REGRESSION: screenshot at 60 s differs (dHash 13 bits, RGB 8.6)
  • CHANGED: screenshot at 80 s moved (RGB 9.14)
    • screenshots (s: dHash bits / RGB diff / baseline noise): 60: 13/8.6/4.12, 80: 11/9.14/2.39
    • baseline: exit None, first frame 1.3 s, max frame 6480, reached True, prepare 0.05 s, prebuild 1.6 s (0 built, 0 failed), fps 59.3, p50/p99 16.67/33.13 ms, peak 3103 MB
    • baseline: exit None, first frame 1.3 s, max frame 6481, reached True, prepare 0.05 s, prebuild 0.3 s (0 built, 0 failed), fps 59.2, p50/p99 16.67/33.2 ms, peak 3090 MB
    • candidate: exit None, first frame 1.3 s, max frame 6525, reached True, prepare 0.05 s, prebuild 0.3 s (0 built, 0 failed), fps 59.9, p50/p99 16.66/17.21 ms, peak 3107 MB
    • candidate: exit None, first frame 1.3 s, max frame 6523, reached True, prepare 0.05 s, prebuild 0.3 s (0 built, 0 failed), fps 59.9, p50/p99 16.67/17.21 ms, peak 3094 MB
    • time: chain 17.3 s, smoke 445.3 s

Keep the original aspect and resolution defaults, expose opt-in Mac widescreen and docked resolution settings, center the HUD, preserve decoded movie proportions, and keep textured map layers aligned with their markers. Inventory portraits and captured-menu transitions remain open.

Front-ends: expose DM_WIDESCREEN for CAMERA_ASPECT and DM_RENDER_RESOLUTION for RENDER_RESOLUTION, on Mac only; defaults are zero.
@github-actions github-actions Bot added host The Horizon host: SVCs, services, threads, memory (dm/host) nvn NVN on Metal and its tests (dm/gfx/nvn, dm/gfx/tests) rewriter The NSO rewriter and per-build patches ios The iPhone and iPad app (dm/ios) mac The Mac front end and app (dm/mac, front_mac.m) tools Tools and scripts (dm/tools, scripts) docs Documentation game: 01007EF00011E000 The Legend of Zelda: Breath of the Wild labels Nov 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation game: 01007EF00011E000 The Legend of Zelda: Breath of the Wild host The Horizon host: SVCs, services, threads, memory (dm/host) ios The iPhone and iPad app (dm/ios) mac The Mac front end and app (dm/mac, front_mac.m) nvn NVN on Metal and its tests (dm/gfx/nvn, dm/gfx/tests) rewriter The NSO rewriter and per-build patches tools Tools and scripts (dm/tools, scripts)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants