Group of primitives on which to generate points.

The overall approach to use when generating points.

When enabled, each voxel in any volume primitives will be scattered on independently, so that changing density in one region of a volume will not affect points generated in another region of the volume, except that point numbers will change and Relax Iterations will still relax nearby points away from each other. This cannot guarantee a specific number of points, so Force Total Count is not supported when this is on.

When enabled, exactly this many points will be generated. Unlike when this is disabled, the generated points may flicker as primitive areas or densities change. This is only an option when Generate is By Density.

Value or multiplier indicating the density of points to generate.

When scattering By Density without a Density Attribute, this is the expected number of points per length unit for curves, per area unit for surfaces, and per volume unit for volumes and tetrahedra. When scattering In Texture Space without a Density Texture, this is the expected number of points in the full unit square. When using a Density Attribute or Density Texture, this is multiplied by those to determine the actual density in physical or texture space, respectively.

This is disabled if Force Total Count is enabled or if Generate is Count per Primitive.

An attribute specifying the density of points to generate, when Generate is By Density. The attribute can be a point, vertex, primitive, or detail attribute, and in the case of point and vertex attributes, the density will be linearly interpolated over the area of the primitive. This is ideal for use with the Paint node. When Force Total Count is enabled, this specifies relative distribution of point density, not actual density.

Don’t use this if the intention is to scatter points on deforming geometry. That is now much easier, faster, and more flexible to accomplish using Scatter with Attribute Interpolate. See the Spiky Deforming Torus example.

When Generate is By Density, this indicates to use the specified value or primitive attribute, instead of the primitive area, when determining the number of points to be generated on each primitive. For example, specify a value of 1 to indicate to use Density Scale and optionally a Density Attribute to indicate the expected number of points to generate on each primitive. The exact number of points will be dependent on the global and primitive seeds, unlike when using the Count per Primitive option, which generates exactly the specified number of points.

When enabled, the density will be treated as an area density instead of a volume density, for volumes for which at least one dimension is just a single voxel.

When Generate is In Texture Space and this is enabled, this will be multiplied by Density Scale to determine the density of points in each area of the unit square of texture space. Max Relax Radius will be in texture space units, so should probably be set quite small, since any points pushed into a black region of the texture map will have the maximum radius.

If specifying a COP path using op: syntax, you can specify a frame number, by appending text like [123], a plane name or two, like {colour} or {colour,alpha}, or an overridden resolution, like (640,480).

The texture attribute to use when scattering with the Density Texture option.

When Generate is Count per Primitive, this is either an integer or the name of an integer primitive attribute indicating the exact number of points to scatter on each primitive.

This is an optional strict limit on the number of points to generate, to avoid fatal accidents. If the number of points that would have been generated exceeds this, a warning will be generated indicating the number of points that would have been generated, and a number of points less than or equal to this limit will be generated, in a roughly similar distribution.

When Generate is In Texture Space, this is a limit on the number of points scattered in the texture space unit square. Barring any repeats in the texture mapping, the number of generated points should be less than or equal to this limit.

When Generate is By Density, this random seed is used for determining the number of points to be generated on each primitive and for generating the points on each primitive, as well as randomizing the order. When Generate is In Texture Space, this is used for determining the number of points scattered in the texture space unit square, generating the points in texture space, and randomizing the order.

When Generate is By Density, this primitive attribute is used for additional random seeds used for determining the number of points to be generated on each primitive and for generating the points on each primitive. When this is disabled, the primitive numbers are used as the primitive seeds. This can be useful for ensuring consistent scattering when primitives with lower primitive numbers than other primitives are added to or removed from the detail.

When enabled, the points will be in random order in the output detail. The disadvantage is that if more points are generated in one area, it will change the order of points in other areas, even though the positions and attributes may stay consistent.

When enabled, points will be relaxed, pushed away from each other, to avoid clumping. This is done gradually, to avoid chaotic behavior and to allow control over how much relaxation takes place. More relaxation iterations results in points that are more separated from each other. A distribution of points in which they are well separated is often called “blue noise”.

In order to approximately maintain variations in density, points are assigned radii inversely proportional to density (for curves), the square root of density (for surfaces), or the cube root of density (for volumes). This may cause problems for areas whose densities are near zero, especially in volumes, when painting density on a surface, or when using a density texture with a black background, since the radius approaches infinity, so the Max Relax Radius must be set appropriately to prevent these unlikely points from pushing nearby points too far.

