Skip to content

Latest commit

 

History

History
467 lines (386 loc) · 35.1 KB

tool_guide.md

File metadata and controls

467 lines (386 loc) · 35.1 KB

IntraPaint Tools

This guide covers the editing tools found within the "Tools" panel. and the extra options found under the "Tools" menu. All hotkeys can be changed in settings (F9) under the keybindings tab.


Table of Contents

  1. Shared controls
  2. Image editing tools

Shared controls

All tools share the same set of basic controls for adjusting the image viewport.

  • Middle-click and drag, or Ctrl + left-click and drag: Pan image content.
  • Mouse scroll wheel, Page Up, or Page Down: Zoom in or zoom out.
  • "Z" key: Zoom in on the image generation area, or reset the zoom level.
  • Hold Alt: Speed up key or mouse wheel inputs.
  • Escape, while any input has keyboard focus: Return keyboard focus to the image.

The following controls are shared by most tools, but certain tools will override them:

  • Arrow keys: Move the image generation area. This is ignored if Stable Diffusion AI image generation is inactive.
  • Ctrl + arrow keys: Pan image content.

Each tool also has a key assigned to it that will activate that tool, active whenever you're not entering text. These keys are configurable in settings under "Keybindings", and are shown in the bottom right corner of each tool icon.


Image editing tools

Brush tool icon Brush tool (B)

Draw, paint, blur, smudge, or erase within the image using the MyPaint brush engine. This tool provides a wide variety of brushes, emulating various traditional art tools. IntraPaint's brush options are from the public-domain MyPaint brush project.

Basic controls

  • Left-click: Draw within the image.
  • Right-click: Draw with one-pixel brush width.
  • Hold shift and left-click: Draw a line from the last place you clicked.
  • Hold Alt while drawing: Force the brush to follow a fixed angle.
  • "[", "]", or mouse scroll wheel left/right: Change the brush size. Hold shift to change size faster.
  • Hold Ctrl: temporarily switch to the color picker tool.
  • Hold Alt: Increase speed when changing brush size using keyboard keys.

User interface

Screenshot of the brush tool controls, with specific elements numbered.

  1. Brush size slider: Actual brush stroke width may exceed this size, depending on brush type and tablet pen pressure.
  2. Brush color button: Opens a color dialog to change brush color.
  3. "Paint selection only" checkbox: When checked, the brush will only make changes within selected content.
  4. Brush category tabs: Switch between different MyPaint brush categories.
    • The first category, Favorites is customizable.
    • Any .myb brush files added to the custom brush directory (defined in settings under Files/Added MyPaint brush directory) will appear in a new category at the end of the list.
  5. Brush icons: Click to select a new brush, right-click to add or remove the brush from the Favorites category.
  6. A preview of a few of the available brushes. Links to full previews of all brush sets are here:

Draw tool icon Draw tool (D)

A basic brush tool with easily adjustable properties.

Basic controls

  • Left-click: Draw within the image.
  • Right-click: Draw with one-pixel brush width.
  • Hold shift and left-click: Draw a line from the last place you clicked.
  • Hold Alt while drawing: Force the brush to follow a fixed angle.
  • "[", "]", or mouse scroll wheel left/right: Change the brush size.
  • "<" and ">" keys: Change the brush opacity.
  • "{" and "}"keys: Change the brush hardness.
  • Hold Alt: Increase speed when changing size, opacity, or hardness using keyboard keys.
  • Hold Ctrl: Temporarily switch to the color picker tool.

User interface

