Skip to content

Painterly

Painterly
Filter

Painterly turns a picture into paint. Every pixel takes the color of the calmest part of the area around it, so fine detail and noise melt into flat strokes while edges stay sharp. With Strokes the strokes turn to follow the edges and forms of the picture, like an oil painting; with Classic they become flat, blocky patches, which also clean up a noisy scan without softening its edges. Relief stands the paint up from the canvas, with bristle grooves and a light, and the Height output carries that paint surface for a material.

A mountain lake photo beside the same picture painted in brush strokes that follow the treeline, the shore and the sky

Wire the picture into Image. Two optional maps steer it: Size sets how big the strokes are, pixel by pixel, and Direction sets which way they run. An optional Mask says where the result shows. Search the node palette for “painterly”, “oil”, “brush strokes”, “gouache”, “impasto” or “kuwahara”.

Image In 1 image photo Painterly 1 imagesizedirectionmask imageheight Look: Painterly
A new Painterly paints strokes that follow the photo's edges at 2 percent of its shorter side.
  1. Wire a photo into Painterly. At its defaults it already paints: strokes sweep along a treeline, curl around a face and run the length of a sky.
  2. Raise Size for broader strokes, or Stroke Length for longer sweeps along the edges.
  3. Pick Oil Paint from Look to stand the strokes up from the canvas, and drag the sun on the Preview to light them from another side.
Eight tiles of one market stall of peppers, carrots and broccoli painted in each look: Painterly, Gouache, Soft Wash, Hatched, Mosaic, Flatten Detail, Oil Paint and Impasto

The Look row at the top of the panel sets the whole look at once: Method, Size, Sharpness, Stroke Length, Direction and Angle, and the Relief rows (Relief, Bristles, Light Angle and Light Elevation). Every look sets all ten, so a flat look picked after Impasto takes the relief off. It leaves Paint Alpha, Edge Mode, Normal Format and the mask rows alone. Change any of those ten rows afterward and Look reads Custom; pick Custom to leave the rows as they are.

LookWhat it paints
PainterlyThe new node’s own settings: strokes along the picture’s edges and forms, Size 2 percent.
GouacheShorter, crisper strokes with harder edges between them.
Soft WashLarger, rounder strokes that blend softly into each other.
HatchedLong, thin strokes all running at one angle (45 degrees), like pen hatching.
MosaicClassic’s flat, blocky patches at a larger size.
Flatten DetailClassic at a small size: flattens grain, noise and scanner speckle and keeps the edges.
Oil PaintThe Painterly strokes standing up from the canvas: Relief 0.5 and Bristles 0.5, lit from the top left.
ImpastoThick, heavy paint: broader, longer strokes at Relief 1 with deep bristle grooves (Bristles 1).

Every look but Oil Paint and Impasto is flat paint: Relief 0, with Bristles, Light Angle and Light Elevation at their new-node values.

Method decides the shape of the area each pixel reads.

  • Strokes (the default) reads an oval that turns with the picture. Along an edge the oval stretches along it, so strokes follow the edge; in a flat area it stays round. This is the painted look.
  • Classic reads four squares around each pixel and takes the calmest one. It ignores direction, so Stroke Length and Direction are grayed. At large sizes it gives flat, blocky patches; at small sizes it is a cleanup filter that flattens noise and grain while keeping edges crisp, good for a scanned plank or a noisy photo before it goes into a material.

Size is how big the strokes are, as a radius, in percent of the picture’s shorter side so a look stays the same at every resolution (or in pixels with the px / % toggle). 0 returns the picture. Sharpness is how crisp the edges between strokes are: at 0 neighboring strokes blend softly, at 1 each pixel keeps only the calmest part. Stroke Length runs from round dabs at 0 to long, thin strokes at 2.

Paint Alpha (off by default) keeps the picture’s alpha as it is; turn it on to paint the alpha too, so a cutout’s edge takes the strokes’ shape. Edge Mode says what the strokes read past the border: Mirror (the default), Clamp, or Repeat, which wraps to the opposite edge so a tiling texture stays tiling, its Relief and Height included.

Dragging Size, Sharpness or Stroke Length, or the Angle arrow, on a large picture redraws a quick reduced preview while you drag and the full result when you let go.

The Preview of a picture on the Oil Paint look at close zoom, the strokes raised with bristle grooves and lit from the top left, with the Light Disk's sun highlighted

The Relief section turns flat paint into thick paint lit from one side. Each stroke becomes a body of paint: lighter paint stands a little thicker, and a ridge rises where one stroke meets the next. The bristles of the brush groove each stroke along its length, and the grooves stop at the stroke’s edge. A light then shades the surface the way Emboss lights its relief: faces toward the light brighten, faces away darken, and a flat area is left exactly as it was.

  • Relief is how much the paint stands up. 0 is flat paint, 0.5 the Oil Paint look and 1 heavy impasto.
  • Bristles is how deeply the brush hairs groove each stroke: 0 smooth paint, 1 deep grooves.
  • Light Angle is the direction the light comes from: 0 is right, 90 up and 135 the top left.
  • Light Elevation is how high the light stands: 0 grazes the surface so every bristle catches it; higher lights the tops of the strokes and softens the shadows.

