Circular Scatter

Utilities

Scatters input patterns around rings, arcs, and spirals.

Select a node to adjust its parameters. Double-click a node to inspect.

Inputs

pattern_1 (optional)
pattern_2 (optional)
pattern_3 (optional)
pattern_4 (optional)
pattern_5 (optional)
pattern_6 (optional)
pattern_7 (optional)
pattern_8 (optional)
scale_map (optional) : Modulates per-placement scale. Sampled once at each placement center.
mask_map (optional) : Controls which placements are visible. Sampled once at each placement center.
color_map (optional) : Tints each placement by multiplying stamp RGB. Alpha is preserved.

Parameters

Parameter	Type	Default	Range	Description
`pattern_inputs` Pattern Inputs	int	1	1 to 8	Number of pattern inputs used for placement selection.
`amount` Amount	int	16	1 to 64	Number of placements per ring before masking and dropout.
`amount_random` Amount Random	float	0	0 to 1	Varies placement counts independently for each ring. Angular spacing adjusts continuously as the count changes.
`amount_random_minimum` Amount Random Minimum	int	1	1 to 64	Smallest placement count per ring at full Amount Random. Values above Amount increase the count as Amount Random rises.
`spiral` Spiral	float	0	-1 to 1	Radial progression within each ring. 0 keeps a circle; positive starts nearer the center and winds outward; negative starts outside the ring and winds inward. 1 starts at the center.
`rings` Rings	int	1	1 to 16	Number of concentric rings. Ring Spacing redistributes all rings inside Outer Ring Radius.
`ring_spacing` Ring Spacing	float	1	0 to 1	Radial spread of the rings. 0 overlaps them at Outer Ring Radius; 1 distributes them evenly inward.
`ring_spread` Ring Spread	float	1	0 to 4	Angular spread in turns. Placements sit at the centers of equal angular slots: 1 fills a circle, 0.5 fills a half-circle, and 0 collapses the angles. Changes continuously through whole turns.
`outer_ring_radius` Outer Ring Radius	float	0.35	0 to 1	Base radius of the outer ring relative to the shorter image side, before Radius Random and Spiral. 0.5 reaches the image edge.
`radius_random` Radius Random	float	0	0 to 1	Pulls patterns toward the center using each ring's radius. Smaller rings have a tighter random range.
`angle_jitter` Angle Jitter	float	0	0 to 1	Jitters positions around each ring. 1 allows half a placement interval in either direction.
`ring_rotation` Ring Rotation	float	0	0 to 1	Rotates the arrangement in turns. 0 centers the angular spread to the left; positive values rotate clockwise.
`ring_rotation_random` Ring Rotation Random	float	0	0 to 1	Random rotation per ring. 1 allows a full turn.
`ring_rotation_offset` Ring Rotation Offset	float	0	0 to 1	Adds this many turns for each successive inner ring.
`orientation` Orientation	enum	inward		Base orientation of each pattern before Rotation is applied. `fixed` : All patterns share the same orientation. `inward` : The top of each pattern points toward the center. `tangent` : The top of each pattern follows the clockwise ring direction.
`rotation_pivot` Rotation Pivot	enum	center		Point on each pattern held at its placement position while rotating and scaling. `center` : Anchor the center. `left` : Anchor the middle of the left edge. `right` : Anchor the middle of the right edge. `top` : Anchor the middle of the top edge. `bottom` : Anchor the middle of the bottom edge.
`scale_by_pattern` Scale by Pattern Number	float	0	-1 to 1	Progressively scales placements. Positive makes the first smallest and the last full size; negative reverses this. 0 leaves sizes unchanged. A single placement or ring is unchanged.
`scale_by_ring` Scale by Ring Number	float	0	-1 to 1	Progressively scales placements. Positive makes the first smallest and the last full size; negative reverses this. 0 leaves sizes unchanged. A single placement or ring is unchanged.
`luminance_by_pattern` Luminance by Pattern Number	float	0	-1 to 1	Positive makes the first darkest and the last full brightness; negative reverses this. 0 preserves brightness. A single placement or ring is unchanged.
`luminance_by_ring` Luminance by Ring Number	float	0	-1 to 1	Positive makes the first darkest and the last full brightness; negative reverses this. 0 preserves brightness. A single placement or ring is unchanged.
`luminance_by_scale` Luminance by Scale	float	0	0 to 1	Darkens placements scaled below their base size; larger placements keep their brightness.
`mirror_random` Mirror Random	float	0	0 to 1	Probability of flipping each enabled pattern axis.
`mirror_axes` Mirror Axes	enum	both		Axes eligible for random pattern flipping. `both` : Randomize horizontal and vertical flips independently. `horizontal` : Flip horizontally. `vertical` : Flip vertically.
`scale` Scale	float	0.1	0.01 to 10	Pattern size as a fraction of the shorter image side, independent of Amount and Radius.
`scale_xy` Scale X/Y	vec2	[1, 1]	0.01 to 4	Axis scale multipliers applied after Scale.
`scale_random` Scale Random	float	0	0 to 1	Uniform random stamp scale variation that preserves stamp proportions.
`scale_random_xy` Scale Random X/Y	vec2	[0, 0]	0 to 1	Additional random stamp scale variation split by axis.
`scale_map_strength` Scale Map Strength	float	0	0 to 1	How strongly Scale Map modulates per-placement scale. 0 ignores the map; 1 uses the sampled map value as a scale multiplier.
`scale_map_dimensions` Scale Map Dimensions	enum	x_and_y		Which scale dimensions the Scale Map affects. `x_and_y` : Apply Scale Map to both scale dimensions. `x` : Apply Scale Map to X scale only. `y` : Apply Scale Map to Y scale only.
`rotation` Rotation	float	0	0 to 1	Base stamp rotation in turns.
`rotation_random` Rotation Random	float	0	0 to 1	Random rotation variation in turns. 1 allows a full random turn.
`mask_threshold` Mask Threshold	float	0	0 to 1	Placements with mask values below this threshold are hidden.
`dropout` Dropout	float	0	0 to 1	Randomly removes placements. 0 keeps all placements; 1 removes all placements.
`color_map_strength` Color Map Strength	float	1	0 to 1	How strongly Color Map tints stamp RGB. Alpha is preserved.
`luminance_random` Luminance Random	float	0	0 to 1	Randomly reduces each placement's luminance. 0 preserves the input; 1 assigns each placement a multiplier between 0 and 1. Alpha is preserved.
`pattern_order` Pattern Order	enum	random		How Circular Scatter chooses among pattern inputs. `random` : Choose pattern inputs randomly per placement. `cycle` : Cycle through pattern inputs around each ring. `by_ring` : Use one pattern input per ring, cycling through the inputs.
`overlap_mode` Overlap Mode	enum	max		How overlapping stamps are combined inside Circular Scatter. `max` : Keep the brightest contribution where stamps overlap. `add` : Add overlapping stamp contributions, clamped to the output range. `alpha_composite` : Place each stamp over the previous result, in outer-to-inner ring order. Outputs straight RGBA for downstream blending.
`center_xy` Center X/Y	vec2	[0, 0]	-1 to 1	Offsets the arrangement center horizontally and vertically from the image center. Placements wrap at image edges.
`seed` Seed	float	0	0 to 100	Random seed.
`filter_mode` Filter	enum	bilinear		Texture filtering for pattern inputs. `bilinear` : Sample pattern inputs with bilinear filtering. `nearest` : Sample pattern inputs with nearest-neighbor filtering.

Outputs

output (default format: inherit)