> generators

Instancer

generators/instancer·v1.3.0
IN:1  OUT:1

The Instancer creates and distributes copies of POP Geometry across Point Clouds, Meshes, or Curves, allowing flexible spatial arrangements and structured distributions. Objects generated by the Instancer are always POPX Geometry – the packed geometry structure used across the POPX system, where each instance is represented by a single point containing its transform attributes.

The Instancer supports two instancing methods: Copy to Points generates POPX Geometry as realized geometry copies, where each instance exists as an independent, modifiable element in the scene. This method is ideal when subsequent modifiers need to deform, transform, or alter the geometry directly. Instancing uses TouchDesigner's built-in GPU instancing, which references the source geometry efficiently without duplicating it in memory. This method is better suited for high-performance workflows where per-instance deformation is not required.

Each instanced object can define its own transform parameters and an optional probability value for random selection. Geometry sources can be added via the Instance Objects sequence or by dragging POPs directly onto the parameter. When instancing onto template geometry, attributes can be copied from the template points, and the Distribution Method parameter controls how instances are placed across the source geometry.

PAGEInstancing
Index Random SeedIndexrandomseedRandom seed for index selection.
Index AttributeIndexattrPoint attribute to use for indexing.
Uniform ScaleGlobuniscaleGlobal uniform scale multiplier.
Points Only (No Instances)PointsonlyOutput only distribution points without instancing geometry.
Output Template AttributesOutputtemplateattrsInclude template attributes in output.
Center InstancesCenterinstancesCenters all instances in world space before instancing, ensuring their origins are aligned to the global scene center.
Unity ScaleUnityscaleNormalizes the scale of all instances to a uniform size, maintaining consistent proportions across different source geometries.
Instance ObjectsInstancesStart of the Sequential Parameter Block managing the input geometry instances for the Instancer.
In POP(s)Instances0popInput POP for the current instance.
Uniform ScaleInstances0localscaleLocal uniform scale multiplier for this instance.
ProbabilityInstances0probabilityProbability weight for selecting this instance when Indexing Mode is set to Random. Higher values increase selection likelihood.
Center InstanceInstances0centerinstanceCenters this specific instance in world space before instancing, aligning its origin to the global scene center.
Unity ScaleInstances0unityscaleNormalizes the scale of this specific instance to a uniform size, maintaining consistent proportions.
PAGEDistribution
Open SettingsOpensettingsOpens the settings panel for the selected distribution type.
Template ObjectTemplateobjectTemplate object for mesh, curve, or point cloud distribution.
Template GroupTemplategroupGroup within template object to use.
Copy Template AttributesCopytemplateattributesCopy attributes from template to instances.
Attributes to CopyAttrstocopySpecific attributes to copy from template.
Reset All Settings to DefaultResettodefaultResets all distribution settings to default values.
PAGESorting
AttributePointattrAttribute to use for sorting.
SeedPointseedSeed for random number generator for randomly-ordered points.
ObjectPointobj3D Object to use when sorting points relative to Object Z-axis.
ReversePointrevAfter sorting points, reverse their order.
ShiftPointshiftEnables offsetting on sorted points.
OffsetPointoffsetShifts the point order by this offset.
PAGECommon
Free Extra GPU MemoryFreeextragpumemFree memory that has accumulated when output memory has grown and shrunk.
Input 0 POP Instance 1
Output 0 POP POPX_out1