While Relief is above 0, a Light Disk on the Preview shows the light as a sun. Drag the sun around the disk to set the angle, toward the center to raise it and toward the rim to lower it. A relief looks the same in an 8-bit and a 32-bit document.

Height is the paint’s surface as a single-channel data map: 0.5 is the canvas, higher is thicker paint and the ridges between strokes, lower is the bristle grooves. It is 32-bit float in every document and opaque, and it carries the surface at full strength whatever Relief is, so a wired Height shows the paint even at Relief 0; only Bristles shapes it. Painterly computes it only while it is wired or viewed, so an unwired Height costs nothing.

Wire it into Normal Map, or into a Texture’s Height, so 3D Render or Relight lights the strokes themselves. A Noise set to Paper or Wool, blended into the Height, adds a canvas weave under the paint.

The same photo painted twice: strokes that follow the picture's own edges, and strokes that swirl into eddies around a noise map wired into Direction

Direction has four choices.

  • Follow Picture (the default): the strokes follow the edges and forms of the picture itself.
  • Follow Map: the strokes follow the edges and contours of the map wired into Direction. A gray noise there swirls the strokes into eddies; a Gradient makes them run in rings or bands.
  • Flow Map: the red and green of the Direction map set the way each stroke runs, as in Slope Blur’s Flow Map. Normal Format says whether the map has green pointing up (OpenGL) or down (DirectX). Where the map is gray the strokes are round dabs.
  • Fixed Angle: every stroke runs at Angle (0 points right, 90 down), for a hatched or engraved look. An arrow on the Preview shows the angle: drag its tip around the center to set it.

Wiring a map into Direction sets Direction for you, in the same undo step as the wire: Flow Map when the map is a data map with three or more channels (a normal map or a flow map), Follow Map otherwise. Under Follow Map or Flow Map with nothing wired, the strokes follow the picture. A Direction map of another size is stretched to the picture.

A portrait painted with broad strokes everywhere, the face smeared, beside the same portrait painted with a radial Size map that keeps the face sharp while the background dissolves into strokes

A grayscale map wired into Size scales the Size row pixel by pixel: black keeps the picture as it is, white paints at the full Size, and gray paints smaller strokes in between.

Image In 1 image portrait Gradient 1 backgroundmasksize ref image Radial, dark at the face Painterly 1 imagesizedirectionmask imageheight
The face keeps its detail and the background dissolves into broad strokes.

The map is read as its gray values with no color conversion, the way Blur reads its Strength map, and a map of another size is stretched to the picture. Wiring a map into Size while Size is 0 sets Size back to its default, so the map always has something to scale.

Wire a texture set into Image and Painterly paints every map with the same strokes, so the Base Color, Roughness, Normal and Height stay in register. Where each stroke lands is decided from the Base Color (or the set’s first map when it has none). The Normal is renormalized after painting so it stays a direction, and data maps such as Roughness and Height are averaged as raw values.

Relief on a set raises the set’s Height map and bends its Normal by the paint’s surface instead of lighting the Base Color, so 3D Render lights the strokes itself; Light Angle and Light Elevation gray out. A set with no Height or Normal map gains neither, and the Height output still carries the surface. Size, Direction and Mask each take a single map and refuse a set; take one map out with Split Texture. See Texture Sets.

A hand-painted stone material on a sphere, every stone laid in with visible, lit brush strokes and no seam where the texture repeats
  1. Make stones: a Voronoi Noise cut into stones by Levels, colored by Gradient Map.
  2. Into Painterly with Edge Mode on Repeat and Relief above 0.
  3. Wire the image into a Texture node’s Base Color, and the Height output through Normal Map into its Normal.
  4. View it in 3D Render with UV Tiling at 2. The strokes wrap across the border, so the material still tiles, and the render lights the paint’s ridges.
An old town street drawn as an ink and wash picture, sepia pen lines along the house fronts, balconies and street lamps over soft washes of color
  1. Paint the photo with the Soft Wash look for the wash.
  2. Wire the same photo, not the wash, into Edge Detect set to Flow Lines, with a dark Edge Color over a white Background Color.
  3. Multiply the lines over the wash with Composite. The white drops out and only the ink shows; the lines follow the forms and stay off a smooth sky. Raise Threshold for fewer, bolder lines.
The painted basket of apples beside the same painting laid in with soft brush dabs that run along each apple's curve and take its painted color

Wire the painted result into a Scatter’s background, direction (with Follow on Along Edges) and color (Color Mode switches to Tint), with a soft brush-dab stamp. Each dab runs along the form under it and takes the painted color where it lands.

