genart.dev
Plugins

Distribution

Element distribution patterns — scatter, pack, and flow.

Distribution layers that control how elements are arranged across the canvas using algorithmic placement strategies.

Installation

npm install @genart-dev/plugin-distribution

Layer Types

Type IDDisplay NameDescription
distribution:scatterScatterRandom or seeded distribution of points
distribution:packPackCircle-packing or space-filling layout
distribution:flowFlowFlow-field based element placement

Properties

distribution:scatter

PropertyTypeDefaultDescription
countnumber100Number of scatter points
minDistancenumber10Minimum distance between points
marginnumber0.05Canvas edge margin (0-0.5 normalized)
seednumber0Random seed (0 = use sketch seed)
colorcolor"#00aaff40"Point marker color
showPointsbooleantrueShow distribution points

distribution:pack

PropertyTypeDefaultDescription
countnumber50Number of circles to pack
minRadiusnumber5Minimum circle radius
maxRadiusnumber80Maximum circle radius
paddingnumber2Space between circles
iterationsnumber500Packing algorithm iterations
colorcolor"#00aaff40"Circle outline color

distribution:flow

PropertyTypeDefaultDescription
resolutionnumber20Flow field grid resolution
noiseScalenumber0.005Perlin noise scale
lineCountnumber200Number of flow lines
lineLengthnumber50Maximum line segment length
colorcolor"#00aaff40"Flow line color
seednumber0Random seed (0 = use sketch seed)

MCP Tools

ToolDescription
design_add_scatterAdd a scatter distribution layer
design_add_packAdd a circle-packing distribution layer
design_add_flowAdd a flow-field distribution layer

Example

{
  "tool": "design_add_layer",
  "arguments": {
    "type": "distribution:pack",
    "properties": {
      "count": 80,
      "minRadius": 8,
      "maxRadius": 60,
      "padding": 4,
      "color": "#e6394650"
    }
  }
}