Painting

13 media types — watercolor, oil, ink, bristle strokes, flow lines, mark fields, and scene repaint.

Natural media simulation with 13 layer types covering traditional media (watercolor, oil, ink, charcoal, pastel), brush tools (strokes, fills), and advanced bristle rendering with lighting, atmosphere, and wet-on-wet mixing.

Installation

npm install @genart-dev/plugin-painting

Layer Types

Type ID	Display Name	Description
`paint:watercolor`	Watercolor	Watercolor wash with bleed and granulation
`paint:oil`	Oil	Thick oil paint with impasto texture
`paint:ink`	Ink	Ink wash and line work
`paint:charcoal`	Charcoal	Charcoal texture with smudging
`paint:pastel`	Pastel	Soft pastel with paper grain interaction
`paint:marker`	Marker	Alcohol marker with blending
`paint:spray`	Spray	Spray paint with splatter
`paint:fill`	Fill	Flat color fill with edge variation
`paint:mark-field`	Mark Field	Directional marks following a vector field
`paint:flow-lines`	Flow Lines	Smooth lines tracing a vector field
`paint:bristle-dab`	Bristle Dab	Impressionist short dabs with lighting and wet mixing
`paint:bristle-stroke`	Bristle Stroke	Oil-paint long strokes following vector field
`paint:scene`	Scene	Paint-first rendering: re-renders layers below as bristle dabs

Properties

paint:watercolor

Property	Type	Default	Description
`color`	`color`	`"#3366cc"`	Pigment color
`opacity`	`number`	`0.6`	Wash opacity (0–1)
`bleed`	`number`	`0.5`	Edge bleed amount (0–1)
`granulation`	`number`	`0.3`	Pigment granulation (0–1)
`wetness`	`number`	`0.7`	Paper wetness (0–1)
`layers`	`number`	`1`	Number of wash layers

paint:oil

Property	Type	Default	Description
`color`	`color`	`"#cc6633"`	Paint color
`thickness`	`number`	`0.7`	Impasto thickness (0–1)
`brushSize`	`number`	`20`	Brush size in pixels
`blending`	`number`	`0.5`	Color blending (0–1)
`texture`	`number`	`0.4`	Canvas texture visibility (0–1)

paint:ink

Property	Type	Default	Description
`color`	`color`	`"#000000"`	Ink color
`opacity`	`number`	`0.8`	Ink opacity (0–1)
`spread`	`number`	`0.3`	Ink spread on paper (0–1)
`lineVariation`	`number`	`0.5`	Stroke width variation (0–1)
`type`	`select`	`"brush"`	Ink type: brush, pen, wash

paint:charcoal

Property	Type	Default	Description
`darkness`	`number`	`0.7`	Charcoal darkness (0–1)
`smudge`	`number`	`0.3`	Smudge amount (0–1)
`grainResponse`	`number`	`0.6`	Paper grain interaction (0–1)
`size`	`number`	`15`	Charcoal tip size

paint:pastel

Property	Type	Default	Description
`color`	`color`	`"#ff9988"`	Pastel color
`pressure`	`number`	`0.5`	Application pressure (0–1)
`grainResponse`	`number`	`0.7`	Paper grain interaction (0–1)
`layering`	`number`	`0.4`	Color layering buildup (0–1)

paint:marker

Property	Type	Default	Description
`color`	`color`	`"#ff4444"`	Marker color
`opacity`	`number`	`0.7`	Ink opacity (0–1)
`bleed`	`number`	`0.2`	Edge bleed (0–1)
`overlap`	`number`	`0.3`	Overlap darkening (0–1)

paint:spray

Property	Type	Default	Description
`color`	`color`	`"#000000"`	Spray color
`density`	`number`	`0.5`	Particle density (0–1)
`radius`	`number`	`40`	Spray radius
`splatter`	`number`	`0.3`	Splatter amount (0–1)

paint:fill

Property	Type	Default	Description
`color`	`color`	`"#336699"`	Fill color
`edgeVariation`	`number`	`0.1`	Edge irregularity (0–1)
`opacity`	`number`	`1.0`	Fill opacity (0–1)

paint:mark-field

Property	Type	Default	Description
`field`	`string`	`"noise:0:0.1:3"`	Vector field specification
`count`	`number`	`500`	Number of marks
`markLength`	`number`	`15`	Mark length in pixels
`markWidth`	`number`	`1.5`	Mark width
`taper`	`select`	`"tail"`	none, head, tail, both
`color`	`color`	`"#1a1a1a"`	Mark color
`colorVariation`	`number`	`0.05`	Color variation (0–1)
`opacity`	`number`	`0.6`	Layer opacity (0–1)

paint:flow-lines

