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 = end-to-end |
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 rotation-minimizing 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 per-curve up direction |
True |
usePerCurveUp |
|
If true, look for an attribute in the input curves bundle for a per-curve up vector for use in place of a global up for instance alignment. |
False |
curveUpAttrName |
|
Name of attribute in input curves bundle containing per-curve 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 end-to-end 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 |