Pick the Flatten Detail look. Grain and speckle flatten into clean, flat areas and the edges stay crisp, unlike Blur’s Median, which rounds corners.

A gray Noise into Direction switches it to Follow Map and the strokes curl around the noise’s hills and hollows. For hatching, pick the Hatched look and drag the Angle arrow.

Pins

ImagePixels or Texture
InputRequired
SizePixels
InputOptional
DirectionPixels
InputOptional
MaskMask
InputOptional
ImagePixels or Texture
Output
HeightMask
Output

Painterly

MethodChoice
Default: Strokes Range: Strokes / Classic

How the picture is painted.

  • Strokes: each pixel takes the calmest part of an oval that turns with the picture, so strokes follow edges and forms.
  • Classic: each pixel takes the calmest of four squares around it, for flat, blocky patches. At small sizes it flattens noise and keeps edges.
SizeNumber · px/%
Default: 2.0 Range: 0.0–1024.0 px / 0–10%

How big the strokes are, as a radius. 0 returns the picture. A connected Size map scales it per pixel: black keeps the picture, white paints at the full Size

SharpnessNumber
Default: 0.75 Range: 0.00–1.00

How crisp the edges between strokes are. 0 blends neighboring strokes softly; 1 keeps only the calmest part, for hard, flat patches

Stroke LengthNumber
Default: 1.00 Range: 0.00–2.00
Grayed under Classic

How far strokes stretch along what they follow. 0 paints round dabs; 2 paints long, thin strokes

DirectionChoice
Default: Follow Picture Range: Follow Picture / Follow Map / Flow Map / Fixed Angle
Grayed under Classic

What the strokes follow.

  • Follow Picture: the edges and forms in the picture.
  • Follow Map: the edges and contours of the connected Direction map; a gray noise swirls them.
  • Flow Map: the red and green of the connected Direction map.
  • Fixed Angle: every stroke at Angle, for a hatched look.
AngleNumber
Default: 45 Range: 0–360
Direction = Fixed Angle

The way every stroke runs, in degrees. 0 = right, 90 = down. Drag the arrow on the canvas

Normal FormatChoice
Default: OpenGL Range: OpenGL / DirectX
Direction = Flow Map

How the flow map was saved. OpenGL has green pointing up, DirectX down

Relief

ReliefNumber
Default: 0.00 Range: 0.00–1.00

How much the paint stands up from the canvas, lit by the light. 0 is flat paint. The Height output carries the paint's surface at any Relief

BristlesNumber
Default: 0.50 Range: 0.00–1.00
Grayed while Relief is 0 and Height is neither connected nor viewed

How deeply the brush hairs groove each stroke, on top of the paint's body. 0 is smooth paint; 1 is deep grooves

Light AngleNumber
Default: 135 Range: 0–360
Grayed while Relief is 0 or the input is a texture set

Direction of the light. 0 = right, 90 = up, 135 = top-left. Drag the sun on the canvas

Light ElevationNumber
Default: 35 Range: 0–90
Grayed while Relief is 0 or the input is a texture set

Height of the light above the canvas. 0 = grazing, every bristle catches it; higher lights the tops of the strokes

Options

Paint AlphaToggle
Default: false

Also paint the alpha, so a cutout's edge takes the strokes' shape. Off keeps the picture's alpha

Edge ModeChoice
Default: Mirror Range: Mirror / Clamp / Repeat

What the strokes read past the border.

  • Mirror: reflects the picture at the border.
  • Clamp: repeats the edge pixel.
  • Repeat: wraps to the opposite edge, so a tiling texture stays tiling.

Mask

Mask FromChoice
Default: Luminance
Color image connected to the mask input

How the connected color image is read as a mask

  • LuminanceRead the image's brightness as the mask. The default.
  • AlphaRead the image's transparency as the mask.
  • RedUse the red channel as the mask.
  • GreenUse the green channel as the mask.
  • BlueUse the blue channel as the mask.
Mask FitChoice
Default: None (native size)
Mask connected

How the mask is sized when it doesn't match the image

  • None (native size)Center the mask at its native size, with no resizing. Unmasked regions are unaffected.
  • StretchStretch the mask to exactly match the image dimensions. May distort the mask shape.
  • Fit (letterbox)Scale the mask to fit inside the image, preserving aspect ratio. Letterboxes where needed.
  • Fill (crop)Scale the mask to fill the image, preserving aspect ratio. Crops edges if aspect ratios differ.
  • Start from a Look, then adjust; the row reads Custom once you change one of the rows it owns.
  • Keep Size in percent so the look survives a change of resolution.
  • Use the Size map to protect a face or a focal point instead of lowering Size everywhere.
  • For a tiling texture set Edge Mode to Repeat before adding Relief.
  • For smoothing that flattens color without strokes, use Blur’s Edge Preserve or Bilateral.