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.mdindex 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.mdindex 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.mdnew file mode 100644index 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.mdindex 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)