dtourolleandClaude Opus 5
0ff1e01ec3
Leaving develop returned to where the *grid* was, which after a walk along the photo roll can be a thousand rows from the frame you had just finished. So the one photograph you were certainly interested in was the one the grid came back without. Two positions, and the rule is not to pick one of them. The grid seeks to the remembered position, then reveals the keyboard cursor -- which is now put on the open photograph, and which moves the viewport as little as will bring its row into view. A frame inside the remembered screenful moves nothing at all; one outside it scrolls exactly far enough. One rule, both behaviours. The cursor rather than the selection, deliberately: `place_cursor` also rewrites the selection, and a set of forty photographs assembled in the grid must survive having one of them opened. `reveal()` now also runs on the grid's `init`, since `cursor-row` is initialised rather than changed when the subtree is rebuilt and no handler would otherwise fire. Both it and the roll's centring defer while the element has no height yet -- `init` runs before layout, where a height of zero makes every row look off screen -- and a latch brings the first real height back to the cursor without letting every later resize haul the viewport around. The capture-time marker follows the same move, for the same reason: `load_window` rebuilds the axis only when the scope, the filter or the total has changed, and none of them has. It is the same library seen from a different row. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
157 lines
6.8 KiB
Markdown
157 lines
6.8 KiB
Markdown
# How the application is driven
|
|
|
|
<!-- GENERATED FILE — do not edit by hand. -->
|
|
<!-- Regenerate: cargo run -p traceability -- gestures -->
|
|
|
|
Every entry here is extracted from the comment beside the code that implements it, so this file cannot describe a gesture the application does not have. Add one by writing a `GESTURE:` block next to the implementation; there is nowhere else to write it.
|
|
|
|
16 gestures, in 2 places.
|
|
|
|
## People
|
|
|
|
### Pull a face out of the wrong person
|
|
|
|
- **Touch** — Tap the faces that do not belong, then "Split off"
|
|
- **Pointer** — Click the faces that do not belong, then "Split off"
|
|
|
|
Grouping over-merges on siblings, on parents and children, and on the same person a decade apart, so splitting is as prominent as merging. A tool that can only merge makes its own errors permanent.
|
|
|
|
<sub>`ui/dr-ui/ui/identity.slint:130`</sub>
|
|
|
|
### Rule on a suggested face
|
|
|
|
- **Touch** — Tick to confirm it, cross to reject it
|
|
- **Pointer** — Tick to confirm it, cross to reject it
|
|
|
|
A face is either the system's guess or the user's judgement, and the two are never conflated. A rejection is remembered, so the face is not suggested for that person again. The gesture note above is the whole label: a tick and a cross are only "confirm" and "reject" to someone who can see the suggestion they sit beside, and `IconButton`'s fallback would announce them as "check" and "cross" — two icon names that say nothing about which person is being ruled on.
|
|
|
|
<sub>`ui/dr-ui/ui/identity.slint:150`</sub>
|
|
|
|
### See a person's photographs
|
|
|
|
- **Touch** — Choose them in the rail, then "Show photos"
|
|
- **Pointer** — Choose them in the rail, then "Show photos"
|
|
|
|
This is the point of having identified anybody. Without it the screen is a filing cabinet with no drawer handles.
|
|
|
|
<sub>`ui/dr-ui/ui/identity.slint:571`</sub>
|
|
|
|
### Change how faces are grouped
|
|
|
|
- **Touch** — "Grouping…", move the dials, then Regroup
|
|
- **Pointer** — "Grouping…", move the dials, then Regroup
|
|
|
|
The right match confidence is a property of your library, not of the model. "What would this do?" answers for this library without writing anything; names, confirmations and the groups you have set aside are kept whatever the dials say.
|
|
|
|
<sub>`ui/dr-ui/ui/identity.slint:608`</sub>
|
|
|
|
## Library grid
|
|
|
|
### Start selecting several photographs
|
|
|
|
- **Touch** — Press and hold a photograph, or press Select in the header
|
|
- **Pointer** — Ctrl-click, or press Select in the header
|
|
|
|
Touch has no ctrl, so without a mode there is no way to select a second photograph — the first tap would open it. The hold is the fast way in and the button is the one that can be found.
|
|
|
|
<sub>`ui/dr-ui/ui/library.slint:1218`</sub>
|
|
|
|
### Add or remove one photograph
|
|
|
|
- **Touch** — While selecting, tap it
|
|
- **Pointer** — Ctrl-click it
|
|
|
|
While selecting, a tap never opens. That is the whole point of the mode: one meaning per gesture at a time. Press Done to get tap-to-open back.
|
|
|
|
<sub>`ui/dr-ui/ui/library.slint:1227`</sub>
|
|
|
|
### Leave selecting
|
|
|
|
- **Touch** — Press Done in the header
|
|
- **Pointer** — Press Done in the header
|
|
- **Keyboard** — Escape
|
|
|
|
<sub>`ui/dr-ui/ui/library.slint:1235`</sub>
|
|
|
|
### Pick a photograph up to drag it
|
|
|
|
- **Touch** — Press and hold it until a ring opens around it, then drag
|
|
- **Pointer** — Drag it
|
|
|
|
A finger on a photograph might be starting a scroll, and for the first half-second the grid assumes it is. Holding says otherwise, and the ring is the grid saying it heard — from there the drag cannot be lost to a scroll. A mouse never waits: the cursor is precise enough that a sideways drag is unambiguous from the first pixel.
|
|
|
|
<sub>`ui/dr-ui/ui/library.slint:1265`</sub>
|
|
|
|
### Select a range
|
|
|
|
- **Touch** — While selecting, press "Select to…", then tap the last photograph of the run
|
|
- **Pointer** — Shift-click the last photograph of the run
|
|
|
|
This replaced a double tap, which had no visible state and could take forty photographs by accident. The run is resolved by the catalog rather than by what is on screen, so the grid can scroll between the two taps — the ranges that hurt on a tablet are longer than a screenful, which is exactly where a finger sweep runs out.
|
|
|
|
<sub>`ui/dr-ui/ui/library.slint:1330`</sub>
|
|
|
|
### Find photographs with two people in them
|
|
|
|
- **Touch** — Open the People chip on the filter bar, tap each name, then switch the chip beside them to "all of them"
|
|
- **Pointer** — Open the People chip on the filter bar, click each name, then switch the chip beside them to "all of them"
|
|
|
|
"Any of them" is a union and "all of them" is an intersection. The tray is where both terms and the choice between them live, because a filter belongs on the filter bar.
|
|
|
|
<sub>`ui/dr-ui/ui/library.slint:2012`</sub>
|
|
|
|
### Resize the thumbnails
|
|
|
|
- **Touch** — Pinch the grid with two fingers
|
|
- **Pointer** — Ctrl and the scroll wheel
|
|
|
|
There is no wheel on a tablet, so without the pinch the cell size could only be changed by a control a finger cannot reach.
|
|
|
|
<sub>`ui/dr-ui/ui/library.slint:2665`</sub>
|
|
|
|
### File photographs in a collection
|
|
|
|
- **Touch** — Drag a photograph — or a whole selection — onto a collection in the sidebar. Starting a drag stops the press becoming a hold, so it cannot leave you in selection mode.
|
|
- **Pointer** — Drag a photograph — or a whole selection — onto a collection in the sidebar
|
|
|
|
The selection is what the drag carries, which is why selecting several is worth the mode: forty photographs file in one gesture.
|
|
|
|
<sub>`ui/dr-ui/ui/library.slint:2862`</sub>
|
|
|
|
### Open a photograph
|
|
|
|
- **Touch** — Tap it — a single tap, any length
|
|
- **Pointer** — Click it
|
|
|
|
A tap opens; a tap that *moved* does not. Travel is what separates a deliberate tap from a hand brushing past, and it is the only thing that does: the two are the same length. An earlier version required the finger to dwell 120 ms instead, and that rejected ordinary taps — a real tap is often quicker than a brush.
|
|
|
|
<sub>`ui/dr-ui/ui/library.slint:3130`</sub>
|
|
|
|
### Rate a photograph without opening it
|
|
|
|
- **Touch** — Tap a star on the cell
|
|
- **Pointer** — Hover the cell, then click a star
|
|
- **Keyboard** — 0 to 5 on the selection
|
|
|
|
A star has to take the press without it also reaching the cell, or every rating throws the user into develop.
|
|
|
|
<sub>`ui/dr-ui/ui/library.slint:3250`</sub>
|
|
|
|
### Drop the selection but keep selecting
|
|
|
|
- **Touch** — Press Clear in the selection strip
|
|
- **Pointer** — Press Clear in the selection strip
|
|
|
|
Distinct from Done, which leaves the mode entirely. Clearing keeps it, so the next selection can start straight away.
|
|
|
|
<sub>`ui/dr-ui/ui/library.slint:3958`</sub>
|
|
|
|
### Select everything the grid is showing
|
|
|
|
- **Touch** — While selecting, press "Select all"
|
|
- **Pointer** — While selecting, press "Select all"
|
|
|
|
A scoped grid of two hundred frames is two hundred taps otherwise, and "all of them, except those three" is a far more common shape than the taps it took to say it.
|
|
|
|
<sub>`ui/dr-ui/ui/library.slint:3975`</sub>
|