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	Bundle containing curves data
prototypesBundle	bundle	Bundle containing prototype data
instancingMode	int	0 = density, 1 = distance, 2 = end-to-end	0
samplingMode	int	0 = uniform, 1 = ramp	0
orientationMode	int	0 = prefer curve tangent, 1 = prefer up vector, 2 = ignore curve	0
propagateUp	bool	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	bool	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	token	Name of attribute in input curves bundle containing per-curve up vectors	curveUp
rampSampleCount	int	Number of points to sample from curve ramp widget	50
rampSamplingPositions	float[]	Parametetric values from [0,1] at which sampling density can be specified	[]
rampSamplingValues	float[]	Sampling density on the curve. A value of 10 means that we should sample the curve with a step size of 1/10	[]
rampSamplingInterpolations	int[]	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	float[]	Values from [0, 1] at which rotation blend values can be specified	[]
rampRValues	float[]	Blend values from [0, 1] to interpolate between the uniform rotation parameter and random rotations	[]
rampRInterpolations	int[]	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	float[]	Values from [0, 1] at which scale blend values can be specified	[]
rampSValues	float[]	Blend values from [0, 1] to interpolate between the uniform scale parameter and random scales	[]
rampSInterpolations	int[]	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	float[]	Values from [0, 1] at which translation blend values can be specified	[]
rampTValues	float[]	Blend values from [0, 1] to interpolate between the uniform translation parameter and random translations	[]
rampTInterpolations	int[]	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	float[]	Values from [0, 1] at which object index values can be specified	[]
rampObjIdxValues	float[]	Object index values. Note that the continuous values of these keys will be rounded down to integer values when converted to object indices.	[]
rampObjIdxInterpolations	int[]	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	float[]	Values from [0, 1] at which object index blend values can be specified	[]
rampRandIdxValues	float[]	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	int[]	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	bool	Whether the node should run its compute	True
density	float	Constant number of samples to take along each segment of each curve	10.0
minimumEndToEndDistance	float	Minimum distance between instances when end-to-end instancing is used	10.0
instanceOnCurveEndpoint	bool	If true, a final instance will be placed at the end of the curve	True
offset	float[3]	Constant displacement along the axes of the curve’s local frame	[0, 0, 0]
offsetRandom	float[3]	Maximum random displacement along the axes of the curve’s local frame	[0, 0, 0]
offsetRandomTwoSided	bool	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	float[3]	Constant scale factor	[1, 1, 1]
scaleRandom	float[3]	Maximum random scale	[1, 1, 1]
rotationOrder	int	euler angle rotation order	0
rotation	float[3]	Euler angle offset from curve frame	[0, 0, 0]
rotationRandom	float[3]	Maximum random euler angle offset from curve frame	[0, 0, 0]
objectPrototypeCount	int	Number of object prototypes in the output pointInstancer. Random object indices will not be greater than or equal to this number.	0
firstObjectIndex	int	Object index of first instance If negative, this value will be ignored and the instance index will be set as usual.	-1
lastObjectIndex	int	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	bundle	output bundle of pointInstancer data
reload	bool	Workaround option to force recomputation of output	False