If Generate is In Texture Space, the points will be relaxed in texture space, so they may appear less relaxed along seams. If Generate is Count per Primitive, each primitive’s points will be relaxed independent of any other primitive, to ensure that the count per primitive remains exact. Points scattered on a volume primitive will not influence points scattered on other volume primitives during relaxation. Points scattered on curves tend to take a few thousand iterations to be evenly spread out completely. Points on one curve will not influence points on another curve during relaxation. Points scattered on either surfaces, tetrahedra, volumes, or curves will not influence points on any of the other three.

When enabled, the point or vertex N attributes in the input geometry will not be used in the relaxation along surfaces, instead the relaxation will be based on the geometric normals of the input geometry. Geometric normals represent the actual shape of the geometry so they tend to produce better results from normals set for aesthetic or hair-grooming purposes.

Point radii will be scaled by this before any relaxing of the points. Specifying a scale less than 1 will increase “clumpiness” of the resulting points, with a value of zero resulting in no relaxation. Specifying a scale greater than 1 may speed up convergence of the relaxation, especially when scattering on curves.

After any scaling, Max Relax Radius will be enforced before any relaxation. Output Radius Attribute will reflect the final radii, if enabled.

This must be set appropriately to prevent outlier points in low-density areas causing problems when relaxing points.

In order to approximately maintain variations in density, points are assigned radii inversely proportional to density (for curves), the square root of density (for surfaces), or the cube root of density (for volumes). This may cause problems for areas whose densities are near zero, especially in volumes, when painting density on a surface, or when using a density texture with a black background, since the radius approaches infinity. This parameter specifies the maximum radius within which points will influence other points.

When Generate is In Texture Space, this will be a radius in texture space, so it should probably be quite small.

When this is disabled, there will still be a maximum radius, which is currently chosen as half the diagonal length of the bounding box of the input geometry when Generate is not In Texture Space, and 1 when Generate is In Texture Space.

When enabled, an attribute will be output indicating the number of the source primitive on which each point was generated. To correctly handle points that may be pushed from one primitive to another during relaxation, this is determined after any relaxation. Enable this and Prim UVW Attribute for use with Attribute Interpolate.

When enabled, an attribute will be output indicating the coordinates of each point in the parameter space of the primitive on which it was generated. To correctly handle points that may be moved during relaxation, this is determined after any relaxation. Enable this and Prim Num Attribute for use with Attribute Interpolate.

When enabled, an attribute will be output indicating the point density at the location of each generated point. To correctly handle points that may be moved during relaxation, this is determined after any relaxation. If Output Radius and Density in Texture Space is enabled, the density will be the density in texture space, i.e. the Density Scale times any Density Texture, else it will be the density in physical space.

When enabled, an attribute will be output indicating a radius corresponding with the point density at the location of each generated point. To correctly handle points that may be moved during relaxation, into areas of different density, this is determined after any relaxation.

These are the radii used during relaxation, except in the case when Generate is In Texture Space and Output Radius and Density in Texture Space is disabled, in which case the radii are scaled after relaxation to represent a physical space scale.

If the radius of a point is larger than Max Relax Radius, it will be limited to that maximum. Unless that limit is hit, for a point on a curve, the radius is exactly 0.5/density. For a point on a surface, the radius is approximately 0.537/sqrt(density). For a point in a volume or tetrahedron, the radius is approximately 0.561/cbrt(density).

When enabled, an attribute will be output assigning a unique integer id to each point. The id attribute tracks original point numbers generated by the scatter even after some points are deleted later.

When enabled, the output radius and density attributes will contain texture space radii and densities. When disabled, they will be physical space radii and densities.

These point attributes or groups will be interpolated from the input geometry and transferred to the generated points.

These vertex attributes or groups will be interpolated from the input geometry and transferred to the generated points in the form of point attributes.

These primitive attributes or groups will be copied from the input geometry and transferred to the generated points in the form of point attributes.

These detail attributes will be copied from the input geometry and transferred to the generated points in the form of point attributes.

These detail attributes will be copied from the input geometry and transferred to the generated points in the form of detail attributes.