Screenshot of the draw tool controls, with specific elements numbered.

  1. Brush size slider: Sets the exact brush width.
  2. Brush opacity slider: Sets the exact brush opacity, between 0.0 (fully transparent) and 1.0 (fully opaque).
  3. Brush hardness slider: Sets the brush edge hardness. At 1.0 brush edges are completely solid, at 0.0 brush edges fade evenly from the center.
  4. Brush color button: Opens a color dialog to change brush color.
  5. Brush pattern dropdown: Choose between a few basic brush fill patterns.
  6. Tablet pen pressure controls: These controls are only visible after IntraPaint first detects a connected drawing tablet. Pen pressure can be connected to any combination of size, opacity, and hardness, to scale those values down as pressure decreases.
  7. Antialiasing checkbox: When checked, extra smoothing will be applied to jagged pixel edges when drawing. This is most useful when hardness is near 1.0.
  8. "Draw in selection only" checkbox: When checked, the brush will only make changes within selected content.
  9. Examples of available brush settings.

Eraser tool icon Eraser tool (E)

Erase image content.

Basic controls

  • Left-click: Erase within the image.
  • Right-click: Erase with one-pixel brush width.
  • Hold shift and left-click: Erase a line from the last place you clicked.
  • Hold Alt while drawing: Force the eraser to follow a fixed angle.
  • "[", "]", or mouse scroll wheel left/right: Change the eraser size.
  • "<" and ">" keys: Change the eraser opacity.
  • "{" and "}"keys: Change the eraser hardness.
  • Hold Alt: Increase speed when changing size, opacity, or hardness using keyboard keys.

User interface

Screenshot of the eraser tool controls, with specific elements numbered.

  1. Eraser size slider: Sets the exact eraser width.
  2. Eraser opacity slider: Sets the exact eraser opacity. At 1.0 the eraser completely clears image content.
  3. Eraser hardness slider: Sets the brush edge hardness. At 1.0 eraser edges are completely solid, at 0.0 eraser edges fade evenly from the center.
  4. Tablet pen pressure controls: These controls are only visible after IntraPaint first detects a connected drawing tablet. Pen pressure can be connected to any combination of size, opacity, and hardness, to scale those values down as pressure decreases.
  5. Antialiasing checkbox: When checked, extra smoothing will be applied to jagged pixel edges when erasing. This is most useful when hardness is near 1.0.
  6. "Erase in selection only" checkbox: When checked, the eraser will only make changes within selected content.
  7. Examples of available brush settings.

Fill tool icon Fill tool (F)

Fill connected image areas with solid colors or basic patterns.

Basic controls

  • Left-click: Fill connected areas with colors matching the clicked spot with the selected color.
  • Hold Ctrl: Temporarily switch to the color picker tool.

User interface

Screenshot of the fill tool controls, with specific elements numbered.

  1. Brush color button: Opens a color dialog to change brush color.
  2. Fill pattern dropdown: Choose between a few basic fill patterns.
  3. Color threshold slider: Controls how closely colors must match when filling connected areas. At 0.0, only connected areas with the exact same color will be filled. The accepted color range expands as the threshold value increases.
  4. "Sample merged" checkbox: When checked, the fill tool will use all image layers to determine where to fill. When unchecked, content outside the active layer will be ignored.
  5. "Paint selection only" checkbox: When checked, the fill tool will only make changes within selected content.
  6. Examples of different fill patterns and behaviors.

Filter brush tool icon Filter Brush tool (I)

Apply any image filter to the image using brush strokes.

This tool uses the same filters that are found in the Filters menu. See Filter menu documentation for more information about individual filters and their tool panel options.

Basic controls

  • Left-click: Draw within the image.
  • Right-click: Draw with one-pixel brush width.
  • Hold shift and left-click: Draw a line from the last place you clicked.
  • Hold Alt while drawing: Force the brush to follow a fixed angle.
  • "[", "]", or mouse scroll wheel left/right: Change the brush size.
  • "<" and ">" keys: Change the brush opacity.
  • "{" and "}"keys: Change the brush hardness.
  • Hold Alt: Increase speed when changing size, opacity, or hardness using keyboard keys.

User interface

