[pmwork-personal]

The Graphics tab is one list of 24 settings, with the window, HDR, upscaling, frame generation and GPU options mixed
together, and about ten more are on their way in open PRs. This puts its rows under section titles, so the upscaler, frame
generation or HDR can be found without scrolling the whole list. It is the first step of a menu organization laid out below
for discussion.

What changed

• The Graphics rows in six sections, under heading rows like the Debug tab's Developer (a gold title, never selected,
  nothing to click):
  • Quality preset (first: it sets rows in every section)
  • Resolution and upscaling: Output resolution, Profile, Upscaler, DLSS model, Render resolution, Sharpness
  • Frame generation and latency: Frame generation, Frame pacing, Game frame rate cap, NVIDIA Reflex, AMD Anti-Lag 2
  • Screen: Fullscreen, V-Sync, Window scaling filter, Aspect ratio (feat(menu): the Aspect ratio row (was Ultrawide), at the monitor's shape by default #2119), Ultrawide menus
  • HDR: HDR, HDR paper white, HDR peak brightness, HDR contrast (feat(fsr4): FSR 4 for the game's native HDR, given linear light #2342), HDR tone mapper (feat(hdr): PsychoV35 scene tone mapper for Native HDR (RenoDX) #2481)
  • Detail: Anisotropic filtering
  • GPU and memory: GPU device, VRAM budget (feat(menu): a VRAM budget row of its own (builds on #1358) #1859), Mesh shaders (Robust buffers is on Debug ▸ Developer since fix: switches that behave as players expect, and dead ones removed #2042)
• Moves only: every row's definition is unchanged, word for word; no row is renamed and no value or saved key changes, so
  options files carry over, and feat: the Insert menu in 13 languages, with Game language and Menu la… #1864's tables (keyed by the English text) still find every row. They need the six
  headings.
• No new drawing or input code: the menu already draws heading rows on any tab, and the keys, the pad and the mouse step
  over them.
• readme.md: a sentence on the sections, and the option table in the new order. (Ultrawide menus and Mesh shaders have
  no line yet; docs(readme): the option table lists every row of the menu #2105 adds them.) The Frame generation by row from feat(dlss): DLSS Frame Generation through NGX, evenly paced at 3x and up #2118 gets its line in the table here too: main's
  readme has none yet. So do feat(menu): a VRAM budget row of its own (builds on #1358) #1859's VRAM budget (under GPU and memory) and feat(fsr4): FSR 4 for the game's native HDR, given linear light #2342's HDR contrast (under HDR).
• tests/test_upscaler_rows.py: its order list follows the picture's path (output, upscaler, render size, sharpening,
  then the frame rows, then the window). New tests/test_menu_sections.py: the Graphics sections and which rows they hold,
  and on every tab no section that row_shown could leave empty (a title over nothing on a GPU without Reflex, say).

The plan this is step 1 of (for discussion)

Each tab answers one question; a section groups the rows you set together; a row that depends on another follows it; vendor
rows sit beside their counterpart and hide where they can't run (no vendor sections, so nothing is left empty on AMD); rows
to touch only when something is wrong go last; moves only, no renames.

Tab	Holds	Sections
Game (was Gameplay; first, where the menu opens)	how the game behaves and reads, and Restart and Quit, as a pause menu	flat; Restart and Quit last
Graphics	how the picture is made, and what it costs	Quality preset · Resolution and upscaling · Frame generation and latency · Detail · GPU and memory
Display (new)	how it gets to your screen, and what is drawn over it	Screen · HDR · Overlays (FPS counter, Menu size, from Game)
Audio	sound out and in	+ Microphone (from Game: it picks the input device)
Controls	how you play	Camera · Controller · Buttons (optional)
Debug	tools and developer switches	Robust buffers in Developer (#2042, merged)

Next PRs, one topic each: (2) a Display tab, taking the Screen and HDR sections over whole and adding Overlays; (3) the
Gameplay tab titled Game, first in the strip, where the menu opens; (4) Microphone to Audio; (5) optional, sections on
Controls. If a sixth tab is a no, this PR stands on its own.

Open questions:

1. A sixth tab (Display)?
2. V-Sync on Display (the PC convention) or with frame generation (it changes with it)?
3. Sharpness with the upscaling rows (where players look for it) or with the window filter (where it runs)?
4. DLSS 5 (feat(vk): add experimental DLSS 5 Neural Rendering #1590) and feat: menu, renderer and build plumbing for #1831/#1833; upload hitches; lock diagnostics (builds with #1831, #1833) #1834's Neural rows as a page opened from a Graphics row, like Motion, rather than a seventh tab?

Where open PRs' rows would go

• Resolution and upscaling: Sharpening method (feat(vk): AMD CAS as a Sharpening method #1979), DLSS 5 page (feat(vk): add experimental DLSS 5 Neural Rendering #1590), Native 3D resolution (fixed like everything on the readme also added some stuff like loader.bat #2017)
• Frame generation and latency: Frame generation by (feat(dlss): DLSS Frame Generation through NGX, evenly paced at 3x and up #2118, merged: in this section now), Frame generation method (feat: menu, renderer and build plumbing for #1831/#1833; upload hitches; lock diagnostics (builds with #1831, #1833) #1834)
• Detail: Shadow resolution (feat(vk): shadow resolution option #1892), Screen filter and Filter strength (feat: screen filters (CRT, Scanlines, Film) in the Graphics tab, and the free camera hides the HUD #1488)
• GPU and memory: Texture streaming cache (fixed like everything on the readme also added some stuff like loader.bat #2017), Refresh memory (feat: Refresh memory in the Insert menu, and keep the game's memory in RAM #888); VRAM budget (feat(menu): a VRAM budget row of its own (builds on #1358) #1859, merged) is in this section now
• Game (was Gameplay): Game language and Menu language (feat: the Insert menu in 13 languages, with Game language and Menu la… #1864), Skip title screen (feat(menu): skip the title screen and load the newest save #1560), Amiibo (feat: virtual Amiibo scanning and the game's Amiibo rewards #1521)
• Controls: Camera speed (feat(input): Camera speed row for the right stick and the camera keys #1945)
• fix: switches that behave as players expect, and dead ones removed #2042 (merged) moved Robust buffers to Debug ▸ Developer.
• docs(readme): the option table lists every row of the menu #2105: its readme check would read the heading rows as rows; it needs to skip {TAB_..., "...", nullptr, 0, 0, 0, ..., true} headings, or this PR adds that if it lands first.

Whichever PR lands second moves one row on rebase; happy to do it for anyone.

Testing

• tests/run_all.py on Windows 11 (llvm-mingw clang, 8 at once) after merging main at 2dfe901 (with feat(menu): the Aspect ratio row (was Ultrawide), at the monitor's shape by default #2119's Aspect ratio, feat(hdr): PsychoV35 scene tone mapper for Native HDR (RenoDX) #2481's HDR tone mapper, feat(dlss): DLSS Frame Generation through NGX, evenly paced at 3x and up #2118's Frame generation by,
  feat(fsr4): FSR 4 for the game's native HDR, given linear light #2342's HDR contrast and feat(menu): a VRAM budget row of its own (builds on #1358) #1859's VRAM budget): 422 passed, 33 skipped, 2 failed, both outside this PR:
  test_vram_budget_row.py (fails the same on main's own sources here) and test_portable_builder_startup.py (its
  dotnet publish needs packages this PC does not have). A build of the branch compiles. All 81 of main's rows keep
  main's definitions word for word; the only additions are the six headings.
  test_menu_sections.py fails on main as it stands (no sections) and passes here; a layout with a section of Reflex and
  Anti-Lag 2 alone fails it.
• A build of this branch (Windows 11, RTX 5090), headless with scripted menu keys at Small, Medium and Large: 12 Downs
  from the Quality preset land on V-Sync and 13 Ups come back past it to the last row, so every heading is stepped over
  both ways and Up from the first row wraps to the last; the help box always shows the selected row (at the first head,
  when Robust buffers was the last row). Again at this head (25feb16, after fix: switches that behave as players expect, and dead ones removed #2042, feat(menu): a VRAM budget row of its own (builds on #1358) #1859 and feat(menu): the Aspect ratio row (was Ultrawide), at the monitor's shape by default #2119): Up from the Quality preset
  wraps to Mesh shaders, the last row now, under VRAM budget (the bottom screenshot).

Not tested: in a window with a pad, the mouse wheel and a click just under a heading (the headless runs drive
the keys); values kept across a restart (no row's saved key changes); AMD and Intel (their rows hide through row_shown as before; the new check makes sure no section can end up
empty), Linux.

Screenshots

The Graphics tab at 1920x1080, Medium menu size: the top, then scrolled with the keys to V-Sync and to the last row
(the selection steps over every heading; Up from the first row wraps to the last row). The bottom one is retaken at this
head (25feb16, a 16:9 picture: HOS_ASPECT=1.7778, as on a 16:9 monitor); the others are from the first head (634ef65).

Small and Large:

Taken from headless runs of this branch (HOS_HEADLESS=1, RX_VK_SHOT_MENU=1, the keys from RX_VK_MENU_SCRIPT), RTX
5090. Headless, the list never scrolls on main either: menu_record_image leaves ease_step at 0, so the build behind
the scrolled shots had one more line there (ease_step = 1.0f, hence "-dirty" in the first head's build label), not part of
this PR.
The windowed menu eases as before.

🤖 Generated with Claude Code

[Joey-Magnus]

Nice, careful change. I checked that it really is move-only: every row's definition is unchanged, and the six headings use the same heading form as the Debug tab's Developer row. Here's what I verified at this head:

• Saved options: heading rows have value == nullptr. save(), the loader and ini_key all skip value-less rows, so the heading titled "HDR" never collides with the HDR row's hdr key. No row's key changes.
• Mouse: draw_options hits continue for a heading before hits.add (gpu/vk/vk_menu.cpp:2081-2085), so a heading has no hit area. A click can't land on one, which matters because the kRow click path treats any value-less row as Enter. The keys step over headings both ways (heading_at, lines 3654-3667).
• Control bridge: bridge_row already excludes headings, so option_get/option_set don't list them.
• Tests: I ran all 52 checks that read vk_menu.cpp on Linux, including the new test_menu_sections.py and the updated test_upscaler_rows.py. All pass (two dotnet-only checks skipped). The rule that no section may consist only of rows row_shown can hide is a good guard for AMD and Intel.

What needs doing:

should fix — conflict with main: gpu/vk/vk_menu.cpp conflicts because #1859 has since added a VRAM budget row to Graphics. Your plan puts it under GPU and memory. Please add it to GRAPHICS in tests/test_menu_sections.py too, so the check pins where it goes, and give it a readme line in that section (main's readme doesn't list it yet either).

minor — description and screenshots are stale: the description lists Robust buffers under GPU and memory, the key test says "13 Ups come back past it to Robust buffers", and the third screenshot shows it as Graphics' last row. #2042 has since moved it to Debug ▸ Developer, and this head correctly has only GPU device and Mesh shaders there (plus VRAM budget after the rebase). Please retake the bottom screenshot after the rebase so reviewers see what will actually ship.

minor (pre-existing, optional): the readme table has no HDR contrast row on main or here. Since this PR rewrites that part of the table, it would be easy to add one under HDR. Fine to leave it for another PR.

On your open questions, my view only: keeping the sections on Graphics until a Display tab is agreed seems right, and this PR stands on its own either way.

[Joey-Magnus]

Rows are only moved. Headings have no value, so save, load, the control bridge and mouse hits skip them, and test_menu_sections, test_upscaler_rows, test_vram_budget_row and test_menu_keys pass merged into main. VRAM budget sits under GPU and memory as asked.

Before merge: the description and the third screenshot still show Robust buffers as Graphics' last row, but it moved to Debug in #2042.

Order with your other PRs: this one first, then #2178 and #2179 on top. #2119 renames the Ultrawide row this PR places by name, so #2119 should rebase onto this one.

[pmwork-personal]

Thanks. At 5714b34:

• Readme: VRAM budget has its line under GPU and memory (the row's own steps; 2.2 GB only from the Minimum preset), and HDR contrast its line under HDR.
• Description and screenshot: the bottom screenshot is retaken at this head (GPU device, VRAM budget, Mesh shaders, with Mesh shaders the last row), and the description no longer lists Robust buffers under GPU and memory. The top and middle shots are from the first head, as the description notes.

[pmwork-personal]

#2119 landed first, so I merged main into this (25feb16): the Screen section now has main's Aspect ratio row word for word, and #2481's HDR tone mapper is last in the HDR section. All 81 of main's rows keep main's definitions; the only additions are the six headings. test_menu_sections.py now also pins Profile, Aspect ratio, Ultrawide menus and HDR tone mapper in their sections. The bottom screenshot is retaken at this head, with Aspect ratio in Screen.