> For the complete documentation index, see [llms.txt](https://fater.gitbook.io/fater-ai-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fater.gitbook.io/fater-ai-docs/using-editing-and-masking-tools/introduction-to-the-inpaint-toolbar.md).

# Introduction to the Inpaint Toolbar

The **Inpaint Toolbar** is your primary toolkit when working within Fater's **Image Editor**. It's typically found floating vertically on the left side of the main **Inpaint Canvas** and provides quick access to a range of tools and actions for masking, direct layer editing, canvas manipulation, and AI preprocessing.

***

### Toolbar Overview

 *(Placeholder: Add screenshot of the toolbar)*

The toolbar consists of a series of **Action Buttons**, each represented by an icon. Clicking a button either selects a tool or performs an immediate action. Many buttons also have **tooltips** explaining their function, and some reveal **popover options** when you right-click them (or hover, depending on the button).

***

### Tool Categories & Key Actions:

Here's a breakdown of the tools and actions available on the Inpaint Toolbar:

**1. Masking Tools:***These tools are used to create and modify selections on the **Mask Canvas**.*

* 🖌️ **Mask Brush (`Brush` icon):** Selects the brush for painting mask areas. *(See Creating Masks Manually)*
  * *Tip: Shift + Mouse Wheel changes brush size.*
* ▭ **Mask Rectangle (`RectangleHorizontal` icon):** Selects the tool for drawing rectangular mask selections.
*  **Polygonal Lasso (`PolygonalLasso` icon):** Selects the tool for creating precise polygonal mask selections by clicking points.
  * *Tip: Alt + Click creates an erasing polygon. Double-click closes the polygon.*
* 🚫 **Clear Mask (`X` icon):** Immediately removes the entire current mask.
*  **Invert Mask (`YinYang` icon):** Flips the masked and unmasked areas.
* 🔍 **Prompt to Mask (`TextSearch` icon):** Initiates AI-powered mask generation based on a text prompt you provide (often in coordination with the Agent). *(See AI-Powered Masking)*
  * *Tip: Alt + Click subtracts the AI-generated mask from the current mask.*
* ↔️ **Inflate/Deflate Mask (`Expand` icon):** Expands or shrinks the border of the current mask by a set number of pixels.
  * *Tip: Alt + Click deflates. Shift + Click uses a larger step size.*
* ◌ **Border Mask (`CircleDashed` icon):** Modifies the mask to only include its edge pixels.

**2. Direct Layer Editing Tools:***These tools affect the pixel content of the currently **selected single layer**.*

* ✏️ **Pencil (`Pen` icon):** Selects the pencil tool for drawing directly on a layer.
  * *Tip: Right-click the icon for options (Width, Color via RGBA Picker). Shift + Mouse Wheel changes size.*
* 🔪 **Cutter/Edge Drawing Tool (`PenLine` icon):** Selects the tool for drawing straight white lines on a layer (often used for preparing Edges maps).
*  **Eraser (`Eraser` icon):** Selects the eraser tool for removing pixel content from a layer (distinct from the mask brush's erase mode).
  * *Tip: Shift + Mouse Wheel changes size.*

**3. Canvas & Image Actions:**

* 💾 **Download Composed Image (`Save` icon):** Downloads the current view of the assembled canvas (all visible layers).
  * *Tip: Right-click for options (Format: webp, png, jpeg; Megapixels).*
* ✂️ **Extract Masked Area to Layer (`Scissors` icon):** Creates a new layer from the content within the currently masked area. If no mask exists, it may attempt an "AI Autocut."
* 🖼️ **Resize Canvas to Masked Area/Layer (`Crop` icon):**
  * If a mask is active, resizes the **Generation Area Bounding Box** to fit the mask.
  * (This icon is also used on layer items in the Layers Tab to resize the canvas to fit that specific layer).
* 🔳 **Toggle Square Canvas (`Square` icon):** Forces the Generation Area Bounding Box into a 1:1 aspect ratio.
* 🔍 **Zoom to Fit All Layers (`ZoomIn` icon):** Adjusts the canvas zoom and pan to make all visible layers fit within the viewport.

**4. AI Preprocessing & Utility Actions:**

* 🤖 **Generate Edges Map (`Cpu` icon):** Creates a new layer containing an Edges map derived from the visible content within the Generation Area. *(See* [Preprocessing for AI: Edges and Depth Maps](/fater-ai-docs/generating-images-with-ai/preprocessing-for-ai-edges-and-depth-maps.md)*)*
  * *Tip: Right-click for Low/High Threshold options.*
* ⛰️ **Generate Depth Map (`Mountain` icon):** Creates a new layer containing a Depth map from the visible content. *(See* [Preprocessing for AI: Edges and Depth Maps](/fater-ai-docs/generating-images-with-ai/preprocessing-for-ai-edges-and-depth-maps.md)*)*
  * *Tip: Right-click for Type (Monotile/Multitiles) and Split options.*
* **Delete Mask Content (`Trash`icon):** Uses AI to intelligently remove and fill the content within the masked area.
  * *Tip: Right-click to select the AI Model for this task.*

***

**Tool Selection & Options:**

* Click an icon to select a tool. The selected tool's icon usually appears highlighted.
* Clicking an already active tool icon often deselects it (returning to a neutral/pan mode).
* For tools with options (like Edges Map, Depth Map, Download, Pencil), **right-click the tool icon** on the toolbar *before* performing the main click to open a popover menu where you can adjust its specific settings.

The Inpaint Toolbar is your go-to for most direct canvas interactions and quick AI utility functions in the Image Editor.