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",
},
];