Skip to content

LightCraft: An open-source non-destructive photo editor written by scratch in pure Rust

docs(support): explain the Remove tool workflow (#1756)

Zaxaerith8109deb5ef8c
diff --git a/docs/user/guides/edit-a-photo.md b/docs/user/guides/edit-a-photo.md
index 126324159..366bf5212 100644
--- a/docs/user/guides/edit-a-photo.md
+++ b/docs/user/guides/edit-a-photo.md
@@ -32,7 +32,7 @@ Open them from the **Window** menu, or press the key shown next to each one:
| Panel | Key |
|-------------------|-------------|
| **Crop & Rotate** | `C` |
-| **Remove** | `H` |
+| [**Remove**](remove-distractions.md) | `H` |
| **Masking** | `M` |
| **Presets** | `Shift`+`P` |
diff --git a/docs/user/guides/index.md b/docs/user/guides/index.md
index b3c656946..f64dd2335 100644
--- a/docs/user/guides/index.md
+++ b/docs/user/guides/index.md
@@ -7,5 +7,6 @@ order: 20
- [Import photos](import-photos.md)
- [Rate, flag and label photos](cull-photos.md)
- [Edit a photo](edit-a-photo.md)
+- [Remove distractions from a photo](remove-distractions.md)
- [Export photos](export-photos.md)
- [Move over from Lightroom](import-lightroom-catalog.md)
diff --git a/docs/user/guides/remove-distractions.md b/docs/user/guides/remove-distractions.md
new file mode 100644
index 000000000..ae2705141
--- /dev/null
+++ b/docs/user/guides/remove-distractions.md
@@ -0,0 +1,70 @@
+---
+title: Remove distractions from a photo
+description: Paint over a small distraction, see when the repair takes effect, and adjust or undo it.
+order: 35
+verified: 0.8.0
+---
+
+## Remove a distraction
+
+Paint over the distraction and release the mouse button. LightCraft applies the repair automatically; there is no **Apply** button.
+
+For example, remove a small speck from a plain background:
+
+1. Double-click the photo in the grid to open it in **Detail** view. If it is not in your library yet, [import the photo](import-photos.md) first.
+2. Press `H`, choose **Window** > **Remove**, or click the **Remove** tool at the far right.
+3. Choose **Remove** at the top of the panel.
+4. Adjust **Size** so the brush covers the speck. Set **Opacity** to 100 for a full repair. **Feather** softens the edge.
+5. Click once for a round spot, or hold the mouse button and drag to paint over a longer distraction.
+6. Release the mouse button. LightCraft adds the repair and updates the photo. The painted area is not waiting for confirmation. Allow the preview to finish updating.
+7. Press `E` to open **Edit** and inspect the result without the repair outlines. Return with `H` if you need to [adjust the repair](#adjust-or-undo-a-repair).
+8. [Export the photo](export-photos.md) to save an edited copy. For a rendered photo with the repair, choose a format such as **JPEG**.
+
+## Adjust or undo a repair
+
+Each click or completed stroke creates one repair, called a spot in the panel.
+
+1. Open **Remove** and click the repair's pin on the photo to select it. Clicking an existing pin selects that repair instead of adding another one.
+2. Change **Size**, **Feather** or **Opacity** to adjust the selected repair. Drag its target pin to move the repaired area.
+3. For **Remove**, **Heal** or **Clone**, drag the source outline to a cleaner area if the copied detail looks wrong. Or click **Refresh Source (/)** to ask LightCraft to choose another source. It may report that no other source fits.
+4. To replace the painted shape or try another mode, click **Delete (⌫)**, choose the mode, and paint again. The mode buttons choose the mode for new repairs.
+5. To undo your last change, choose **Edit** > **Undo**. To delete a particular repair, select its pin and click **Delete (⌫)**.
+
+## Other repair modes
+
+Choose the mode before painting a new repair.
+
+| Mode | What it does in LightCraft 0.8.0 |
+|---|---|
+| **Remove** | Chooses a nearby source patch and blends its detail with the tone around the repaired area. You can move or refresh the source afterward. |
+| **Content-Aware** | Rebuilds the painted area from patches of its surroundings. It does not use one source patch, so moving or refreshing a source does not change the fill. |
+| **Heal** | Uses the same blending as **Remove** in this release. It also starts with an automatically chosen source that you can move or refresh. |
+| **Clone** | Copies the source patch's colour and detail, with the edge and strength controlled by **Feather** and **Opacity**. It also starts with an automatically chosen source. |
+
+## Common questions
+
+### I painted an area. Why does it look unchanged?
+
+1. Release the mouse button and let the preview update.
+2. Check **Opacity**. At 0, a repair has no visible effect. Select the repair and raise it to 100.
+3. Check that the brush covers the distraction. Clicking an existing pin only selects a repair.
+4. Turn off **Visualize Spots (A)** to judge the normal photo. This black-and-white view helps reveal specks; it does not apply a repair.
+5. If **View** > **Show Original** is on, choose it again to return to the edited photo.
+6. If the copied patch is unsuitable, adjust its source or delete the repair and paint again.
+
+### Is there an Apply button?
+
+No. A click adds a round repair. A brush stroke is applied when you release the mouse button. Selecting another panel does not discard it.
+
+### Why do I see circles, pins or an arrow?
+
+These mark the repaired area and, for a selected repair that uses one, its source. They let you select and move the repair. Press `E` to inspect the photo without them. They are not part of the exported photo.
+
+### How do I see the original?
+
+1. Choose **View** > **Show Original** to see the original.
+2. Choose **View** > **Show Original** again to return to the edited photo.
+
+### Is my original photo overwritten?
+
+No. Repairs are stored as edits in the library. Export an edited copy when you want a file to share; see [Export photos](export-photos.md).
diff --git a/docs/user/index.md b/docs/user/index.md
index a0655a0d3..80df9587b 100644
--- a/docs/user/index.md
+++ b/docs/user/index.md
@@ -14,6 +14,7 @@ You import photos, sort them with ratings, flags and albums, and edit them witho
- [Import photos](guides/import-photos.md)
- [Rate, flag and label photos](guides/cull-photos.md)
- [Edit a photo](guides/edit-a-photo.md)
+- [Remove distractions from a photo](guides/remove-distractions.md)
- [Export photos](guides/export-photos.md)
- [Move over from Lightroom](guides/import-lightroom-catalog.md)
- [A raw photo opens as "Preview only"](troubleshooting/preview-only-raw.md)