genproc: point instancer from curves¶
Point Instancer From Curves
Installation¶
To use this Node, you must enable wip.genproc.core
in the Extension Manager.
Inputs¶
Name 
Type 
Description 
Default 

curvesBundle 

Bundle containing curves data 

prototypesBundle 

Bundle containing prototype data 

instancingMode 

0 = density, 1 = distance, 2 = endtoend 
0 
samplingMode 

0 = uniform, 1 = ramp 
0 
orientationMode 

0 = prefer curve tangent, 1 = prefer up vector, 2 = ignore curve 
0 
propagateUp 

If true, up vectors of instances are transported along curves in a rotationminimizing fashion. If false, up vectors of instances are independent of one another; each instance will ‘try’ (depending on the Orientation Mode) to align with either a global or percurve up direction 
True 
usePerCurveUp 

If true, look for an attribute in the input curves bundle for a percurve up vector for use in place of a global up for instance alignment. 
False 
curveUpAttrName 

Name of attribute in input curves bundle containing percurve up vectors 
curveUp 
rampSampleCount 

Number of points to sample from curve ramp widget 
50 
rampSamplingPositions 

Parametetric values from [0,1] at which sampling density can be specified 
[] 
rampSamplingValues 

Sampling density on the curve. A value of 10 means that we should sample the curve with a step size of 1/10 
[] 
rampSamplingInterpolations 

Interpolation method between keys. Linear is a creates a flat curve from point to point. Smooth creates an ease in or ease out curve from point to point. 
[] 
rampRPositions 

Values from [0, 1] at which rotation blend values can be specified 
[] 
rampRValues 

Blend values from [0, 1] to interpolate between the uniform rotation parameter and random rotations 
[] 
rampRInterpolations 

Interpolation method between keys. Linear is a creates a flat curve from point to point. Smooth creates an ease in or ease out curve from point to point. 
[] 
rampSPositions 

Values from [0, 1] at which scale blend values can be specified 
[] 
rampSValues 

Blend values from [0, 1] to interpolate between the uniform scale parameter and random scales 
[] 
rampSInterpolations 

Interpolation method between keys. Linear is a creates a flat curve from point to point. Smooth creates an ease in or ease out curve from point to point. 
[] 
rampTPositions 

Values from [0, 1] at which translation blend values can be specified 
[] 
rampTValues 

Blend values from [0, 1] to interpolate between the uniform translation parameter and random translations 
[] 
rampTInterpolations 

Interpolation method between keys. Linear is a creates a flat curve from point to point. Smooth creates an ease in or ease out curve from point to point. 
[] 
rampObjIdxPositions 

Values from [0, 1] at which object index values can be specified 
[] 
rampObjIdxValues 

Object index values. Note that the continuous values of these keys will be rounded down to integer values when converted to object indices. 
[] 
rampObjIdxInterpolations 

Interpolation method between keys. Linear is a creates a flat curve from point to point. Smooth creates an ease in or ease out curve from point to point. 
[] 
rampRandIdxPositions 

Values from [0, 1] at which object index blend values can be specified 
[] 
rampRandIdxValues 

Blend values from [0, 1] to specify the likelihood that an object index will be selected randomly rather than taken from the object index ramp 
[] 
rampRandIdxInterpolations 

Interpolation method between keys. Linear is a creates a flat curve from point to point. Smooth creates an ease in or ease out curve from point to point. 
[] 
active 

Whether the node should run its compute 
True 
density 

Constant number of samples to take along each segment of each curve 
10.0 
minimumEndToEndDistance 

Minimum distance between instances when endtoend instancing is used 
10.0 
instanceOnCurveEndpoint 

If true, a final instance will be placed at the end of the curve 
True 
offset 

Constant displacement along the axes of the curve’s local frame 
[0, 0, 0] 
offsetRandom 

Maximum random displacement along the axes of the curve’s local frame 
[0, 0, 0] 
offsetRandomTwoSided 

If true, randomized offsets will be positive or negative with magnitude bounded by ‘Offset Random.’ If false, the sign of randomized offset values will match that of ‘Offset Random.’ 
False 
scale 

Constant scale factor 
[1, 1, 1] 
scaleRandom 

Maximum random scale 
[1, 1, 1] 
rotationOrder 

euler angle rotation order 
0 
rotation 

Euler angle offset from curve frame 
[0, 0, 0] 
rotationRandom 

Maximum random euler angle offset from curve frame 
[0, 0, 0] 
objectPrototypeCount 

Number of object prototypes in the output pointInstancer. Random object indices will not be greater than or equal to this number. 
0 
firstObjectIndex 

Object index of first instance If negative, this value will be ignored and the instance index will be set as usual. 
1 
lastObjectIndex 

Object index of last instance If negative, this value will be ignored and the instance index will be set as usual. 
1 
Outputs¶
Name 
Type 
Description 
Default 

pointInstancerBundle 

output bundle of pointInstancer data 

reload 

Workaround option to force recomputation of output 
False 