Path Instancer

Brief Description

Similar to the Image Instancer Generator but acts on the paths where the modifier is set. Instead of duplicating the rendereed image of the paths, it only duplicates the points of the paths and enables boolean operations between duplicated paths.

Controls

Parameter / Script Name	Type	Default	Function
`Enabled / enabled`	Boolean	On
`Instance Mode / instanceMode`	Choice	Source	- *Source: Instantiate the source sub-paths composition. - Source Sub-Paths*: Instanciate sub-paths independently
`Num. Dimensions / numDimensions`	Choice	1	- 1 - 2 - 3 - 4
`Dimension 1 Size / dim0_size`	Float	3
`Dimension 2 Size / dim1_size`	Float	1
`Dimension 3 Size / dim2_size`	Float	1
`Dimension 4 Size / dim3_size`	Float	1
`Instance Origin / layersOriginMode`	Choice	Global Origin	- *Invividual Origins: Each instance transform is relative to its rectangle position selected by Origin - Global Origin*: The anchor point is global to all elements
`Instance Origin X / originX`	Choice	Center	- *Left* - *Middle Left* - *Center* - *Middle Right* - *Right*
`Instance Origin Y / originY`	Choice	Center	- *Bottom* - *Middle Bottom* - *Center* - *Middle Top* - *Top*
`Instance Transform 1 / transformDim0`
`Accumulate Transform 1 / accumTransform`	Boolean	Off	When checked, each instance have the transform applied as many times as its instance index + 1
`Centered Accumulation 1 / accumCentered`	Boolean	Off	When checked, the accumulation is centered
`Transform First Instance 1 / appliesToFirstInstance`	Boolean	Off	When checked, the instance transform is also applied to the first instance
`Instance Transform 2 / transformDim1`
`Accumulate Transform 2 / accumTransform1`	Boolean	Off	When checked, each instance have the transform applied as many times as its instance index + 1
`Centered Accumulation 2 / accumCentered1`	Boolean	Off	When checked, the accumulation is centered
`Transform First Instance 2 / appliesToFirstInstance1`	Boolean	Off	When checked, the instance transform is also applied to the first instance
`Instance Transform 3 / transformDim2`
`Accumulate Transform 3 / accumTransform2`	Boolean	Off	When checked, each instance have the transform applied as many times as its instance index + 1
`Centered Accumulation 3 / accumCentered2`	Boolean	Off	When checked, the accumulation is centered
`Transform First Instance 3 / appliesToFirstInstance2`	Boolean	Off	When checked, the instance transform is also applied to the first instance
`Instance Transform 4 / transformDim3`
`Accumulate Transform 4 / accumTransform3`	Boolean	Off	When checked, each instance have the transform applied as many times as its instance index + 1
`Centered Accumulation 4 / accumCentered3`	Boolean	Off	When checked, the accumulation is centered
`Transform First Instance 4 / appliesToFirstInstance3`	Boolean	Off	When checked, the instance transform is also applied to the first instance
`Path Index Mode / layerIndexMode`	Choice	Top To Bottom	- *Bottom To Top: Source elements are instanciated from the bottom of the list to the top - Top To Bottom: Source elements are instanciated from the top of the list to the bottom - Random: Source elements are instanciated in a pseudo-random fashion, controlled by the seed - Custom*: Source elements are controlled by the Path Instance Index parameter
`Instance Index / layerIndex`	Float	0
`Path Index Start Offset / layerIndexStartOffset`	Float	0
`Path Index Step / layerIndexStep`	Float	1
`Path Index Wrap / layerIndexWrapMode`	Choice	Loop	- *Clamp* - *Loop* - *Mirror* - *Stop*
`Path Index Seed / layerIndexRandomSeed`	Float	0
`Index Mode / instanceIndexMode`	Choice	Forward	How to iterate through instances. This affects Accumulate Transform, Accumulate Time Offset - *Forward: Instances are iterated from 0 to the total number of instances - 1 - Backward: Instances are iterated from the total number of instances -1 to 0 - Shuffle*: Instances are spawned in a random order, controlled by Shuffle Seed
`Shuffle Seed / instanceShuffleSeed`	Float	0
`Instance Time Offset / timeOffset`	Time	0	Apply a Time Offset to each instance. It is useful when used in combination with Accumulate Time Offset or with a generator using the Instance Index
`Accumulate Time Offset / accumTimeOffset`	Boolean	Off	When checked, each instance have the time offset applied as many times as its instance index + 1
`Accumulate Time Offset Mode / timeOffsetMode`	Choice	Stacking Index	Whether to use the Instance Index or the Stacking Index to accumulate the time offset. Stacking Index is always a distribution between 0 and Number of instances - 1, whereas the Instance Index can be randomized with Index Mode. - *Instance Index* - *Stacking Index*
`Apply Time Offset To First Instance / applyTimeOffsetToFirst`	Boolean	On	When checked and if Accumulate Time Offset is checked, the Time Offset is also applied to the first instance
`Instance Start Time / instanceStartTime`	Time	0	Limits the lifetime of each instance in the range from Instance Start Time + Instance Time Offset for a duration of instance Duration. This is useful mostly to optimize the performances when the Instancer has many instances but visually only a few of them are visible at a given time because they are out of the format. A value of 0 will make all instances live forever (except if themselves they have a time range)
`Instance Duration / instanceDuration`	Time	0	Limits the lifetime of each instance in the range from Instance Start Time + Instance Time Offset for a duration of instance Duration. This is useful mostly to optimize the performances when the Instancer has many instances but visually only a few of them are visible at a given time because they are out of the format. A value of 0 will make all instances live forever (except if themselves they have a time range)
`Boolean Operation / booleanOperation`	Choice	Independent	The boolean operation applied between generated instances - *Ignore* - *Replace* - *Independent* - *Union* - *Intersect* - *Difference* - *Exclude*