Files

T

dtourolleandClaude Opus 5 b34e786f01 Give the drag a pick-up, so it stops losing to the scroll

Dragging a photograph out of the grid worked about half the time, and
nothing on the screen explained the other half.

`DragArea` and `Flickable` do arbitrate, but not evenly. The Flickable
claims any press that travels more than eight pixels along its own axis
within half a second of landing, and holds that claim until the finger
lifts. So a drag toward the sidebar only ever began two ways: a flick
sideways clean enough that the finger never wandered eight pixels
vertically, or a wait of half a second before moving at all. Both are
real gestures and neither was written down.

The wait is now the gesture, and it has a mark. The long press that
already turns on selection mode also picks the photograph up: a ring
opens around the cell and the grid stops scrolling under it, so from
that moment the drag is the only thing the finger can be doing. The cue
can only arrive after the ambiguity has passed, which is the right way
round — when the photograph lifts, dragging it works.

Two details worth naming. The hold is now armed even when selection mode
is already on; it used to be skipped there, on the grounds that there
was no mode left to switch on — but that is precisely the state a
forty-image drag starts from, so the one gesture that most needed a
pick-up was the one with none. And the ring is drawn after the cell
loop rather than on the cell: z-order inside a `for` is loop order, so a
cell grown past its bounds would stand over two neighbours and be cut
off by the other two.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-08-30 13:20:56 +02:00

6.6 KiB

Raw Blame History

How the application is driven

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.

_{ui/dr-ui/ui/identity.slint:130}

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.

_{ui/dr-ui/ui/identity.slint:150}

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.

_{ui/dr-ui/ui/identity.slint:545}

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.

_{ui/dr-ui/ui/identity.slint:582}

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.

_{ui/dr-ui/ui/library.slint:1274}

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.

_{ui/dr-ui/ui/library.slint:1283}

Leave selecting

Touch — Press Done in the header
Pointer — Press Done in the header
Keyboard — Escape

_{ui/dr-ui/ui/library.slint:1291}

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.

_{ui/dr-ui/ui/library.slint:1321}

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.

_{ui/dr-ui/ui/library.slint:1386}

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.

_{ui/dr-ui/ui/library.slint:2141}

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.

_{ui/dr-ui/ui/library.slint:2783}

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.

_{ui/dr-ui/ui/library.slint:2942}

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.

_{ui/dr-ui/ui/library.slint:3210}

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.

_{ui/dr-ui/ui/library.slint:3330}

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.

_{ui/dr-ui/ui/library.slint:3938}

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.

_{ui/dr-ui/ui/library.slint:3955}

6.6 KiB Raw Blame History