Patterns

29 pattern types — fills, stripes, dots, tiles, Japanese motifs, terrazzo, and custom vector patterns.

Geometric and organic repeat patterns with 29 layer types, 153 presets, and spatial shading. Includes hatching, stippling, tiling, Japanese traditional patterns, and custom vector pattern definition.

Installation

npm install @genart-dev/plugin-patterns

Layer Types

Type ID	Display Name	Description
`patterns:fill`	Fill	Generative fill (hatch, stipple, crosshatch, wave, grid)
`patterns:stripe`	Stripe	Parallel lines with configurable spacing and angle
`patterns:dot`	Dot	Dot grids and scatter patterns
`patterns:checker`	Checker	Checkerboard with configurable cell size
`patterns:wave`	Wave	Sinusoidal wave lines
`patterns:crosshatch-geo`	Crosshatch	Perpendicular line hatching for tonal shading
`patterns:herringbone`	Herringbone	Zigzag interlocking pattern
`patterns:tile`	Tile	Seamless tiling (brick, basketweave, hex, scale, moroccan)
`patterns:custom`	Custom	User-defined vector patterns from drawing commands
`patterns:triangle`	Triangle	Triangle grid pattern
`patterns:diamond`	Diamond	Diamond grid pattern
`patterns:hexagon`	Hexagon	Hexagonal grid pattern
`patterns:star`	Star	Star motif pattern
`patterns:circle`	Circle	Circle/ring pattern
`patterns:japanese`	Japanese	Traditional Japanese patterns (asanoha, seigaiha, shippo, kumiko)
`patterns:lattice`	Lattice	Lattice grid pattern
`patterns:plaid`	Plaid	Overlapping stripe groups
`patterns:cube`	Cube	Isometric cube pattern
`patterns:leaf`	Leaf	Leaf motif pattern
`patterns:floral`	Floral	Floral motif pattern
`patterns:memphis`	Memphis	Memphis-style geometric shapes
`patterns:eye`	Eye	Eye motif pattern
`patterns:spiral`	Spiral	Spiral motif pattern
`patterns:terrazzo`	Terrazzo	Aggregate stone-like scattered colored chips
`patterns:square`	Square	Square grid pattern
`patterns:octagon`	Octagon	Octagon grid pattern
`patterns:scale`	Scale	Fish/dragon scale overlapping arcs
`patterns:chainlink`	Chainlink	Interlocking chain pattern
`patterns:ethnic`	Ethnic	Ethnic decorative patterns

Properties

patterns:fill

Property	Type	Default	Description
`strategy`	`select`	`"hatch"`	Fill strategy: hatch, stipple, crosshatch, wave, grid
`angle`	`number`	`45`	Line angle (0–360°)
`spacing`	`number`	`8`	Line/dot spacing (2–100px)
`lineWidth`	`number`	`1`	Line width (0.5–20px)
`color`	`color`	`"#000000"`	Pattern color
`backgroundColor`	`color`	`"#ffffff"`	Background fill
`region`	`string`	`'{"type":"bounds"}'`	Clip region (bounds, rect, ellipse, polygon)
`opacity`	`number`	`1`	Layer opacity (0–1)

patterns:terrazzo

Property	Type	Default	Description
`style`	`select`	`"classic"`	classic, bold, blob
`size`	`number`	`16`	Chip size (4–80px)
`color1`	`color`	`"#2c3e50"`	Chip color 1
`color2`	`color`	`"#ecf0f1"`	Chip color 2
`color3`	`color`	`"#c0392b"`	Chip color 3
`density`	`number`	`40`	Chip density (5–100%)
`rotation`	`number`	`0`	Pattern rotation (0–360°)
`opacity`	`number`	`1`	Layer opacity (0–1)

patterns:crosshatch-geo

Property	Type	Default	Description
`angle1`	`number`	`45`	First line set angle (0–360°)
`angle2`	`number`	`135`	Second line set angle (0–360°)
`spacing`	`number`	`10`	Line spacing (2–100px)
`lineWidth`	`number`	`1`	Line width (0.5–20px)
`color`	`color`	`"#000000"`	Line color
`backgroundColor`	`color`	`"#ffffff"`	Background fill
`opacity`	`number`	`1`	Layer opacity (0–1)

patterns:tile

Property	Type	Default	Description
`tileShape`	`select`	`"brick"`	brick, basketweave, hex, scale, moroccan
`size`	`number`	`40`	Tile size (8–200px)
`gap`	`number`	`2`	Gap between tiles (0–20px)
`rotation`	`number`	`0`	Pattern rotation (0–360°)
`color1`	`color`	`"#d4c5a9"`	Primary tile color
`color2`	`color`	`"#8b7d6b"`	Background/mortar color
`opacity`	`number`	`1`	Layer opacity (0–1)

MCP Tools

Tool	Description
`list_pattern_presets`	List all 153 presets grouped by category
`add_pattern`	Add a pattern layer by type and preset or properties
`update_pattern`	Update properties on an existing pattern layer
`set_pattern_region`	Clip pattern to bounds, rect, ellipse, or polygon
`set_pattern_shading`	Value-based shading (uniform, linear, radial, noise, algorithm)
`tile_pattern`	Configure tiling shape, size, gap, and colors
`create_pattern`	Define custom vector pattern from drawing commands

Example

{
  "tool": "design_add_layer",
  "arguments": {
    "type": "patterns:terrazzo",
    "properties": {
      "style": "classic",
      "size": 12,
      "color1": "#2c3e50",
      "color2": "#e74c3c",
      "color3": "#f39c12",
      "density": 50
    }
  }
}

Patterns

On this page