dtourolle/DarkRoom
1
0
Fork 0
Code Issues 39 Pull Requests Actions Packages Projects Releases 20 Wiki Activity

Link fifty gestures on the help sheet to the manual section that shows them

Browse Source 
The sheet could now offer "See it", but no gesture said where to look.

Every GESTURE tag whose move the manual describes names that section:
the white-balance picker, zoom and pan, masks, undo and snapshots,
export, colour labels and ratings, selection, collections, the People
page, thumbnail size. Fifty of the fifty-one; the one left, putting a
single control back to its default, has no section and is too small to
earn one.

Three important gestures had nowhere to land, so the manual gains three
short sections, without pictures for now: Bursts (opening a folded
burst, choosing the frame it shows, and the eyes-open filter), Moving
between photographs (the roll, the arrows and A/D in develop) and
Copying settings (Copy, Paste, Paste to N, and choosing what a copy
carries). The page, the gesture book and docs/gestures.md are
regenerated from them.
This commit is contained in:
dtourolle
2026-09-24 23:25:37 -04:00
parent 7591738c73
commit 150e53e878
12 changed files with 276 additions and 128 deletions
Download Patch File Download Diff File Expand all files Collapse all files
ui/dr-ui/src/gesture_book.rs
+50 -50
View File
@@ -30,7 +30,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Press \"pick\" in the group's heading, then tap something neutral in the picture",
pointer: "Press \"pick\", then click something neutral",
keys: "",
manual: "",
manual: "white-balance-from-the-photograph",
},
Gesture {
title: "Magnify the photograph by any amount",
@@ -38,7 +38,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Pinch it with two fingers",
pointer: "The scroll wheel over it",
keys: "",
manual: "",
manual: "looking-closer",
},
Gesture {
title: "Move a magnified photograph about",
@@ -46,7 +46,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Drag it",
pointer: "Drag it",
keys: "",
manual: "",
manual: "looking-closer",
},
Gesture {
title: "Paint a mask by hand",
@@ -54,7 +54,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Choose Paint or Erase, then drag on the photograph",
pointer: "Choose Paint or Erase, then drag",
keys: "",
manual: "",
manual: "local-adjustments",
},
Gesture {
title: "Take back the last change",
@@ -62,7 +62,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Tap the step above the current one in the History list",
pointer: "Click it, or press Undo in the History header",
keys: "Ctrl+Z",
manual: "",
manual: "history-snapshots-presets",
},
Gesture {
title: "Do it again after taking it back",
@@ -70,7 +70,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Tap the step below the current one in the History list",
pointer: "Click it, or press Redo in the History header",
keys: "Ctrl+Shift+Z",
manual: "",
manual: "history-snapshots-presets",
},
Gesture {
title: "Copy the settings from this photograph",
@@ -78,7 +78,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Press Copy in the top bar",
pointer: "Press Copy in the top bar",
keys: "Ctrl+C",
manual: "",
manual: "copying-settings",
},
Gesture {
title: "Paste the settings onto this photograph",
@@ -86,7 +86,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Press Paste in the top bar",
pointer: "Press Paste in the top bar",
keys: "Ctrl+V",
manual: "",
manual: "copying-settings",
},
Gesture {
title: "Choose which kinds of edit a copy carries",
@@ -94,7 +94,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Open Presets and toggle the kinds",
pointer: "Open Presets and toggle the kinds",
keys: "Ctrl+Shift+C, which offers Copy beside them",
manual: "",
manual: "copying-settings",
},
Gesture {
title: "Export this photograph as the last one was",
@@ -102,7 +102,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Press Export in the top bar",
pointer: "Press Export in the top bar",
keys: "Ctrl+Shift+E",
manual: "",
manual: "export",
},
Gesture {
title: "Choose how to export, then export",
@@ -110,7 +110,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Open Settings, then Export defaults",
pointer: "Open Settings, then Export defaults",
keys: "Ctrl+E",
manual: "",
manual: "export",
},
Gesture {
title: "Change which group of adjustments is on screen",
@@ -118,7 +118,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Tap a group in the rail down the left",
pointer: "Click a group in the strip above the develop column",
keys: "[ and ] step through them, wrapping round through \"everything\"",
manual: "",
manual: "developing-a-photograph",
},
Gesture {
title: "Look at the photograph at 1:1",
@@ -126,7 +126,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Double-tap the photograph",
pointer: "Double-click it, or press the zoom readout floating over the canvas",
keys: "Z",
manual: "",
manual: "looking-closer",
},
Gesture {
title: "Give this photograph a colour label",
@@ -134,7 +134,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Tap Label in the top bar, then a colour",
pointer: "Click Label in the top bar, then a colour",
keys: "6 red, 7 yellow, 8 green, 9 blue; the same key again takes it off",
manual: "",
manual: "rating-and-flagging",
},
Gesture {
title: "Move to the next or previous photograph",
@@ -142,7 +142,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Tap a frame in the roll along the foot of the canvas",
pointer: "Click a frame in the roll",
keys: "Right arrow, D or space for the next; left arrow or A for the one before",
manual: "",
manual: "moving-between-photographs",
},
Gesture {
title: "See the photograph before you edited it",
@@ -150,7 +150,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Press and hold \"Before\"",
pointer: "Press and hold \"Before\"",
keys: "Hold \\",
manual: "",
manual: "light",
},
Gesture {
title: "Put one control back to its default",
@@ -166,7 +166,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Press and hold the eye beside the snapshot",
pointer: "Press and hold the eye beside the snapshot",
keys: "",
manual: "",
manual: "history-snapshots-presets",
},
Gesture {
title: "Keep the photograph as it is now, under a name",
@@ -174,7 +174,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Type a name in the History panel and press Snapshot",
pointer: "Type a name in the History panel and press Snapshot",
keys: "",
manual: "",
manual: "history-snapshots-presets",
},
Gesture {
title: "Show or hide one mask layer",
@@ -182,7 +182,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Tap the ring at the head of its row",
pointer: "Click the ring at the head of its row",
keys: "H, for the selected layer history step, unlike holding \"Before\" — the layer really is off until it is switched back on.",
manual: "",
manual: "local-adjustments",
},
Gesture {
title: "Show or hide one mask on the photograph",
@@ -190,7 +190,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Tap the eye on its row",
pointer: "Click the eye on its row",
keys: "",
manual: "",
manual: "local-adjustments",
},
Gesture {
title: "Change how a part joins its mask",
@@ -198,7 +198,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Tap the + / − / ∩ chip on the part's row",
pointer: "Click the + / − / ∩ chip on the part's row",
keys: "",
manual: "",
manual: "local-adjustments",
},
Gesture {
title: "Leave one part out of a mask, and put it back",
@@ -206,7 +206,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Tap the ring on the part's row",
pointer: "Click the ring on the part's row",
keys: "",
manual: "",
manual: "local-adjustments",
},
Gesture {
title: "Pick a collection up to rearrange the tree",
@@ -214,7 +214,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Press and hold it until it lifts, then drag it",
pointer: "Drag it, or hold it until it lifts and then drag",
keys: "",
manual: "",
manual: "collections",
},
Gesture {
title: "Act on a collection — rename, nest, un-nest, delete",
@@ -222,7 +222,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Press and hold the collection, then let go without moving",
pointer: "Right-click it",
keys: "",
manual: "",
manual: "collections",
},
Gesture {
title: "Take a collection back out of the one it is nested in",
@@ -230,7 +230,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Hold it, then drag it onto \"All photographs\" — or let go and choose \"Move to top level\"",
pointer: "Drag it onto \"All photographs\", or right-click it and choose \"Move to top level\"",
keys: "",
manual: "",
manual: "collections",
},
Gesture {
title: "Rename a collection",
@@ -238,7 +238,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Hold the collection, then \"Rename\"",
pointer: "Double-click its name, or right-click it and choose \"Rename\"",
keys: "",
manual: "",
manual: "collections",
},
Gesture {
title: "Pull a face out of the wrong person",
@@ -246,7 +246,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Tap the faces that do not belong, then \"Split off\"",
pointer: "Click the faces that do not belong, then \"Split off\"",
keys: "",
manual: "",
manual: "people",
},
Gesture {
title: "Rule on a suggested face",
@@ -254,7 +254,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Tick to confirm it, cross to reject it",
pointer: "Tick to confirm it, cross to reject it",
keys: "",
manual: "",
manual: "people",
},
Gesture {
title: "See a person's photographs",
@@ -262,7 +262,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Choose them in the rail, then \"Show photos\"",
pointer: "Choose them in the rail, then \"Show photos\"",
keys: "",
manual: "",
manual: "people",
},
Gesture {
title: "Change how faces are grouped",
@@ -270,7 +270,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "\"Grouping…\", move the dials, then Regroup",
pointer: "\"Grouping…\", move the dials, then Regroup",
keys: "",
manual: "",
manual: "people",
},
Gesture {
title: "Start selecting several photographs",
@@ -278,7 +278,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Press and hold a photograph, or press Select in the header",
pointer: "Ctrl-click, or press Select in the header",
keys: "",
manual: "",
manual: "selecting-several",
},
Gesture {
title: "Add or remove one photograph",
@@ -286,7 +286,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "While selecting, tap it",
pointer: "Ctrl-click it",
keys: "",
manual: "",
manual: "selecting-several",
},
Gesture {
title: "Leave selecting",
@@ -294,7 +294,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Press Done in the header",
pointer: "Press Done in the header",
keys: "Escape",
manual: "",
manual: "selecting-several",
},
Gesture {
title: "Pick a photograph up to drag it",
@@ -302,7 +302,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Press and hold it until a ring opens around it, then drag",
pointer: "Drag it",
keys: "",
manual: "",
manual: "collections",
},
Gesture {
title: "Select a range",
@@ -310,7 +310,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "While selecting, press \"Select to…\", then tap the last photograph of the run",
pointer: "Shift-click the last photograph of the run",
keys: "",
manual: "",
manual: "selecting-several",
},
Gesture {
title: "Take the blinks out of a burst",
@@ -318,7 +318,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Narrow to a person, then tap \"Eyes open\" beside their name on the filter bar",
pointer: "Narrow to a person, then click \"Eyes open\" beside their name on the filter bar",
keys: "",
manual: "",
manual: "bursts",
},
Gesture {
title: "Find photographs with two people in them",
@@ -326,7 +326,7 @@ pub const GESTURES: &[Gesture] = &[
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\"",
keys: "",
manual: "",
manual: "people",
},
Gesture {
title: "Show only photographs with one colour label",
@@ -334,7 +334,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Tap its chip in the filter bar",
pointer: "Click its chip in the filter bar",
keys: "",
manual: "",
manual: "rating-and-flagging",
},
Gesture {
title: "Export the selection as the last export was",
@@ -342,7 +342,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Select them, then Export in the selection bar",
pointer: "Select them, then Export in the selection bar",
keys: "Ctrl+Shift+E, or Ctrl+E to see the export settings first",
manual: "",
manual: "export",
},
Gesture {
title: "Paste copied settings onto the selection",
@@ -350,7 +350,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Select them, then \"Paste to N\" in the selection bar",
pointer: "Select them, then \"Paste to N\"",
keys: "Ctrl+V",
manual: "",
manual: "copying-settings",
},
Gesture {
title: "Show only photographs with some number of stars",
@@ -358,7 +358,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Tap a star chip in the filter bar",
pointer: "Click a star chip in the filter bar",
keys: "Hold F and tap a digit for exactly that many stars, or two digits for everything between them; tap F alone to show every rating again",
manual: "",
manual: "rating-and-flagging",
},
Gesture {
title: "Give photographs a colour label",
@@ -366,7 +366,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Select them, then Label in the selection bar and tap a colour",
pointer: "Select them, then Label in the selection bar and click a colour",
keys: "6 red, 7 yellow, 8 green, 9 blue, with the pointer over it or on the selection; the same key again takes the label off",
manual: "",
manual: "rating-and-flagging",
},
Gesture {
title: "Resize the thumbnails",
@@ -374,7 +374,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Pinch the grid with two fingers",
pointer: "Ctrl and the scroll wheel",
keys: "",
manual: "",
manual: "getting-about",
},
Gesture {
title: "File photographs in a collection",
@@ -382,7 +382,7 @@ pub const GESTURES: &[Gesture] = &[
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",
keys: "",
manual: "",
manual: "collections",
},
Gesture {
title: "Open a photograph",
@@ -390,7 +390,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Tap it — a single tap, any length",
pointer: "Click it",
keys: "",
manual: "",
manual: "developing-a-photograph",
},
Gesture {
title: "Rate a photograph without opening it",
@@ -398,7 +398,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Tap a star on the cell",
pointer: "Hover the cell, then click a star",
keys: "0 to 5 with the pointer over it, or on the selection",
manual: "",
manual: "rating-and-flagging",
},
Gesture {
title: "Choose the frame a folded burst shows",
@@ -406,7 +406,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Open the burst, then tap the ring on the frame you want",
pointer: "Open the burst, then click the ring on the frame you want",
keys: "",
manual: "",
manual: "bursts",
},
Gesture {
title: "Drop the selection but keep selecting",
@@ -414,7 +414,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "Press Clear in the selection strip",
pointer: "Press Clear in the selection strip",
keys: "",
manual: "",
manual: "selecting-several",
},
Gesture {
title: "Select everything the grid is showing",
@@ -422,7 +422,7 @@ pub const GESTURES: &[Gesture] = &[
touch: "While selecting, press \"Select all\"",
pointer: "While selecting, press \"Select all\"",
keys: "Ctrl+A",
manual: "",
manual: "selecting-several",
},
Gesture {
title: "Take photographs out of a collection",
@@ -430,6 +430,6 @@ pub const GESTURES: &[Gesture] = &[
touch: "Select them, then \"Collections…\" in the selection bar",
pointer: "Select them, then \"Collections…\" in the selection bar",
keys: "",
manual: "",
manual: "collections",
},
];
ui/dr-ui/ui/adjust.slint
+1
View File
@@ -167,6 +167,7 @@ component GroupHeading inherits Rectangle {
// One click is one sample and one step to undo; the sliders
// stay, because a sampled neutral is where the decision
// starts rather than where it ends.
// manual: white-balance-from-the-photograph
//
// TRACES: FR-DEV-3 | NFR-A11Y-2
// The eyedropper, built exactly as the reset beside it is: a word, a
ui/dr-ui/ui/app.slint
+15
View File
@@ -1788,6 +1788,7 @@ in property <bool> panel-visible: true;
// is the way to everything in between. Past
// 1:1 the pixels are shown as they are, square
// and unsmoothed; below it, filtered.
// manual: looking-closer
//
// TRACES: FR-UI-4
// Pinch to zoom. The wheel gesture below is the desktop's
@@ -1882,6 +1883,7 @@ in property <bool> panel-visible: true;
// beside the photograph, and that reads as
// a rendering fault rather than as the end
// of the picture.
// manual: looking-closer
moved => {
if (self.pressed && root.zoomed) {
// Fractions of the *visible* area, which is what
@@ -1968,6 +1970,7 @@ in property <bool> panel-visible: true;
// ways. The whole stroke is one step in the
// history, so taking a mark back costs one
// press however long it took to make.
// manual: local-adjustments
//
// TRACES: FR-DEV-19b
//
@@ -2200,6 +2203,7 @@ in property <bool> panel-visible: true;
// frame of a gesture. The list is there
// because arriving six steps back costs
// what arriving from one does.
// manual: history-snapshots-presets
//
// GESTURE: Do it again after taking it back
// where: Develop
@@ -2208,6 +2212,7 @@ in property <bool> panel-visible: true;
// pointer: Click it, or press Redo in the
// History header
// keys: Ctrl+Shift+Z
// manual: history-snapshots-presets
//
// Ctrl+Z and Ctrl+Shift+Z (FR-DEV-5). Both cases
// of the letter, because the logical key that
@@ -2245,6 +2250,7 @@ in property <bool> panel-visible: true;
// action from. The shortcut is an
// accelerator for a control that is on
// screen either way.
// manual: copying-settings
//
// GESTURE: Paste the settings onto this photograph
// where: Develop
@@ -2256,6 +2262,7 @@ in property <bool> panel-visible: true;
// whether the crop is coming with it —
// which the shortcut cannot say. Both
// paste the same scope.
// manual: copying-settings
//
// TRACES: FR-DEV-6
// The desktop accelerators for the Copy and Paste
@@ -2274,6 +2281,7 @@ in property <bool> panel-visible: true;
// leaving each frame's crop and
// rotation alone, and that is a choice
// to make at the moment of copying.
// manual: copying-settings
//
// Shift first: the logical key is "C" under shift,
// which the plain copy below would otherwise take.
@@ -2303,6 +2311,7 @@ in property <bool> panel-visible: true;
// chord is Lightroom's and darktable's,
// kept so hands that learned it there
// need not learn it again.
// manual: export
//
// GESTURE: Choose how to export, then export
// where: Develop
@@ -2314,6 +2323,7 @@ in property <bool> panel-visible: true;
// What is chosen there is kept, so it
// is also what the next Ctrl+Shift+E
// uses.
// manual: export
//
// TRACES: FR-UI-5 | FR-EXP-7
// Both cases of the letter, as for Z: holding
@@ -2342,6 +2352,7 @@ in property <bool> panel-visible: true;
// and no key can be assigned to one of
// them by name. Stepping is the binding
// that survives a node being added.
// manual: developing-a-photograph
//
// TRACES: FR-DEV-3a | FR-UI-5
// -1 is "everything" and is part of the cycle
@@ -2385,6 +2396,7 @@ in property <bool> panel-visible: true;
// the photograph is drawn as its own
// pixels, each a hard-edged square,
// rather than smoothed into a blur.
// manual: looking-closer
//
// TRACES: FR-UI-4 | FR-UI-5
// Fit and 1:1 from the keyboard, so inspecting
@@ -2432,6 +2444,7 @@ in property <bool> panel-visible: true;
// stepping through a folder is one
// hand's work. The bar names the label
// in words beside its mark.
// manual: rating-and-flagging
//
// TRACES: FR-CAT-5 | FR-UI-5 | NFR-A11Y-3
// Only with a library: a file named on the command
@@ -2460,6 +2473,7 @@ in property <bool> panel-visible: true;
// steps along the roll while the right stays on
// the mouse. Unmodified only: Ctrl+D and Ctrl+A
// are not this.
// manual: moving-between-photographs
if (event.text == Key.RightArrow || event.text == " "
|| (!event.modifiers.control
&& (event.text == "d" || event.text == "D"))) {
@@ -2590,6 +2604,7 @@ in property <bool> panel-visible: true;
// takes no history step, so checking
// whether a frame is overcooked costs
// nothing to undo afterwards.
// manual: light
//
// TRACES: FR-DEV-7 | FR-DEV-3b | NFR-A11Y-2
// The unedited original, for as long as it is held.
ui/dr-ui/ui/collections.slint
+4
View File
@@ -342,6 +342,7 @@ component TreeRow inherits Rectangle {
// something, and it is what every mobile list already uses to
// pick a row up. The row lifts the moment it fires, so the
// gesture says it has been understood before anything moves.
// manual: collections
//
// GESTURE: Act on a collection — rename, nest, un-nest, delete
// where: Collections sidebar
@@ -352,6 +353,7 @@ component TreeRow inherits Rectangle {
// uses. One menu for everything done to a row, because there is
// one hold per row: while the hold opened the offline question
// by itself, nothing else the tree can do had a touch route.
// manual: collections
//
// GESTURE: Take a collection back out of the one it is nested in
// where: Collections sidebar
@@ -365,6 +367,7 @@ component TreeRow inherits Rectangle {
// library — and wrong for a collection, which has a top level
// to be returned to. Without it a collection dragged into
// another was in there permanently.
// manual: collections
//
// GESTURE: Rename a collection
// where: Collections sidebar
@@ -373,6 +376,7 @@ component TreeRow inherits Rectangle {
// why: Double-click is what a file manager and a Lightroom panel use
// for the same thing, so it needs no discovering — but nothing
// on screen says so, which is what the menu item is for.
// manual: collections
touch := TouchArea {
// Disabled while the field is up, so a click landing on the row rather
// than inside the input does not re-select the collection out from
ui/dr-ui/ui/history.slint
+2
View File
@@ -98,6 +98,7 @@ component SnapshotItem inherits Rectangle {
// I liked twenty minutes ago" is how a choice between two
// treatments is actually made. It takes no history step
// and changes nothing; letting go puts the edit back.
// manual: history-snapshots-presets
//
// TRACES: FR-DEV-7
eye := TouchArea {
@@ -314,6 +315,7 @@ export component HistoryPanel inherits Rectangle {
// of the edit, so it survives a restart and reaches the
// other device. Pressing a snapshot puts the photograph
// back to it, as one step that undo takes back whole.
// manual: history-snapshots-presets
if Develop.enabled: HorizontalLayout {
spacing: Theme.gap-sm;
ui/dr-ui/ui/identity.slint
+4
View File
@@ -193,6 +193,7 @@ component FaceCell inherits Rectangle {
// 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.
// manual: people
TouchArea {
clicked => { root.toggle-pick(); }
}
@@ -218,6 +219,7 @@ component FaceCell inherits Rectangle {
// 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.
// manual: people
if !face.confirmed: IconButton {
icon: "check";
label: "Confirm this face";
@@ -639,6 +641,7 @@ export component IdentityScreen inherits Rectangle {
// why: This is the point of having identified anybody.
// Without it the screen is a filing cabinet with no
// drawer handles.
// manual: people
if root.selected-person >= 0: Button {
text: "Show photos";
clicked => { root.show-photos(root.selected-person, false); }
@@ -678,6 +681,7 @@ export component IdentityScreen inherits Rectangle {
// answers for this library without writing
// anything; names, confirmations and the groups you
// have set aside are kept whatever the dials say.
// manual: people
Button {
text: "Grouping…";
active: root.grouping-open;
ui/dr-ui/ui/library.slint
+20
View File
@@ -1634,6 +1634,7 @@ export component LibraryGrid inherits Rectangle {
// 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.
// manual: selecting-several
//
// GESTURE: Add or remove one photograph
// where: Library grid
@@ -1642,12 +1643,14 @@ export component LibraryGrid inherits Rectangle {
// why: 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.
// manual: selecting-several
//
// GESTURE: Leave selecting
// where: Library grid
// touch: Press Done in the header
// pointer: Press Done in the header
// keys: Escape
// manual: selecting-several
in property <bool> select-mode: false;
callback toggle-select-mode();
@@ -1683,6 +1686,7 @@ export component LibraryGrid inherits Rectangle {
// 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.
// manual: collections
in-out property <int> held-row: -1;
/// TRACES: FR-CAT-5
// --- reordering a manual collection (FR-CAT-7) --------------------------
@@ -1749,6 +1753,7 @@ export component LibraryGrid inherits Rectangle {
// 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.
// manual: selecting-several
property <bool> ranging: false;
// A range armed against nothing has no anchor to extend from, and the strip
@@ -2461,6 +2466,7 @@ export component LibraryGrid inherits Rectangle {
// drops frames where the chosen people are caught
// blinking, and leaves sunglasses and eyes it could
// not read alone.
// manual: bursts
if root.filter-people.length > 0: FilterChip {
icon: "eye";
label: "Eyes open";
@@ -2492,6 +2498,7 @@ export component LibraryGrid inherits Rectangle {
// intersection. The tray is where both terms and the
// choice between them live, because a filter belongs
// on the filter bar.
// manual: people
FilterChip {
icon: root.people-tray ? "chevron-down" : "chevron-right";
label: "People";
@@ -2610,6 +2617,7 @@ export component LibraryGrid inherits Rectangle {
// why: Each chip is the label's mark and its name, so
// the one you want is found by reading it; tap
// the lit chip again to show every label.
// manual: rating-and-flagging
//
// TRACES: FR-CAT-6 | NFR-A11Y-3
// One chip per colour label, each the cell's own mark and the
@@ -3077,6 +3085,7 @@ export component LibraryGrid inherits Rectangle {
// plain chord opens them beside an Export
// button and the shifted one skips straight to
// exporting.
// manual: export
//
// TRACES: FR-EXP-7 | FR-UI-5
// Before the bare keys below: a chord must not also be read
@@ -3096,6 +3105,7 @@ export component LibraryGrid inherits Rectangle {
// selection bar
// pointer: Select them, then "Paste to N"
// keys: Ctrl+V
// manual: copying-settings
//
// TRACES: FR-DEV-6 | FR-UI-5
// Silent with nothing copied, as the button is disabled.
@@ -3123,6 +3133,7 @@ export component LibraryGrid inherits Rectangle {
// with a ceiling — the twos and threes still
// to be decided — is the keyboard's alone, and
// the bar says so in words while it holds.
// manual: rating-and-flagging
//
// Held rather than typed in sequence, so nothing waits
// to find out whether a second digit is coming: every
@@ -3176,6 +3187,7 @@ export component LibraryGrid inherits Rectangle {
// mark carries its label's initial, so the
// label is read without telling the colours
// apart.
// manual: rating-and-flagging
//
// TRACES: FR-CAT-5 | FR-UI-5 | NFR-A11Y-3
// After the F chord above, which has returned for its own
@@ -3348,6 +3360,7 @@ export component LibraryGrid inherits Rectangle {
// why: 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.
// manual: getting-about
grid-pinch := ScaleRotateGestureHandler {
width: 100%;
height: parent.viewport-height;
@@ -3549,6 +3562,7 @@ export component LibraryGrid inherits Rectangle {
// why: The selection is what the drag carries, which is
// why selecting several is worth the mode: forty
// photographs file in one gesture.
// manual: collections
for cell[i] in root.cells: DragArea {
// Cells are positioned at their **absolute** place in the
// library, not their index in the loaded window: the window
@@ -3846,6 +3860,7 @@ export component LibraryGrid inherits Rectangle {
// finger to dwell 120 ms instead, and that
// rejected ordinary taps — a real tap is
// often quicker than a brush.
// manual: developing-a-photograph
property <int> down-finger: -1;
property <bool> click-pending: false;
@@ -3963,6 +3978,7 @@ export component LibraryGrid inherits Rectangle {
// why: A star has to take the press without it
// also reaching the cell, or every rating
// throws the user into develop.
// manual: rating-and-flagging
//
// --- the rating strip, INSIDE the cell's hit area ---
//
@@ -4104,6 +4120,7 @@ export component LibraryGrid inherits Rectangle {
// they are open and side by side, which is
// the one moment the alternatives are on
// screen to be compared.
// manual: bursts
//
// Drawn on every frame of an open group and on none of
// a folded one. Folded, the single cell showing *is*
@@ -4769,6 +4786,7 @@ export component LibraryGrid inherits Rectangle {
// why: Distinct from Done, which leaves the mode
// entirely. Clearing keeps it, so the next
// selection can start straight away.
// manual: selecting-several
if !root.ranging && root.selected-count > 0: Button {
text: "Clear";
y: (parent.height - self.height) / 2;
@@ -4788,6 +4806,7 @@ export component LibraryGrid inherits Rectangle {
// taps otherwise, and "all of them, except those
// three" is a far more common shape than the taps it
// took to say it.
// manual: selecting-several
if !root.ranging && root.selected-count > 0: Button {
text: "Select all";
y: (parent.height - self.height) / 2;
@@ -4928,6 +4947,7 @@ export component LibraryGrid inherits Rectangle {
// three collections and never which. This is the sheet
// that names them, and the only way out of one the grid
// is not currently scoped to.
// manual: collections
if !root.ranging && root.selected-count > 0: Button {
text: "Collections…";
y: (parent.height - self.height) / 2;
ui/dr-ui/ui/masks.slint
+4
View File
@@ -221,6 +221,7 @@ component MaskEntry inherits Rectangle {
// keys: H, for the selected layer
// history step, unlike holding "Before" — the layer
// really is off until it is switched back on.
// manual: local-adjustments
//
// The eye. Disabling a layer is the A/B a local edit constantly
// wants, so it is one press away rather than inside the row.
@@ -289,6 +290,7 @@ component MaskEntry inherits Rectangle {
// its. Nothing about the edit changes: this is how
// the photograph is looked at, and takes no history
// step.
// manual: local-adjustments
//
// TRACES: FR-DEV-19c
eye := TouchArea {
@@ -371,6 +373,7 @@ component MaskEntry inherits Rectangle {
// a photographer flips a join while looking at
// the picture, not at the panel: add, take
// away, keep only where both agree, and round.
// manual: local-adjustments
//
// TRACES: FR-DEV-19a
join := TouchArea {
@@ -413,6 +416,7 @@ component MaskEntry inherits Rectangle {
// answers that and loses it. The same ring the
// layer wears, one row down, because it is the
// same question about a smaller thing.
// manual: local-adjustments
//
// TRACES: FR-DEV-19a
part-eye := TouchArea {