dtourolle
d3b6127db6
FR-DEV-5 asked for named snapshots of an edit state and FR-DEV-7 for a comparison against a chosen one, and neither existed. The history stack is per sitting and forgotten with it, on purpose — the gap that mattered was an automatically saved mis-drag with no way back, and that was closed first. What was left was the other half: a state the photographer wants to keep *because* it is worth keeping, which is a different thing from a step and is not served by making the steps last longer. A snapshot is an edit state, and an edit state is exactly what a sidecar version stores, so it is stored as one: a `[version]` block carrying `snapshot-of = <uuid>`. The parameters, the masks and their parts, the repairs and the film all arrive through the blocks that already carry them, a merge keys on the uuid as it does for any version, and a build that predates the key reads the block as a named version and keeps it — the right failure. Only the pointer is new. The one reader that has to know is `default_version`, which must never answer with a snapshot: a file whose edit is missing is not a file whose edit is one of its saved moments. The snapshots of an edit are listed by that pointer, oldest first, the same on every device. Writing them back removes what this sitting deleted and puts in what it holds, and leaves standing whatever it never saw — a snapshot the other device took since the photograph was opened here is not this device's to remove by not knowing about it. That is the rule the version merge already keeps, applied one level down, and it is why the save carries the deleted ids rather than replacing the list wholesale as the masks are. Each is re-pointed at the uuid the save settled on, because the default may have been fused onto its canonical identity since the snapshot was taken. Restoring is one history step, so undo takes it back whole, as a paste is. Taking and deleting are not steps: they change nothing about the photograph, and an undo that removed a snapshot would be undoing a decision to remember. Holding the eye beside one renders the snapshot and hands the edit straight back — the same suspension "Before" uses, against a point the photographer chose rather than the file. Two sessions on the same photograph get ids that cannot collide, stamped with the second and a random word, because the merge folds equal ids into one.
306 lines
11 KiB
Rust
306 lines
11 KiB
Rust
// @generated by `cargo run -p traceability -- gestures`. Do not edit.
|
|
//
|
|
// TRACES: FR-UI-4
|
|
//! The gesture vocabulary, as the application states it.
|
|
//!
|
|
//! Extracted from the tagged comments beside the code that implements each
|
|
//! one, so the help sheet cannot describe a gesture the application does not
|
|
//! have. Edit the comment beside the implementation, then regenerate with
|
|
//! `cargo run -p traceability -- gestures`.
|
|
|
|
/// One documented interaction, as drawn.
|
|
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
|
|
pub struct Gesture {
|
|
pub title: &'static str,
|
|
/// The place it applies, and the heading it is grouped under.
|
|
pub section: &'static str,
|
|
/// Empty where the gesture has no counterpart in that modality.
|
|
pub touch: &'static str,
|
|
pub pointer: &'static str,
|
|
pub keys: &'static str,
|
|
}
|
|
|
|
/// Every gesture, in the order the sections were first seen in the source.
|
|
pub const GESTURES: &[Gesture] = &[
|
|
Gesture {
|
|
title: "Set the white balance from the photograph",
|
|
section: "Develop",
|
|
touch: "Press \"pick\" in the group's heading, then tap something neutral in the picture",
|
|
pointer: "Press \"pick\", then click something neutral",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Magnify the photograph by any amount",
|
|
section: "Develop",
|
|
touch: "Pinch it with two fingers",
|
|
pointer: "The scroll wheel over it",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Move a magnified photograph about",
|
|
section: "Develop",
|
|
touch: "Drag it",
|
|
pointer: "Drag it",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Paint a mask by hand",
|
|
section: "Develop",
|
|
touch: "Choose Paint or Erase, then drag on the photograph",
|
|
pointer: "Choose Paint or Erase, then drag",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Take back the last change",
|
|
section: "Develop",
|
|
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",
|
|
},
|
|
Gesture {
|
|
title: "Do it again after taking it back",
|
|
section: "Develop",
|
|
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",
|
|
},
|
|
Gesture {
|
|
title: "Copy the settings from this photograph",
|
|
section: "Develop",
|
|
touch: "Press Copy in the Settings panel",
|
|
pointer: "Press Copy in the Settings panel",
|
|
keys: "Ctrl+C",
|
|
},
|
|
Gesture {
|
|
title: "Paste the settings onto this photograph",
|
|
section: "Develop",
|
|
touch: "Press Paste in the Settings panel",
|
|
pointer: "Press Paste in the Settings panel",
|
|
keys: "Ctrl+V",
|
|
},
|
|
Gesture {
|
|
title: "Change which group of adjustments is on screen",
|
|
section: "Develop",
|
|
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\"",
|
|
},
|
|
Gesture {
|
|
title: "Look at the photograph at 1:1",
|
|
section: "Develop",
|
|
touch: "Double-tap the photograph",
|
|
pointer: "Double-click it, or press the zoom readout floating over the canvas",
|
|
keys: "Z",
|
|
},
|
|
Gesture {
|
|
title: "Move to the next or previous photograph",
|
|
section: "Develop",
|
|
touch: "Tap a frame in the roll along the foot of the canvas",
|
|
pointer: "Click a frame in the roll",
|
|
keys: "Right arrow or space for the next, left arrow for the one before",
|
|
},
|
|
Gesture {
|
|
title: "See the photograph before you edited it",
|
|
section: "Develop",
|
|
touch: "Press and hold \"Before\"",
|
|
pointer: "Press and hold \"Before\"",
|
|
keys: "Hold \\",
|
|
},
|
|
Gesture {
|
|
title: "Put one control back to its default",
|
|
section: "Develop",
|
|
touch: "Double-tap its track",
|
|
pointer: "Double-click its track, or right-click it",
|
|
keys: "R, for the control last moved",
|
|
},
|
|
Gesture {
|
|
title: "See the photograph as a snapshot had it",
|
|
section: "Develop",
|
|
touch: "Press and hold the eye beside the snapshot",
|
|
pointer: "Press and hold the eye beside the snapshot",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Keep the photograph as it is now, under a name",
|
|
section: "Develop",
|
|
touch: "Type a name in the History panel and press Snapshot",
|
|
pointer: "Type a name in the History panel and press Snapshot",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Show or hide one mask layer",
|
|
section: "Develop",
|
|
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.",
|
|
},
|
|
Gesture {
|
|
title: "Show or hide one mask on the photograph",
|
|
section: "Develop",
|
|
touch: "Tap the eye on its row",
|
|
pointer: "Click the eye on its row",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Leave one part out of a mask, and put it back",
|
|
section: "Develop",
|
|
touch: "Tap the ring on the part's row",
|
|
pointer: "Click the ring on the part's row",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Pick a collection up to rearrange the tree",
|
|
section: "Collections sidebar",
|
|
touch: "Press and hold it until it lifts, then drag it",
|
|
pointer: "Drag it, or hold it until it lifts and then drag",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Act on a collection — rename, nest, un-nest, delete",
|
|
section: "Collections sidebar",
|
|
touch: "Press and hold the collection, then let go without moving",
|
|
pointer: "Right-click it",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Take a collection back out of the one it is nested in",
|
|
section: "Collections sidebar",
|
|
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: "",
|
|
},
|
|
Gesture {
|
|
title: "Rename a collection",
|
|
section: "Collections sidebar",
|
|
touch: "Hold the collection, then \"Rename\"",
|
|
pointer: "Double-click its name, or right-click it and choose \"Rename\"",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Pull a face out of the wrong person",
|
|
section: "People",
|
|
touch: "Tap the faces that do not belong, then \"Split off\"",
|
|
pointer: "Click the faces that do not belong, then \"Split off\"",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Rule on a suggested face",
|
|
section: "People",
|
|
touch: "Tick to confirm it, cross to reject it",
|
|
pointer: "Tick to confirm it, cross to reject it",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "See a person's photographs",
|
|
section: "People",
|
|
touch: "Choose them in the rail, then \"Show photos\"",
|
|
pointer: "Choose them in the rail, then \"Show photos\"",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Change how faces are grouped",
|
|
section: "People",
|
|
touch: "\"Grouping…\", move the dials, then Regroup",
|
|
pointer: "\"Grouping…\", move the dials, then Regroup",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Start selecting several photographs",
|
|
section: "Library grid",
|
|
touch: "Press and hold a photograph, or press Select in the header",
|
|
pointer: "Ctrl-click, or press Select in the header",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Add or remove one photograph",
|
|
section: "Library grid",
|
|
touch: "While selecting, tap it",
|
|
pointer: "Ctrl-click it",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Leave selecting",
|
|
section: "Library grid",
|
|
touch: "Press Done in the header",
|
|
pointer: "Press Done in the header",
|
|
keys: "Escape",
|
|
},
|
|
Gesture {
|
|
title: "Pick a photograph up to drag it",
|
|
section: "Library grid",
|
|
touch: "Press and hold it until a ring opens around it, then drag",
|
|
pointer: "Drag it",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Select a range",
|
|
section: "Library grid",
|
|
touch: "While selecting, press \"Select to…\", then tap the last photograph of the run",
|
|
pointer: "Shift-click the last photograph of the run",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Find photographs with two people in them",
|
|
section: "Library grid",
|
|
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: "",
|
|
},
|
|
Gesture {
|
|
title: "Resize the thumbnails",
|
|
section: "Library grid",
|
|
touch: "Pinch the grid with two fingers",
|
|
pointer: "Ctrl and the scroll wheel",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "File photographs in a collection",
|
|
section: "Library grid",
|
|
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: "",
|
|
},
|
|
Gesture {
|
|
title: "Open a photograph",
|
|
section: "Library grid",
|
|
touch: "Tap it — a single tap, any length",
|
|
pointer: "Click it",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Rate a photograph without opening it",
|
|
section: "Library grid",
|
|
touch: "Tap a star on the cell",
|
|
pointer: "Hover the cell, then click a star",
|
|
keys: "0 to 5 on the selection",
|
|
},
|
|
Gesture {
|
|
title: "Choose the frame a folded burst shows",
|
|
section: "Library grid",
|
|
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: "",
|
|
},
|
|
Gesture {
|
|
title: "Drop the selection but keep selecting",
|
|
section: "Library grid",
|
|
touch: "Press Clear in the selection strip",
|
|
pointer: "Press Clear in the selection strip",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Select everything the grid is showing",
|
|
section: "Library grid",
|
|
touch: "While selecting, press \"Select all\"",
|
|
pointer: "While selecting, press \"Select all\"",
|
|
keys: "",
|
|
},
|
|
Gesture {
|
|
title: "Take photographs out of a collection",
|
|
section: "Library grid",
|
|
touch: "Select them, then \"Collections…\" in the selection bar",
|
|
pointer: "Select them, then \"Collections…\" in the selection bar",
|
|
keys: "",
|
|
},
|
|
];
|