Property	Type	Default	Description
`field`	`string`	`"noise:0:0.1:3"`	Vector field specification
`count`	`number`	`100`	Number of flow lines
`steps`	`number`	`80`	Steps per line
`stepSize`	`number`	`2`	Step distance
`lineWidth`	`number`	`1`	Line width
`color`	`color`	`"#000000"`	Line color
`opacity`	`number`	`0.5`	Layer opacity (0–1)

paint:bristle-dab

Property	Type	Default	Description
`field`	`string`	`"noise:0:0.1:3"`	Vector field specification
`colors`	`string`	`'["#3a2a1a","#6b4c2a"]'`	JSON array of colors
`brushWidth`	`number`	`24`	Brush width (4–120)
`bristleCount`	`number`	`12`	Bristle count (4–40)
`dabLength`	`number`	`20`	Dab length (4–100)
`overlapDensity`	`number`	`0.6`	Overlap density (0.1–2.0)
`paintLoad`	`number`	`0.7`	Paint load (0–1)
`pressure`	`number`	`0.65`	Pressure (0–1)
`texture`	`select`	`"smooth"`	smooth, dry, rough, stipple, feathered, impasto
`colorMode`	`select`	`"single"`	single, lateral, along, loaded, random, split, streaked, rainbow, complementary, analogous, temperature, loaded-knife
`lightAngle`	`number`	`315`	Light angle (0–360°)
`lightElevation`	`number`	`0.5`	Light elevation (0–1)
`shadowDepth`	`number`	`0.3`	Shadow depth (0–1)
`highlightStrength`	`number`	`0.25`	Highlight strength (0–1)
`atmosphereStrength`	`number`	`0`	Atmosphere effect (0–1)
`wetness`	`number`	`0`	Wet-on-wet mixing (0–1)
`mixStrength`	`number`	`0.5`	Mix strength (0–1)
`opacity`	`number`	`0.65`	Layer opacity (0–1)

paint:bristle-stroke

Same property set as paint:bristle-dab with these differences:

Property	Type	Default	Description
`strokeSteps`	`number`	`40`	Steps per stroke (10–200)
`strokeCount`	`number`	`300`	Number of strokes (20–2000)
`opacity`	`number`	`0.5`	Layer opacity (0–1)

paint:scene

Re-renders all layers below as bristle dabs. Uses the same brush, lighting, and atmosphere properties as paint:bristle-dab but samples colors from the composite image.

Property	Type	Default	Description
`field`	`string`	`"noise:0:0.1:3"`	Vector field specification
`brushWidth`	`number`	`16`	Brush width (4–80)
`bristleCount`	`number`	`8`	Bristle count (3–30)
`overlapDensity`	`number`	`0.8`	Overlap density (0.2–2.0)
`colorJitter`	`number`	`10`	Color jitter (0–60)
`flowInfluence`	`number`	`0.8`	Flow field influence (0–1)
`lightAngle`	`number`	—	Light angle (0–360°)
`atmosphereStrength`	`number`	`0`	Atmosphere effect (0–1)
`wetness`	`number`	`0`	Wet-on-wet mixing (0–1)
`opacity`	`number`	`0.6`	Layer opacity (0–1)

Vector Field Specification

All field-based layers accept a field string shorthand:

"noise:seed:scale:octaves" — Perlin noise field
"linear:angleDeg:magnitude" — Uniform directional field
"radial:cx:cy:diverge|converge" — Radial field
"vortex:cx:cy:radius" — Vortex/spiral field
"algorithm:channelName" — Channel from sketch algorithm

MCP Tools

Tool	Description
`paint_layer`	Add a media layer (watercolor, oil, gouache, ink, pastel, charcoal)
`get_paint_field`	Read the vector field on a painting layer
`update_paint_field`	Update vector field specification
`generate_field_from_points`	Generate field via RBF interpolation from control points
`brush_stroke`	Add brush strokes to a stroke layer
`list_brushes`	List available brush presets
`create_brush`	Create a custom brush preset
`erase_strokes`	Erase strokes from a stroke layer
`fill_region`	Add a fill region to a fill layer
`update_fill`	Update fill region properties
`list_fill_presets`	List available fill presets
`add_mark_field`	Add a mark-field layer
`add_flow_lines`	Add a flow-lines layer
`add_bristle_dab`	Add a bristle-dab layer
`add_bristle_stroke`	Add a bristle-stroke layer

Example

{
  "tool": "design_add_layer",
  "arguments": {
    "type": "paint:bristle-dab",
    "properties": {
      "field": "noise:42:0.08:3",
      "colors": "[\"#8b4513\",\"#d2691e\",\"#228b22\"]",
      "brushWidth": 18,
      "overlapDensity": 0.8,
      "texture": "impasto",
      "colorMode": "loaded",
      "lightAngle": 315,
      "shadowDepth": 0.4
    }
  }
}

Painting

On this page