dtourolle
df741a8a49
A mask the model draws arrives approximately right — stopping inside a shoulder, leaking into the hair — and FR-DEV-3's edge controls move the *whole* boundary, so no value of feather or dilation fixes two errors that go opposite ways. What fixes them is a second selection joined to the first, and a layer that held exactly one source had nowhere to put one. The brush the core has had all along was reachable from no control in the application. A layer is now an ordered list of parts. Each names a source and how it joins the mask before it — added to it, or taken out of it — and carries its own edge treatment, because a model's soft coverage and a stroke painted where it stopped short do not want the same feather. Invert and opacity stay on the layer, where the composed shader already reads them. The sidecar grows `[part]` blocks and nothing else. A layer of one part writes exactly the bytes it always did; a mask block with no part blocks after it reads back as one part; and a stroke, a join or a source this build cannot read costs that part rather than the layer. So every sidecar in every library still parses to the edit it always was. On the device the parts fold into the layer's one slice, so eight layers still cost eight channels: union is a `max` blend and subtraction is the erase blend the brush already used. A part is drawn into a scratch texture before it is joined, and that is not incidental — an erase stroke means a hole in *that part*, not a hole in the mask, and drawn straight onto the accumulator it would punch through the subject underneath. A layer of one part skips all of it and takes the path it always took. In the interface: a part list under the selected layer with a chip saying which way each joins, Add and Subtract beside it, a Select/Paint/Erase strip with the brush's size, hardness and flow, and a drag on the photograph that paints. Pressing Paint on a mask that cannot hold a stroke joins a part that can, rather than explaining that a subject is not a brush. A whole stroke is one step in the history. The edge controls now shape the part that is selected rather than the layer, which is the one behaviour change to an existing control: with a correction selected, the feather slider softens the correction and leaves the model's mask alone.
278 lines
9.9 KiB
Rust
278 lines
9.9 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: "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: "Move a magnified photograph about",
|
|
section: "Develop",
|
|
touch: "Drag it",
|
|
pointer: "Drag it",
|
|
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: "",
|
|
},
|
|
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: "",
|
|
},
|
|
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: "",
|
|
},
|
|
];
|