Files
Nathan Dane 372136fa6a Preferences redesign 7/11: Graphics (#9879) (#10662)
* Preferences: keep Graphics redesign independent on current main

* Preferences: repair Graphics search targets and CI regressions
2026-11-03 13:27:19 +00:00

8.1 KiB

Graphics

Board: Prefs2_Graphics (1920x1821). Heading: Look. Subtitle "Trade speed for smoothness." No "In profile" tag: the Graphics page stays on this computer (see README). Source today: Graphics page (prefs/graphics.rs).

Preset

Label Control Edits Default Hover Figure Notes
Performance "Fastest", Quality "Sharpest", Custom "Your own mix" Three preset cards (204 x 69.5) command view.graphics_preset with {"preset":"performance"} or "quality"; the selection is derived from the settings by graphics_preset(&prefs), Custom when neither matches derived Today's tooltip ui.graphics_preset_help: "Quality: ambient occlusion, Fine display quality and adaptive 2x supersampling. Performance: no ambient occlusion, Normal display quality and supersampling off. Manual changes show Custom. MSAA stays unchanged." The board shows no hover; keep the existing text on the card group. preset glyphs drawn as strokes: a bolt (Performance), a gem (Quality), three sliders (Custom) The board shows no meters. Custom cannot be chosen to set values: choosing it changes nothing. Only these three exist ("Balanced" in an earlier board does not).

Curved surfaces

Label Control Edits Default Hover Figure Notes
Coarse "fastest", Normal "default", Fine "smoother", Ultra "slowest" Four picture cards (130 wide, 117 high) Prefs.display_quality (string ids; "normal" is the default and "ultra" is accepted, see prefs/graphics.rs for the full list) "normal" none tess-coarse, tess-normal, tess-fine, tess-ultra The figure shows a polygon on a circle with 8, 16, 32 and 64 segments (the corner caption of each figure). The caption number in tess-normal ("16") is part of the figure.

Edges and shading

Label Control Edits Default Hover Figure Notes
Anti-aliasing + badge "Restart needed" Four picture cards: Off, 2x, 4x, 8x ("not on this GPU") Prefs.msaa (1, 2, 4, 8) 4 tooltip on the cards: settings.msaa_applies_on_restart (the restart note) aa-off, aa-2x, aa-4x, aa-8x Each figure is an edge on a pixel grid, shaded by that level's sample count (2, 3, 5 and 9 tones) with the sample dots of one pixel in the corner; all four have the same strength. A level the adapter lacks (app.msaa_supported) is disabled with the badge "not on this GPU". Changing it applies on restart.
Supersampling Segmented: Off / 1.5x / 2x Prefs.supersampling (1.0, 1.5, 2.0) 1.0 (Off) settings.supersampling_note none
Only while the view is still Checkbox Prefs.supersampling_adaptive true none none Disabled while Supersampling is Off (supersampling > 1.0).
Keep the shape of dark parts Checkbox Prefs.dark_parts_shading false Existing prefs.dark_parts_shading_help none Retain the current control once, as the final Edges and shading row after Supersampling and its adaptive checkbox. Accepted reference-gap resolution on #9879.

Current view (with the badge "Also in the view bar")

Four toggle tiles (155.6 wide). These are the view toggles that also sit in the view bar.

Label Control Edits Default Hover Figure Notes
Grid Toggle tile app.ui.show_grid (session; in the Snapshot) per session none view-grid
Ground shadow Toggle tile app.ui.ground_shadow per session none view-shadow
Perspective Toggle tile app.ui.perspective per session none view-perspective
Ambient occlusion Toggle tile (moves here from Edges and shading) Prefs.ambient_occlusion false none ao-on
Visual style Dropdown (240 x 30) with the style icon: "Shaded with edges" app.ui.visual_style (0..3: shaded with edges, shaded, wireframe, hidden edges) 0 none style-shaded-edges (icon shape; use the app's style_shaded_edges, style_shaded, style_wireframe, style_hidden_edges) aria-label "Visual style".
Field of view Slider with "34 degrees" readout (44 px column) Prefs.perspective_fov in radians (accepted 15 to 90 degrees) 0.6 rad (34.4 degrees) none none aria-label "Field of view".

In the view

Four toggle tiles, then a chip row.

Label Control Edits Default Hover Figure Notes
View angles Toggle tile Prefs.show_view_angles false none view-angles
Vertex markers Toggle tile Prefs.vertex_markers false none vertex-markers
Quick measurement Toggle tile Prefs.quick_measure (today on the Interface page) false none quick-measure Moves here.
Frame rate Toggle tile Prefs.show_frame_rate false none frame-rate
Frame rate details Checkbox Prefs.frame_rate_details false Existing settings.frame_rate_details_note none Retain the current control directly below the four-tile row containing Frame rate and before the status chips. Always visible; disabled while show_frame_rate is false, retaining its stored value. Accepted reference-gap resolution on #9879.
Status chips: Analysis, Section, Live details, Fold items Four small chips (the row is labelled "Status chips") Prefs.viewport_analysis_status, Prefs.viewport_section_status, Prefs.viewport_status_details, Prefs.viewport_status_summary all true none none Mapping by catalog label: "Live details" is viewport_status_details ("Live viewport details") and "Fold items" is viewport_status_summary ("Fold viewport status items"). These four move here from Interface.

Surfaces and edges

Label Control Edits Default Hover Figure Notes
Cosmetic thread markings Checkbox Prefs.cosmetic_threads false none none
Halo under sketch curves Checkbox Prefs.sketch_halo false none none
Reference geometry through bodies Checkbox Prefs.reference_geometry_through_bodies false none none
Grid follows the view Checkbox Prefs.grid_follows_view (no page id in the table today) false "Side views show the grid on the facing plane." none
Single surface analysis Checkbox Prefs.single_surface_analysis true "Shading and Continuity share one analysis." none

This computer

Label Control Edits Default Hover Figure Notes
Apple M2 / Metal . GPU renderer One grey card: a device header (monitor tile, adapter name, "backend · GPU renderer" in mono, a GPU badge) with the rows below it inside the card, checkbox included none (from the renderer) n/a none none Sample values.
Graphics card + badge "Restart needed" Dropdown (240 wide, "Automatic") Prefs.graphics_adapter (empty = automatic) empty none none aria-label "Graphics card".
Window system Dropdown (240 wide, "Automatic") with "Linux" badge Prefs.window_system ("auto") "auto" none none The "Linux" badge says the choice is for Linux only; hide the row elsewhere. aria-label "Window system".
Use previous Render preview geometry budget Checkbox Prefs.render_previous_geometry_budget false "Restores the earlier fixed budget." none

Mismatches

  • "Axis distances in Measure" (Prefs.measure_axis_distances) leaves this page for Tools.
  • The board omits dark_parts_shading and frame_rate_details. Retain their current controls, labels, help, defaults and behavior in the adjacent locations recorded above; absence from the board does not remove a current setting.
  • Keep main's newer controls: Profile operations follows Frame rate details; Section hatch and both preview-tint checkboxes follow Halo under sketch curves. Their defaults, help text, persistence and page reset behaviour stay unchanged.
  • Renderer and window system rows come from the old page's "Renderer" block. When the adapter has no name, the device header uses "Renderer" as its title.
  • The tracker's "Edges and shading" note says Ambient occlusion moves to Current view; the code still lists it under Graphics with PAGE_GRAPHICS.