Screenshot of the filter brush tool controls, with specific elements numbered.

  1. Filter selection dropdown: Choose between any of the available filters. These are the current options:
    • RGBA color filter: Increase or decrease the strength of the red, green, blue and/or alpha color channels across filtered content.
    • Brightness/contrast filter: Increase or decrease image brightness and/or contrast.
    • Blur filter: Blur image content.
    • Sharpen filter: Strengthen edges within image content.
    • Posterize filter: Reduce color depth within the image.
  2. Filter-specific options: These change based on the selected filter. Hold the mouse over any control to see a description of what it does.
  3. Brush size slider: Sets the exact brush width.
  4. Brush opacity slider: Sets the exact brush opacity, between 0.0 (fully transparent) and 1.0 (fully opaque).
  5. Brush hardness slider: Sets the brush edge hardness. At 1.0 brush edges are completely solid, at 0.0 brush edges fade evenly from the center.
  6. Tablet pen pressure controls: These controls are only visible after IntraPaint first detects a connected drawing tablet. Pen pressure can be connected to any combination of size, opacity, and hardness, to scale those values down as pressure decreases.
  7. Antialiasing checkbox: When checked, extra smoothing will be applied to jagged pixel edges when drawing. This is most useful when hardness is near 1.0.
  8. "Filter selection only" checkbox: When checked, the brush will only make changes within selected content.
  9. Examples of available filters.

Smudge tool icon Smudge tool (M)

Smudge image content to adjust the placement of image elements and smooth away unwanted details.

Basic controls

  • Left-click and drag: Smudge image content.
  • Right-click and drag: Smudge with one-pixel brush width.
  • Hold shift and left-click: Smudge a line from the last place you clicked.
  • Hold Alt while drawing: Force the cursor to follow a fixed angle.
  • "[", "]", or mouse scroll wheel left/right: Change the cursor size.
  • "<" and ">" keys: Adjust smudge tool opacity.
  • "{" and "}"keys: Adjust smudge tool hardness.
  • Hold Alt: Increase speed when changing size, opacity, or hardness.

User interface

