Instancer
v1.3.0Summary
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.
Parameters
InstancingmethodcopytopointsInstancinginstancingIndexingmoderandomOrderorderPoint AttributepointattrIndexrandomseedIndexattrTTxTranslateTyTranslateTzRRxRotateRyRotateRzSSxScaleSyScaleSzGlobuniscalePointsonlyOutputtemplateattrsCenterinstancesUnityscaleInstancesInstances0popInstances0localtInstances0localtxTranslateInstances0localtyTranslateInstances0localtzInstances0localrInstances0localrxRotateInstances0localryRotateInstances0localrzInstances0localsInstances0localsxScaleInstances0localsyScaleInstances0localszInstances0localscaleInstances0localpInstances0localpxPivotInstances0localpyPivotInstances0localpzInstances0probabilityInstances0centerinstanceInstances0unityscaleDistributiontypelinearRadialradialSphericalsphericalGridgridHoneycombhoneycombPoint CloudpointcloudMeshmeshCurvecurveOpensettingsTemplateobjectTemplategroupCopytemplateattributesAttrstocopyResettodefaultPointsortnoneBy AttributebyattribRandomseedProximity to PointproxAlong VectorvectorRelative to Object Z-axisobjectPointattrPointuintnotuint4 bits UInt (max 16)uint48 bits UInt (max 256)uint812 bits UInt (max 4096)uint1216 bits UInt (max 65,536)uint1620 bits UInt (max 1 M)uint2024 bits UInt (max 16 M)uint2428 bits UInt (max 268 M)uint2832 bits UInt (max 4 B)uint32PointseedPointproxPointproxxPointPointproxyPointPointproxzPointdirPointdirxVectorPointdiryVectorPointdirzPointobjPointrevPointshiftPointoffsetFreeextragpumemInputs
POPOutputs
POP