Shapes Tool | InvokeAI Documentation

Shapes Tool

The Shapes tool is a general-purpose filled-shape drawing tool for the canvas. It replaces the old Rectangle tool and adds four shape modes under a single toolbar button:

You can activate the Shapes tool from the canvas toolbar or with the default hotkey U.

Where Shapes Draws

Shapes always draws into the active raster target:

Common Behavior

Transparency Lock

When Transparency Lock is enabled on the active raster layer, Shapes respects it:

Use this when you want filled shapes to recolor, shade, or mask existing painted content without spilling into empty transparent regions of the layer.

Shape Modes

Rect

Drag to draw a rectangle. Hold Shift to constrain to a square. Hold Alt to draw from the center instead of from a corner.

Oval

Drag to draw an ellipse. Hold Shift to constrain to a perfect circle. Hold Alt to draw from the center.

Polygon

Click to place vertices. Click the first point to close and commit the shape. Hold Shift to snap the pending edge to horizontal, vertical, and 45 degree angles.

Freehand

Click and drag to sketch a filled freehand contour. Release the pointer to commit the shape.

Moving and Panning During Drawing

The Shapes tool supports different Space behavior depending on the current mode:

Color Picking While Using Shapes

The Alt key behaves differently depending on the active Shapes mode:

Practical Examples

Summary

The Shapes tool is the fastest way to add filled geometric or freeform regions to canvas layers. Use it for structured fills, mask authoring, and precise subtractive edits without switching away from the current raster target.