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:
1 parent
e4364c4f25
commit
8e55f60bbf
3 files changed
+223
-12
No files matched your search
+33
-5
@@ -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.
|
||||
Reference in new issue
Block a user