Cluster Decoration

Attaches external meshes (leaves, flowers, fruit) to the skeleton.

The Cluster Decoration node attaches external geometry (leaves, flowers, thorns, fruit) to the plant. Unlike Surface Decoration, which skins the branch itself, it instances objects onto the skeleton, can deform them to follow branch curvature, and can select between variant inputs by attribute.

Inputs

InputDescription
Input 0: GraphThe growth graph.
Input 1+: GeometryThe meshes to instance (e.g. a leaf model). Multiple inputs can be connected to provide variant geometry.

Attributes

AttributeDescription
uConsumed to drive placement along the branch.
widthConsumed to scale instances to branch thickness.
orientConsumed orientation along the branch.

Outputs

OutputDescription
Output: GraphThe graph with cluster instructions.

Intrinsics

AttributeDescription
instanceInstance attributes on the output points.

Parameters

Placement

ParameterDescription
DensityHow many instances per unit length. Controls the overall coverage of decorations along the branch.
PatternPhyllotaxis arrangement: Spiral, Opposite, or Whorled. Determines the botanical arrangement pattern of instances around the branch.
AlignOrientation rules for each instance: tumbling, facing up, or facing outward from the branch.

Variation

ParameterDescription
ScaleRandomise size of instances. Adds natural variation to the decoration sizes.
Variant AttributeAttribute to drive which input mesh is used. Allows different parts of the plant to receive different geometry variants.

See also: Cluster decoration (feature) · Surface Decoration · Core Decoration