Synopsis
 scatter (domain, nPoints, distributionType)
 scatter (domain, nPoints, scatterMean, scatterStddev)
Parameters
 domain—selstr{ surface  volume  scope }—where to distribute the points. Note that volume only works if applied to a closed surface geometry; i.e. the mesh is not closed, the operation falls back to surface.
 nPoints—floatThe number of points to distribute.
 distributionType—selstr{ uniform  gaussian }—the random distribution type.
 scatterMean—selstr{ center  front  back  left  right  top  bottom }— The position in the scope to use as the mean for the gaussian normal distribution. Default value is center.
 scatterStddev—floatThe standard deviation for the gaussian normal distribution. Note that this parameter can also be given in relative coordinates (leading to axisspecific standard deviations according to the dimensions of the scope). Default value is 0.16.
Description
The scatter operation places point shapes in or on the geometry of the current shape. The parameter nPoints determines how many point shapes are created. The first parameter domain chooses where to distribute the points. Two different random distributions can be used (uniform or gaussian; the optional parameter mean describes the center position of the point cluster relative to the current shape. It currently can be either center (default), front, back, left, right, top, or bottom. The optional parameter deviation describes the standard deviation.
Note that this parameter can also be given in relative coordinates (leading to axisspecific standard deviations according to the dimensions of the scope). Per default the value of deviation is set to 0.16.
The scatter operation does not affect the rotation of the children shapes except if the domain is set to surface. Then the children's scopes are oriented such that the ydirection corresponds to the surface normal.
Note:
The children shape's scope sizes are set to 0. The children shape's geometry only contains one vertex, you probably want to insert a geometry using the i() operation.
Examples
Point distribution on a surface
Uniform point distribution on a surface.
 
Gaussian normal point distribution on a surface.
 
Gaussian normal point distribution again; the mean of the distribution is moved to the scope's left side and a smaller standard deviation is used.
