Natsura Core Decoration

Base node for creating custom decorations.

The Core Decoration node is the foundation for custom decoration logic.

  • Placeholder: Defines where and how geometry should be attached to the skeleton.
  • Customizable: Allows advanced users to define their own instancing rules.

== Concept ==

=== Deferred Generation ===

Decorations are not geometry yet. They are instructions queued on the graph. The Simulate node executes these instructions to generate the final meshes (leaves, flowers, etc.) after the skeleton is built.

Inputs

Graph: The growth graph.

Parameters

Placement

Mode : Placement strategy: Interval, Per-Step, or End-Point. Controls how decoration positions are distributed along the branch.

Offset : Position offset from the internode. Shifts the decoration placement away from the skeleton centerline.

Orientation : Alignment rules for the decoration: Tangent, Up, or Random. Determines how each instance is oriented relative to the branch.

  • Cluster Decoration Node — Specialized decoration for attaching external meshes (leaves, flowers, fruit) to the skeleton.
  • Surface Decoration Node — Specialized decoration for generating skin or bark geometry.
  • Trunk Decoration Node — Specialized surface decoration optimized for main stems and trunks.
  • Grow Node — Defines where decorations are applied via Decoration sockets.
  • Simulate Node — Executes decoration instructions to generate the final meshes.

@workflow

== Workflow ==

  1. Use this node if the specialized decorators (Cluster Decoration, Surface Decoration) don't meet your needs.
  2. Define placement rules using Mode, Offset, and Orientation.
  3. Connect to a Grow node's Decoration socket.

@notes

  • Consumes standard growth attributes (u, id) to drive placement.
  • This is the base node; for most use cases, the specialized Cluster Decoration and Surface Decoration nodes provide more convenient workflows.