From a59f14c797e50a7bcb2bcfc10e2cd371e3599394 Mon Sep 17 00:00:00 2001 From: Duncan Tourolle Date: Sat, 26 Sep 2026 11:50:45 -0400 Subject: [PATCH] Describe shipped presets and looks in the manual and FR-DEV-6 The presets sheet now lists the shipped collection beside the photographer's own, a copy under a shipped name overrides it, and shipped and imported presets are looks that leave a photograph's own corrections alone. The manual says so where it introduces the sheet, and FR-DEV-6 states the rule. The sheet's screenshot (media/presets.png) predates the sections and needs re-recording. --- docs/dev/requirements.md | 7 +++++++ docs/manual/README.md | 8 ++++++++ docs/manual/index.html | 7 +++++++ 3 files changed, 22 insertions(+) diff --git a/docs/dev/requirements.md b/docs/dev/requirements.md index e65b768..15ab30b 100644 --- a/docs/dev/requirements.md +++ b/docs/dev/requirements.md @@ -502,6 +502,13 @@ so history survives a restart. Named snapshots of an edit state. **FR-DEV-6 — Presets.** Save, apply, and manage named presets covering a subset of the edit graph. Copy/paste settings between images. Batch-apply to a selection. +A preset may name a film stock, which travels with the film node's own parameters. The +application ships a read-only collection of presets, updated with each release and never +written into the user's library; a user preset saved under a shipped name overrides it +until deleted or renamed. Shipped and imported presets change only the operations they +name, so a look applied to a corrected photograph keeps the correction; a copy or a saved +edit replaces everything in scope. + **FR-DEV-7 — Before/after.** Compare current edit state against the unedited original or against a chosen history state. diff --git a/docs/manual/README.md b/docs/manual/README.md index 3a50876..5a33047 100644 --- a/docs/manual/README.md +++ b/docs/manual/README.md @@ -261,6 +261,14 @@ Every change is a step; `Undo` and the History panel walk them. `Snapshot` keeps the current state under a name. `Presets…` saves the settings to apply elsewhere, and imports `.xmp` from other applications. +The sheet lists your own presets first, then the ones DarkRoom ships — +Essentials, and colour, cinema and black-and-white film, one measured stock +each. A shipped preset is a look: it changes what it names and leaves the +photograph's own corrections alone, as an imported Lightroom preset does. +Saving under a shipped preset's name makes your version the one that name +applies, marked *changed*; `Revert` brings the shipped one back, and renaming +yours makes it one of your own. + ![The presets sheet](media/presets.png) ### Copying settings diff --git a/docs/manual/index.html b/docs/manual/index.html index c6a5b5f..e7578e6 100644 --- a/docs/manual/index.html +++ b/docs/manual/index.html @@ -318,6 +318,13 @@ black-and-white stocks at its end.

Every change is a step; Undo and the History panel walk them. Snapshot keeps the current state under a name. Presets… saves the settings to apply elsewhere, and imports .xmp from other applications.

+

The sheet lists your own presets first, then the ones DarkRoom ships — +Essentials, and colour, cinema and black-and-white film, one measured stock +each. A shipped preset is a look: it changes what it names and leaves the +photograph's own corrections alone, as an imported Lightroom preset does. +Saving under a shipped preset's name makes your version the one that name +applies, marked changed; Revert brings the shipped one back, and renaming +yours makes it one of your own.

The presets sheet
The presets sheet

Copying settings

Copy in the top bar, or Ctrl+C, takes this photograph's settings; Paste,