RandomPrimitiveVariable

Creates a primitive variable containing random values, with a variety of possible distributions.

user

Container for user-defined plugs. Nodes should never make their own plugs here, so users are free to do as they wish.

enabled

The on/off state of the node. When it is off, the node outputs the input scene unchanged.

filter

The filter used to control which parts of the scene are processed. A Filter node should be connected here.

adjustBounds

Adjusts bounding boxes to account for the changes made to the object.

Caution

Adjusting boundings boxes has a performance penalty. If you do not need accurate bounds or you know that the bounds will only change slightly, you may prefer to turn this off.

name

The name of the primitive variable to be created.

interpolation

The interpolation of the primitive variable to be created. Uniform interpolation yields a value per face for meshes and a value per curve for curves.

seed

Seed used to generate the random values. Change this to generate a different set of values from the same inputs.

seedPrimitiveVariable

The name of a primitive variable used to seed the randomness on a per-value basis. Must have the same interpolation as the primitive variable being created.

This is useful for maintaining stable output under changing inputs. For example, an id primitive variable could be used to provide stable results for individual points across a particle simulation where points are added and removed over time. Or P could be used to provide stable results when point order changes.

distribution

The distribution used to generate the random values. This also dictates the type of primitive variable created.

Uniform Int : Generates IntVectorData, uniformly distributed between intRange[0] and intRange[1].
Uniform Float : Generates FloatVectorData, uniformly distributed between floatRange[0] and floatRange[1].
Gaussian : Generates FloatVectorData, normally distributed around mean with the given deviation.
Weighted Choice : Chooses from a fixed number of potential values, each weighted by a probability. Supported value types are bool, int, float, string, V2i, V3f and Color3f.
Hollow Sphere : Generates V3fVectorData, uniformly distributed on the surface of a sphere of the given radius.

intRange

The range of values generated by the Uniform Int distribution, inclusive of both ends.

floatRange

The range of values generated by the Uniform Float distribution.

mean

The mean of the Gaussian distribution.

deviation

The standard deviation of the Gaussian distribution.

choices

The choices that will be randomly selected between based on the seed. These are specified as a list of values and a corresponding list of weights.

choices.weights

The list of weights for the choices. Choices with a higher weight have a greater chance of being chosen.

radius

The radius of the sphere used by the Hollow Sphere distribution.

interpretation

The geometric interpretation of the data generated by the Hollow Sphere distribution. This determines how it is transformed by downstream nodes.