> generators

Instancer

generators/instancer·v1.5.1

IN:1 OUT:1

SUMMARY

The Instancer is the main entry point into POPX: it builds a distribution (Linear, Radial, Spherical, Grid, Honeycomb, Point Cloud, Mesh or Curve), optionally sorts the points, and instances one or more input POPs onto them. Each instance is a single packed point carrying its transform, which every POPX modifier downstream can move, rotate, filter or animate.

Copy to Points realizes the geometry as independent copies that later modifiers can deform, while Instancing uses TouchDesigner GPU instancing for high instance counts without duplicating geometry. Each Instance Object has its own transform and Probability, Indexing Mode picks objects at random, in order or from a point attribute, and template attributes can be copied onto the packed points.

PARAMETERS

PAGEInstancing

[+]Instancing Method	Instancingmethod	Determines how instances are created: Copy to Points or Instancing.
[+]Indexing Mode	Indexingmode	Determines how each point picks its object: Random, Order or Point Attribute.
Index Random Seed	Indexrandomseed	Sets the random seed of the object selection.
[+]Index Attribute	Indexattr	Sets the point attribute holding the object index, in Point Attribute mode.
[+]Translate	T	Global translate of the instances in the three axes.
[+]Rotate	R	Rotate all the instances around the X, Y and Z axes. Angles are given in degrees.
[+]Scale	S	Global scale factor for each axis of the instances.
Uniform Scale	Globuniscale	Specifies a uniform scale factor for all the instances.
Points Only (No Instances)	Pointsonly	Output only the distribution points, without instanced geometry.
Output Template Attributes	Outputtemplateattrs	Whether to keep the Scale, Transform and Pivot attributes on the output.
Center Instances	Centerinstances	Enable centering every input object on the origin before instancing.
Unity Scale	Unityscale	Enable normalizing every input object to unit size before instancing.
Instance	Instances	One block per instanced geometry.
In POP(s)	Instances0pop	A reference to the POP for this object.
[+]Translate	Instances0localt	Translate this object locally in the three axes.
[+]Rotate	Instances0localr	Rotate this object locally around the X, Y and Z axes. Angles are given in degrees.
[+]Scale	Instances0locals	The local scale of this object in the three axes.
[+]Pivot	Instances0localp	The local pivot point of this object.
Uniform Scale	Instances0localscale	Specifies a local uniform scale factor for this object.
Probability	Instances0probability	Sets the selection weight in Random mode. Higher values are picked more often.
Center Instance	Instances0centerinstance	Center this object on the origin before instancing.
Unity Scale	Instances0unityscale	Enable normalizing this object to unit size before instancing.

PAGEDistribution

[+]Distribution Type	Distributiontype	Determines how the instances are distributed: Linear, Radial, Spherical, Grid, Honeycomb, Point Cloud, Mesh or Curve.
Open Settings	Opensettings	Opens the settings panel of the selected distribution.
Template Object	Templateobject	Sets the template POP for the Mesh, Curve or Point Cloud distribution.
Template Group	Templategroup	Sets the group of the template to use.
Copy Template Attributes	Copytemplateattrs	Enable copying the template attributes onto the packed points.
Attributes to Copy	Attrstocopy	Sets the template attributes copied to the instances.
Reset All Settings to Default	Resettodefault	Reset all the distribution settings to their defaults.

PAGESorting

[+]Point Sort	Pointsort	Determines how the points are sorted: No Change, By Attribute, Random, Proximity, Along Vector or Object Z.
[+]Attribute	Pointattr	Attribute to use for sorting.
[+]Attrib is UInt	Pointuint	Specify whether the sort attribute is an unsigned integer and what its max value is. Smaller max UInt require fewer passes to sort.
Seed	Pointseed	Seed for random number generator for randomly-ordered points.
[+]Point	Pointprox	The point to sort by proximity to.
[+]Vector	Pointdir	Sort along a line through the origin in this direction.
Object	Pointobj	Sets the 3D Object whose Z-axis the points are sorted along when Point Sort is Relative to Object Z-axis.
Reverse	Pointrev	After sorting points, reverse their order.
Shift	Pointshift	Enables offsetting on sorted points.
Offset	Pointoffset	Shifts the point order by this many points.

PAGECommon

Free Extra GPU Memory	Freeextragpumem	Free memory that has accumulated when output memory has grown and shrunk.
Render Primitives	Renderprimitives	Whether to render the full POPX geometry. When off, only point instances are drawn.

INPUTS

Input 0 POP - Instance 1

OUTPUTS

Output 0 POP - POPX Geometry