Distance

Last update: Thu Feb 26 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

{width="200px"}

Finds the position of the nearest white pixel in a mask and outputs a gradient from that position, or the color at that position in a source image.

This node creates an outward linear fade (gradient) from any pixels in the input max over 0.5 grayscale value.

The expanding outward fade will terminate as soon as it meets another cell: they will never overlap. Internally this is actually calculating and displaying the distance to the nearest pixel > 0.5, with the distance node set as a clamp/maximum.

An optional source map allows for combining the cells with the texture from a secondary input map.

The distance node is not an easy node to master, but it’s main use cases are expanding existing masks in a reliable way (as compared to blurring and adjusting contrast), generating Voronoi-type noise cells, and beveling existing shapes with a sharp, linear profile (that can be remapped later.

See the below examples for more info.

Output connectors

Examples

Parameters

Color mode Boolean

Toggles between a grayscale and a color output image. Also changes the ‘Source input’ input type.

Maximum distance Float

Adjusts the maximum distance for detecting the closest border in the mask, in pixels.

Combine source/distance Boolean

Determine how the optional 'Source input’is combined with the final cells.

Combine: Combines the ‘Source input’ value with the fading linear mask. If the ‘Source input’ input is connected, its value is combined with computed distance.
Only Source: Results in solid color only from the ‘Source input’.

Distance mode Integer

Selects the method computing the distance to the closest border in the extracted mask:

Euclidean: Sum of squared X/Y differences.
Manhattan: Sum of absolute values of X/Y differences.
Chebyshev: Maximum of absolute values of X/Y differences.

Distance mode examples

Input connectors

Mask input Grayscale PRIMARY

A grayscale mask, the borders of which a distance value should be computed. A binary mask is extracted from the image, using a threshold value of 0.5, where all values above this threshold are white and all values below are black.

Source input Color/Grayscale

Optional grayscale image from which the pixel value at the closest border of the ‘Mask input’ should be copied.