Skip to content
ArcBrush ArcBrush Docs

Shape

Node icon
Generator

Generates geometric shapes (rectangle, circle, ellipse, polygon, or star) with optional fill and stroke.

The Shape node creates crisp geometric primitives using signed distance fields (SDFs). Choose from rectangle, circle, ellipse, polygon, or star, then configure fill color, stroke width, and alignment.

Shapes are useful for generating masks, creating simple graphics, or as structural elements in procedural workflows. The SDF approach means edges are always mathematically sharp, with no aliasing artifacts.

Parameters

Section titled “Parameters”

Pins

Size RefSize Reference
InputOptional
ImageImage
Output
AlphaMask
Output

Shape

Shape TypeChoice
Default: Circle

Shape to rasterize

  • RectangleA rectangle with optional rounded corners.
  • CircleA perfect circle that fills the bounding box.
  • EllipseAn oval that stretches to fill the bounding box.
  • PolygonA regular polygon with a configurable number of sides (3–32).
  • StarA star shape with configurable point count and inner radius.
RotationNumber
Default: 0.0 Range: 0.0–360.0
All shapes except Circle

Clockwise rotation of the shape in degrees

Shape Width (%)Integer
Default: 100 Range: 1–100
Tile layout only

Shape width as a percentage of the cell width

Shape Height (%)Integer
Default: 100 Range: 1–100
Tile layout, rectangle/ellipse only

Shape height as a percentage of the cell height

Lock Shape to OutputToggle
Default: true
Single layout only

Keep the shape bounding box equal to the output image size

Shape WidthInteger · px/%
Default: 512 Range: 1–8192 px / 0–100%
Single layout, Lock Shape off

Shape bounding box width

Shape HeightInteger · px/%
Default: 512 Range: 1–8192 px / 0–100%
Single layout, Lock Shape off, rectangle/ellipse only

Shape bounding box height

Corner RadiusInteger · px/%
Default: 0 Range: 0–2048 px / 0–100%
Rectangle only

Rounded corner radius

SidesInteger
Default: 6 Range: 3–32
Polygon only

Number of sides for the regular polygon

PointsInteger
Default: 5 Range: 3–16
Star only

Number of points on the star

Inner RatioNumber
Default: 0.40 Range: 0.01–0.99
Star only

Inner radius ratio. 0.01 = spiky, 0.99 = almost circular

Layout

LayoutChoice
Default: 0 Range: Single / Tile

Single: one shape at a position. Tile: repeat in a grid

ColumnsInteger
Default: 4 Range: 1–32
Tile layout only

Number of columns in the tile grid

RowsInteger
Default: 4 Range: 1–32
Tile layout only

Number of rows in the tile grid

SpacingInteger · px/%
Default: 0 Range: 0–200 px / 0–100%
Tile layout only

Gap between grid cells

PaddingInteger · px/%
Default: 0 Range: 0–500 px / 0–100%
Tile layout only

Margin around the edges of the output image

Output

Width (px)Integer
Default: 512 Range: 1–8192

Width of the output image in pixels

Height (px)Integer
Default: 512 Range: 1–8192

Height of the output image in pixels

Position

Position XInteger · px/%
Default: 256 Range: -8192–8192 px / -100–200%
Single layout, Lock Center off

X position of the shape center

Position YInteger · px/%
Default: 256 Range: -8192–8192 px / -100–200%
Single layout, Lock Center off

Y position of the shape center

Lock CenterToggle
Default: true
Single layout only

Keep the shape centered in the output image; re-centers automatically when the output size or size_ref changes

Fill

FillColor (RGBA)
Default: rgba(255, 255, 255, 255)
Fill on

Fill color

FillToggle
Default: true

Enable solid fill on the shape interior

Stroke

StrokeToggle
Default: false

Enable stroke outline on the shape edge

StrokeColor (RGBA)
Default: rgba(0, 0, 0, 255)
Stroke on

Stroke color

Stroke WidthInteger · px/%
Default: 2 Range: 1–500 px / 0–100%
Stroke on

Stroke thickness

AlignmentChoice
Default: Outside
Stroke on

Whether the stroke grows inside, outside, or centered on the edge

  • InsideStroke grows inward from the shape edge — total size stays the same.
  • CenterStroke straddles the edge — half inside, half outside.
  • OutsideStroke grows outward from the shape edge — total size increases.
Notes

Some parameters are only visible depending on the current settings. Corner Radius only appears for rectangles. Sides only appears for polygons. Points and Inner Ratio only appear for stars. Stroke settings only appear when Stroke is enabled. In Single layout mode you can set the shape size and position. In Tile layout mode you can set columns, rows, and spacing instead.

Usage Tips

Section titled “Usage Tips”
  • Use a Shape with no fill and only a stroke to create ring/outline shapes.
  • Drag the shape directly in the preview to move, scale, and rotate it, instead of typing into the Position and size fields.
  • Star Inner Ratio controls how spiky the star is: 0.01 is very spiky, 0.99 is nearly circular.
  • Combine shapes with Mask From Image to create geometric selections for compositing.
  • Lock Center (on by default) keeps the shape centered as the output size or Size Ref changes; turn it off to reveal Position X/Y and place the shape anywhere.
  • Unlock “Lock Shape to Output” to make the shape smaller than the canvas, then turn off Lock Center to position it off-center.
  • Switch Layout to Tile to generate a grid of shapes with configurable rows, columns, and spacing.
  • Use Corner Radius on rectangles to create rounded rectangles and pill shapes.
  • Connect a Size Ref input to size the output from another image or mask; the width and height controls are disabled while a reference is connected.
Section titled “Related Nodes”