docs(ui): draw the visual crop, orientation, look and output size

Phase 4 of owner review 1 (R5/R6) gives P3 and P4 a visual target to check
against before they build the preview overlay and the step rows.

- Editor mockup: the Exposure step gains the Look group (Filter, Strength)
  with the look shown on the corrected side of the wipe; a Camera-step
  screen shows a 9:16 crop being edited on the whole view frame with its
  handles, the rows Aspect, Rotation (icon buttons and value), Mirror and
  Flip switches, Straighten, Crop size/X/Y, and Reset framing beside
  Optimise/Reset; a strip shows the overlay states (shown, editable,
  dragging with thirds, straightening grid, locked).
- Export mockup: Resolution is the preset's box and a new Output size row
  reads 2160 x 3840 for 4K at 9:16, the preview mask being the output
  footprint.
- DESIGN.md: setting-row kinds, the crop overlay states, hit-test order,
  cursors and keys, the orientation icons (never mirrored in RTL), and the
  screen notes; Camera is no longer a missing screen.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Alby96andClaude Opus 5.5 committed 2026-11-04 19:20:34 +01:00
1 parent e4364c4f25
commit 8e55f60bbf
3 files changed
+223 -12

No files matched your search

+33 -5
View File
@@ -2,7 +2,7 @@
Companion to `docs/BRIEF.md` §12 (UI spec). Suggested repo placement:
`docs/ui/DESIGN.md` (this file), `docs/ui/mockups/*.html` (open in any browser;
each file is one screen at its natural size, links between screens work), `branding/`
each file is one screen at its natural size, `Editor.html` two steps and the crop states one below the other; links between screens work), `branding/`
(icon sources). The mockups are the visual target; where a mockup and the brief disagree
on behaviour, the brief wins; where they disagree on looks, the mockup wins.
@@ -59,6 +59,31 @@ Label column left of controls: 116 px in panels, 180 px in Settings.
pill at the right whose tooltip gives the advisor's reason; touching it turns the track Sun
(manual), shows the value, and a `⟲` reset button returns to Auto. Not applicable = greyed
value "n/a" with the reason in its tooltip.
- **Setting rows** (side panels, label on the left, value or control on the right; owner review 1, R5/R6):
*number* = label, value in TextMuted with tabular figures, the slider on the line below (Straighten
−15…15° by 0.1, `−1.2°`; Crop size `85 %`, Crop X/Y `+0.40` · `Centred`); *switch* = label and a 36 × 20 switch at the
right (off = TextMuted outline and knob, on = Accent fill, OnAccent knob; `role="switch"`), one toggle is one
undo step; *icon actions* = label, the value (Rotation `90°`), then 28 px icon-only buttons (a quarter turn per press, as the user sees
the picture: the direction swaps while exactly one of Mirror and Flip is on); *info* = label
and a read-only value (Output size). A row that does not apply shows "n/a" in TextFaint with the reason in
its tooltip (Crop X when the crop fills the width, Strength when the filter is None). A **group** inside a
panel is a 1 px Stroke divider, then its name in Text.Body 600 with the group's tooltip (Look on Exposure).
- **Crop overlay** (preview, Camera step; owner review 1, R5): the box is drawn over the whole view frame (oriented,
straightened) and is always locked to the output aspect. States (tiles under the Camera screen in `Editor.html`):
- *Shown*: Crop mask on, any step: Scrim (#99000000 dark, #66000000 light) outside, 1 px TextMuted outline.
In "how it will look" mode the outside is hidden instead, as today; handles and outline still draw.
- *Editable*: Camera step, mask on (its default there) and the project editable: 1.5 px Accent outline and
8 handles (4 corners, 4 edge midpoints), 8 × 8 screen px whatever the zoom, Card fill, 1.5 px Accent stroke.
The preview tooltip becomes "Drag to move · drag a handle to resize…" (`Tooltips.Editor.Preview.CropEdit`).
- *Dragging*: rule-of-thirds lines inside the box (1 px Text at 50 %); only the overlay moves until mouse up,
which commits one undo step; Esc cancels. Corners anchor the opposite corner, edges the opposite edge
(centred on the other axis), Alt resizes about the centre; the minimum is 10 % of the largest box.
- *Straightening*: while the Straighten slider is dragged or focused, a fine 8 × 8 grid over the whole view
(1 px Text at 30 %).
- *Locked* (read-only, newer format, busy): drawn as Shown, no handles, drag pans.
Hit-test order: a handle within 6 screen px, the wipe divider, inside the box (move, SizeAll cursor), outside
(pan). Cursors SizeNWSE/SizeNESW on corners, SizeWE/SizeNS on edges. Keyboard with the preview focused:
arrows move 1 %, Shift+arrows 10 %, + and − resize 2 % about the centre. Double-click keeps Fit / 1:1.
- **Status glyphs**: `●` green Analysed · `○` faint Not analysed · `●` Proxies · `▶ n` rendered
· `●` accent Synced/Remote · `◐` amber Analysing · `▲ n` warnings · `✕ n` errors.
- **Chips**: 24 px pills, Card fill, Stroke border; selected/recommended = Accent border and text.
@@ -104,7 +129,10 @@ Category charts without a time axis (horizontal bars, stacked bars) still lay ou
their island: labels on the reading side, bars growing away from it; time axes and month grids never flip.
`branding/ui-icons/icons.py` is the one source: it writes `Icons.xaml` and the web admin's `icons.js`. Settings is a
toothed gear (8 teeth, outer radius 6.5, valleys on 4.6, centre hole 1.7: `gear()` in `icons.py`); a circle with rays
is the Sun icon only.
is the Sun icon only. The Camera step's orientation icons (owner review 1, R6): RotateLeft / RotateRight = a rounded
picture under a quarter-circle arrow (`turn_arrow()`), Mirror / Flip = an outline triangle and a filled one across a
dashed axis, Straighten = a tilted line over a level one with its angle arc. They describe the picture, not the
reading direction, so they never mirror in RTL.
## 6. App icon (`branding/`)
@@ -120,8 +148,8 @@ from the SVG geometry (no raster assets checked in as sources). Badges only at
| Mockup | Brief | Notes |
|---|---|---|
| `Main.html` | §12.2 Library | grid/list, year·camera·status filters, selection panel |
| `Editor.html` | §12.3 Edit | Exposure step: step bar, title ▾ (Change sequence), wipe compare, curves, advisor Auto pills, Previous · n / m · Next |
| `Export.html` | §12.3 / §11.4 | the Export step: step bar with Export current, preset cards with size/time estimate, Output panel, batch, Previous · 8 / 8 · Next sequence |
| `Editor.html` | §12.3 Edit | three parts, one below the other. Exposure step: step bar, title ▾ (Change sequence), wipe compare (the corrected side carries the look), curves, advisor Auto pills, the Look group (Filter, Strength) at the end of the panel, Previous · n / m · Next. Camera step (`#camera`): the whole view frame with a 9:16 crop being edited (handles), the zoom-keyframe curve under the filmstrip, rows Aspect · Rotation (Rotate left/right and the value) · Mirror · Flip · Straighten · Crop size · Crop X · Crop Y, the keyframes line, then Optimise section · Reset framing · Reset (Reset framing disabled, with `ResetFramingNone`, when nothing is set). Crop overlay states: Shown, Editable, Dragging, Straightening, Locked |
| `Export.html` | §12.3 / §11.4 | the Export step: step bar with Export current, preset cards with size/time estimate, Output panel, batch, Previous · 8 / 8 · Next sequence. Resolution edits the preset's box; the **Output size** row under it shows what is rendered: the chosen proportions fitted in the box (4K at 9:16 = 2160 × 3840; "source" keeps the preset), the preset name unchanged; when the encoder caps it, the value reads "1296 × 2304 (capped)" with `Tooltips.Editor.Export.OutputCapped`. The preview mask is the output's footprint in the view frame |
| `Import.html` | §12.4 / §13 | card profile, sessions, plan, verification, after-import actions |
| `Archive.html` | §12.5 | tree, mass operations, stats, verify/rebuild, maintenance |
| `Jobs.html` | §12.6 | filters, queue order, expandable log, retry/open/folder; a `Queue · Scheduled` segmented control first in the toolbar (owner review 2, R10): Scheduled is a table (on switch, name, action, when, next run, last result, Run now · Edit · Reset or Delete), the selected schedule's last runs under it (Show in queue), New schedule at the toolbar's end and the editor as an in-window dialog; jobs a schedule queued carry an Accent `Scheduled` pill after their target |
@@ -135,5 +163,5 @@ from the SVG geometry (no raster assets checked in as sources). Badges only at
| `Icon.html` | §17 | construction, sizes, variants, wordmark |
Missing on purpose (build from the brief and this kit): the Settings › About page, Login dialog, Jobs › Scheduled and its editor, the Edit picker
and the other steps (Analysis, Frames, Motion, Camera, Time, Stack), Import "Show plan",
and the other steps (Analysis, Frames, Motion, Time, Stack), Import "Show plan",
Archive rebuild dialog, the admin Archive/Jobs/Settings/Logs pages. Reuse the shell and the kit; do not invent new colours.