Screenshot of the smudge tool controls, with specific elements numbered.

  1. Size slider: Sets the cursor size, adjusting how large of an area gets smudged.
  2. Opacity slider: Sets the smudging strength, between 0.0 (image content doesn't move at all) and 1.0 (image content continues moving no matter how far you drag).
  3. Hardness slider: Sets the brush edge hardness. At 1.0 brush edges are completely solid, at 0.0 brush edges fade evenly from the center.
  4. Tablet pen pressure controls: These controls are only visible after IntraPaint first detects a connected drawing tablet. Pen pressure can be connected to any combination of size, opacity, and hardness, to scale those values down as pressure decreases.
  5. Antialiasing checkbox: When checked, extra smoothing will be applied to jagged pixel edges when smudging. This is most useful when hardness is near 1.0.
  6. "Edit selection only" checkbox: When checked, the smudge tool will only make changes within selected content.
  7. Examples showing how opacity and hardness impact smudging.

Clone stamp tool icon Clone stamp tool (N)

Copy image content from one area to another using a brush.

Basic controls

  • Right-click: Select a sample point within the image. The sample point will remain stationary until you start drawing or pick a new point.
  • Left-click: Draw into the image, copying content from the sample point. Once you start drawing, the sample point will begin moving with the cursor.
  • Hold shift and left-click: Draw a line from the last place you clicked.
  • Hold Alt while drawing: Force the brush to follow a fixed angle.
  • "[", "]", or mouse scroll wheel left/right: Change the brush size.
  • "<" and ">" keys: Change the brush opacity.
  • "{" and "}"keys: Change the brush hardness.
  • Hold Alt: Increase speed when changing size, opacity, or hardness using keyboard keys.

User interface

Screenshot of the clone stamp tool controls, with specific elements numbered.

  1. Offset inputs: Controls the exact offset from the cursor to the copy sampling point.
  2. Brush size slider: Sets the exact brush width.
  3. Brush opacity slider: Sets the exact brush opacity, between 0.0 (fully transparent) and 1.0 (fully opaque).
  4. Brush hardness slider: Sets the brush edge hardness. At 1.0 brush edges are completely solid, at 0.0 brush edges fade evenly from the center.
  5. Tablet pen pressure controls: These controls are only visible after IntraPaint first detects a connected drawing tablet. Pen pressure can be connected to any combination of size, opacity, and hardness, to scale those values down as pressure decreases.
  6. Antialiasing checkbox: When checked, extra smoothing will be applied to jagged pixel edges when drawing. This is most useful when hardness is near 1.0.
  7. "Update selection only" checkbox: When checked, the clone stamp tool will only make changes within selected content.
  8. Sampling source point marker: Shows the area where image content will be copied from.
  9. This example shows how image content gets copied from the sample area to the cursor as individual brush strokes.

Color Picker tool icon Color Picker tool (C)

Selects the color used by the brush, draw, and fill tools. Left-click any spot within the image to copy the color at that spot.

User interface: Color component tab

Screenshot of the first panel of color picker tool controls, with specific elements numbered.

Depending on tool panel size, this tab's top and bottom halves might be split into two panels: Spectrum and Color Component.

User interface: Palette tab

Screenshot of the first panel of color picker tool controls, with specific elements numbered.

Depending on tool panel size, this tab's top and bottom halves might be split into two panels: Basic colors and Custom Colors.

  1. Color control tabs: switch between different sets of color controls.
  2. Current color: The currently selected color. When the custom palette grid is visible, this can be dragged into any of the custom color squares.
  3. "Pick Screen Color" button: Enters a mode where you can select a color from anywhere on the screen, not just within the image. When active, left-click to select a color, or press escape to cancel.
  4. Color hue/saturation field: Click any spot here to set current color hue and saturation values.
  5. Color value slider: Sets the current selected colors value/lightness.
  6. HSV fields: Directly view and update the selected color's hue, saturation, and value measurements.
  7. Color channel fields: Directly view and update individual color channel strengths for the current color.
  8. HTML color code: View and update the selected color's ARGB hexadecimal color code.
  9. Basic color palette: Click any of these pre-selected color options to change the active color. These can also be dragged to any square in the "Custom colors" section to update that saved color.
  10. Custom color palette: Saves a set of customized user-selected colors. These will be preserved even when you close and re-open IntraPaint.
  11. "Add to Custom Colors" button: Replaces one of the custom colors with the current selected color, starting with the first duplicate color in the grid. If there are no duplicate colors in the grid, it will start by replacing the first color, and move through the list each time the button is pressed.

Text tool icon Text tool (X)

Create and edit text within the image. Each piece of text remains within its own layer, and can be edited with the text tool until explicitly converted to an image layer. Saving and re-opening the image, even in the layered .ora format, converts all text layers to image layers.

Basic controls

  • Left-click and drag within the active text layer: Move the layer within the image.
  • Left-click and drag active text layer corners: Resize the text layer, unless "Resize Bounds to Text" is checked.
  • Left-click and drag outsize of an active text layer: Create a new text layer.
  • Left-click an inactive text layer: Switch to the clicked text layer.
  • Arrow keys: move the active text layer.
  • Ctrl + arrow keys: resize the active text layer.
  • "O", "P": Increase or decrease the text size, unless "Resize Font to Bounds" is checked.
  • Hold Alt: Increase speed when changing text size or placement using keyboard keys.

User interface, first page:

Screenshot of the text tool controls, with specific elements numbered.

  1. Text preview image: A preview of the text and settings currently entered into the text tool controls.
  2. Text input field: Type into this section to set the created text.
  3. Text color: Sets the color used when drawing text.
  4. Background color: Sets the color drawn behind the text, only used outside the preview when the "Fill Background" checkbox is checked.
  5. Text size slider: Set the size of the drawn text, unless "Resize Font to Bounds" is checked.
  6. Text size format: Controls whether the text size slider sets text size as a font point size or a pixel size.
  7. Text layer placement: Controls the coordinates and size of the active text layer within the image.
  8. "Resize Font to Bounds" checkbox: When checked, the font size will continually change to ensure that the text fits within the available space. Selecting this disables the size slider and unchecks "Resize Bounds to Text".
  9. "Resize Bounds to Text" checkbox: When checked, the active text layer size will continually change to ensure that the text fints within the available space. Selecting this disables the width and height inputs and unchecks "Resize Font to Bounds".
  10. The active text layer.
  11. Various inactive text layers

User interface, continued:

Screenshot of the rest of the tool controls, with specific elements numbered.

  1. Font list: Choose between any font installed on your computer. IntraPaint will also load additional fonts from a configurable folder. View or update the location of the custom font folder in the settings under "Files/Added font directory".
  2. Text style checkboxes: Choose between various font styling options. Not all fonts will support all of these options.
  3. Text alignment dropdown: Choose how text will be horizontally aligned within the text layer.
  4. Stretch field: Controls how widely the text is rendered, as a percentage of the default width.

Shape tool icon Shape tool (Shift+S)

Draws geometric shapes within the image.

Basic controls

  • Left-click and drag: Draw a shape into the image.
  • Hold Ctrl: Restricts new shapes to a 1:1 aspect ratio.

User interface

Screenshot of the shape tool controls, with specific elements numbered.

  1. Shape Type dropdown: Selects the type of shape to draw. Options are ellipse, rectangle, polygon, and star.
  2. Vertex count slider: Sets the number of outer points that new shapes will have. This is only visible when the shape type is polygon or star.
  3. Inner radius fraction: Sets how far inner points extend outwards from the shape's center, as a fraction of the outer point radius. This is only visible when the shape type is star.
  4. Fill color button: Click to open a color dialog to set the fill color used when drawing new shapes.
  5. Line color button: Click to open a color dialog to set the outline color used when drawing new shapes.
  6. Fill pattern dropdown: Select between basic patterns that can be used when filling new shapes.
  7. Line style dropdown: Select between drawing solid outlines, and drawing various types of dashed/dotted lines.
  8. Line width slider: Controls the outline width when drawing new shapes. Set to zero to disable outline drawing.
  9. Line join style dropdown: Controls how shape outline connections are drawn.
  10. Custom dash pattern: Only visible when the line style dropdown is set to "Custom pattern". Patterns use the format "dash_length space_length ", repeated as many times as desired, where dash_length and space_length are both round numbers.
  11. Antialiasing checkbox: When checked, extra smoothing will be applied to smooth jagged pixels along shape edges.
  12. Examples of different shape options, fill patterns, and line styles.

Transform Layer tool icon Transform layer tool (T)

Move, scale, or rotate image layers or layer groups. Transformations are lossless when editing, or when saving in the .ora file format.

Basic controls

  • Left-click outside the active layer: Activate the topmost visible layer at the clicked point.
  • Left-click and drag within the active layer: Move the layer within the image.
  • Double-click the active layer: Switch between scaling and rotation modes.
  • Left-click and drag layer corners: Either scale or rotate the layer, depending on whether you're in scaling mode or rotation mode.
  • Left-click and drag the center origin point: Adjusts the point within the layer that the layer will rotate around.
  • Arrow keys: Move the layer within the image.
  • Ctrl + arrow keys: Resize the layer.
  • "O", "P" keys: Rotate the layer counter-clockwise or clockwise.
  • Hold Shift: When resizing the layer using the corner points, keep the layer's aspect ratio the same.
  • Hold Alt: Increase speed when changing layer scale, position, or rotation using keyboard keys.

User interface

Screenshot of the layer transformation tool controls, with specific elements numbered.

  1. X and Y position inputs: Sets the position of the layer within the image, after applying scale and rotation.
  2. Width and height inputs: Sets the layer's width and height in pixels, as measured before layer rotation is applied.
  3. X-Scale and Y-Scale inputs: Also sets the width and height, but as multiples of the initial width and height instead of as absolute measurements.
  4. Angle input: Sets the layer's angle of rotation.
  5. "Keep aspect ratio" checkbox: If checked, width and height will be adjusted to ensure that the layer's aspect ratio remains unchanged.
  6. Reset button: Reset the layer transformation to whatever it was whenever the transformation tool was selected or the active layer changed, whichever was most recent.
  7. Clear button: Remove all transformations from the layer. This moves the layer to the top-left corner of the image, sets the rotation angle to zero, and resets the layer's size to the actual resolution of its image content.
  8. The active layer, currently being transformed.
  9. An inactive transformed layer. To change which layer is transformed, use the layer panel or layer menu to set it as the active layer.

Selection tools:

Selected content is marked with an animated outline and a transparent red overlay. Outline animation and selection color can be changed in the Settings (F9) under the interface tab.

Selection properties:

  • In the Edit menu, the cut, copy, paste, and clear options act on selected content.
  • The Selection menu provides tools for editing the selection bounds.
  • The brush, draw, eraser, fill, filter brush, smudge and clone stamp can all be set to only make changes within selected areas.
  • All image filters can be restricted to only act on selected content.
  • When the image generation mode is set to "Inpaint" (the default), image generation will only affect selected areas.

Free Selection tool icon Free selection tool (L)

Select areas by outlining them.

Basic controls:

  • Left-click: Add a new point to the new selection outline.
  • Return key, or click the first point: Close the outline and select image content within it, as long as there are at least two other points in the outline.
  • Click and drag any other point: Points within the outline can be adjusted until the selection is closed.
  • Escape key: Cancel the selection, removing any pending selection points.
  • "Q" key: Toggle between selection and deselection.

User interface

Screenshot of the free selection tool controls, with specific elements numbered.

  1. Select/Deselect toggle: Switch between selecting image content and deselecting content.
  2. Clear button: Remove all selections.
  3. Select All button: Select all image content.
  4. "Inpaint Full Resolution" checkbox: Only visible when the Stable Diffusion AI image generator is active. When checked, the image generation area scales down to remove unselected content. See the inpainting guide for more details.
  5. "Inpaint Full Resolution padding" slider: Only visible when the Stable Diffusion AI image generator is active and "Inpaint Full Resolution" is checked. Controls how much extra padding space is included around selected content when inpainting.
  6. An in-progress selection.
  7. Previously selected content. The rectangle around this area shows the cropped bounds used for inpainting selected content when "Inpaint Full Resolution" is checked.

Selection Brush tool icon Selection brush tool (S)

Select content by drawing over it in the image, similar to the brush tool. If using a pressure sensitive drawing tablet, the brush size will scale down with pen pressure.

Basic controls

  • Left-click: Select content within the image.
  • Right-click: Select content with one-pixel brush width.
  • Hold shift and left-click: Select a line from the last place you clicked.
  • Hold Alt while drawing: Force the brush to follow a fixed angle.
  • "[", "]", or mouse scroll wheel left/right: Change the brush size. Hold shift to change size faster.
  • Hold Alt: Increase speed when changing brush size using keyboard keys.
  • "Q" key: Toggle between selection and deselection.

User interface

Screenshot of the free selection tool controls, with specific elements numbered.

  1. Brush size slider: Change the size of the selection brush.
  2. Select/Deselect toggle: Switch between selecting image content and deselecting content.
  3. Clear button: Remove all selections.
  4. Select All button: Select all image content.
  5. "Inpaint Full Resolution" checkbox: Only visible when the Stable Diffusion AI image generator is active. When checked, the image generation area scales down to remove unselected content. See the inpainting guide for more details.
  6. "Inpaint Full Resolution padding" slider: Only visible when the Stable Diffusion AI image generator is active and "Inpaint Full Resolution" is checked. Controls how much extra padding space is included around selected content when inpainting.
  7. Selected content. The rectangle around this area shows the cropped bounds used for inpainting selected content when "Inpaint Full Resolution" is checked.

Rectangle/Ellipse Selection tool icon Rectangle/ellipse selection (R)

Select or deselect rectangular or elliptical regions in the image.

Basic controls

  • Left-click and drag: select a region within the image.
  • Right-click and drag: deselect a region within the image.
  • "Q" key: Toggle between rectangle and ellipse selection.
  • Hold Ctrl: Restricts new selections to a 1:1 aspect ratio.

User interface

Screenshot of the shape selection tool controls, with specific elements numbered.

  1. **Rectangle/ellipse toggle: Switch between selecting/deselecting rectangular and elliptical regions.
  2. Clear button: Remove all selections.
  3. Select All button: Select all image content.
  4. "Inpaint Full Resolution" checkbox: Only visible when the Stable Diffusion AI image generator is active. When checked, the image generation area scales down to remove unselected content. See the inpainting guide for more details.
  5. "Inpaint Full Resolution padding" slider: Only visible when the Stable Diffusion AI image generator is active and "Inpaint Full Resolution" is checked. Controls how much extra padding space is included around selected content when inpainting.
  6. Selected content. The rectangle around this area shows the cropped bounds used for inpainting selected content when "Inpaint Full Resolution" is checked.

Selection Fill tool icon Selection fill tool (A)

Select content based on connected regions and color similarity.

Basic controls

  • Left-click: Select connected areas with colors that match the clicked spot.
  • Right-click: Deselect connected areas with colors that match the clicked spot.

User interface

Screenshot of the fill selection tool controls, with specific elements numbered.

  1. Color threshold slider: Controls how closely colors must match when filling connected areas. At 0.0, only connected areas with the exact same color will be selected. The accepted color range expands as the threshold value increases.
  2. "Sample merged" checkbox: When checked, the fill selection tool will use all image layers to determine where to select. When unchecked, content outside the active layer will be ignored.
  3. "Select all by color" checkbox: When checked, color boundaries will be ignored, and the fill selection tool will instead select every point in the image where the color matches the clicked point. Enabling this will un-check "Fill selection holes".
  4. "Fill selection holes" checkbox: When checked, the fill selection tool will ignore image content entirely, and select/deselect based on existing selection content only. Useful for selecting a hole within an existing selection, or deselecting a connected block of image content. Enabling this will un-check "Select all by color".
  5. "Inpaint Full Resolution" checkbox: Only visible when the Stable Diffusion AI image generator is active. When checked, the image generation area scales down to remove unselected content. See the inpainting guide for more details.
  6. "Inpaint Full Resolution padding" slider: Only visible when the Stable Diffusion AI image generator is active and "Inpaint Full Resolution" is checked. Controls how much extra padding space is included around selected content when inpainting.
  7. Selected content. The rectangle around this area shows the cropped bounds used for inpainting selected content when "Inpaint Full Resolution" is checked.

Image Generation Area tool icon Image Generation Area tool (G)

Controls the area of the image in use for AI image generation. AI generators are restricted to certain resolutions, but this tool lets you use them with images of any size. When you click "Generate", the AI generator will only act on the area selected by this tool, and only content within this area will influence generated imagery. See the inpainting guide for more details.

Basic controls

  • Left-click: Move the image generation area, without changing its size.
  • Right-click: Resize the image generation area, without changing its position.
  • Arrow keys: Move the image generation area.
  • Hold Alt: Increase speed when moving the image generation area using keyboard keys.

User interface

Screenshot of the generation area tool controls, with specific elements numbered.

  1. X-coordinate slider: Sets the position of the generation area's left edge within the image.
  2. Y-coordinate slider: Sets the position of the generation area's top edge within the image.
  3. Width slider: Sets the generation area's width, measured in pixels.
  4. Height slider: Sets the generation area's height, measured in pixels.
  5. "Select full image" button: Move and resize the image generation area so that it covers the entire image.
  6. "Gen. area size to resolution" button: Resizes the image generation area, so that its size exactly matches the AI image generation resolution.
  7. "Image generation resolution" inputs: Sets the resolution used for AI image generation.
  8. "Resolution to gen. area size" button: Update the AI image generation resolution so that it matches the size of the generation area.