Table of Contents

This section contains information about the V-Ray Scatter 2 Component in V-Ray for Grasshopper.


Overview


Creates instances of the input V-Ray Geometry Guest objects on the Host objects based on various distribution controls. The number of scattered instances depends on the density which is the number of instances per square unit.





Input Parameters


Hosts (Generic Data) – Specifies the object(s), on which the instances will be scattered. Expects V-Ray Geometry (V Geo) input.

Guests (Generic Data) – Specifies object(s) to be scattered on the host object(s). Expects V-Ray Geometry (V Geo) input.

Guest Origin (Integer) – Determines how objects will be positioned relative to the random Scatter points. Bounding box bottom center - the bounding box bottom center of the object will match the Scatter point. Bounding box volume center - the bounding box volume center will snap to the Scatter point. Object origin - the original object origin point will snap to the Scatter point.

Guest Weights (Number) – A list of factors that determine the likelihood of each guest appearing.

Scattering Configuration (Generic Data) - Specifies the Scattering mode based on input from one of the V-Ray Scatter Configuration components. V-Ray Spline Scattering - Objects are scattered along splines. V-Ray Surface Scattering - Objects are scattered on surfaces. It doesn't matter if the surface is horizontal, vertical, or if it is part of a complex 3D object. V-Ray Volume Scattering - Objects are scattered inside the object's bounding box. Keep in mind that bounding boxes are cube-shaped, therefore using this mode on a round object scatters instances in a cube around it.

Max Count (Integer) – Limits the maximum number of instances. Note that this option does not determine how many instances are created. Instead, it serves as a measure to avoid scattering too many instances and causing a crash.

Seed (Integer) – Controls the random seed of the Scatter. Change this integer value to get a different random distribution.

Avoid Collisions (Integer) – If turned on, bounding boxes of instances that overlap any other instance bounding box will be skipped. Note that enabling this option may reduce the overall number of instances.

Collisions Threshold (Number) – Controls the size of bounding boxes used to detect collisions. Smaller values result in denser scattering with some collisions and higher values result in larger distances between instances. Values above 1 mean that the distance between objects is larger than their bounding boxes.

Random Translation (Domain3) – Intervals of minimum and maximum factor for the random instance translation along X, Y, and Z axes.

Translation Step (Number) – Determines a distinct distance between all instances. If the value is left at zero, instances are translated continuously.

Random Rotation (Domain3) – Intervals of minimum and maximum factor for the random instance rotation along X, Y, and Z axes.

Rotation Step (Number) – Determines a fixed angle by which all instances are randomly rotated.

Normal Alignment (Number) – When a value different than 0 is entered, the instances are aligned according to the world Z axis. This is useful when the Host object is curved and the scattered objects need to remain vertical, not follow the curve of the surface. Positive values mean that the instances are aligned to the +Z axis (vertical up) and negative values mean that the instances are aligned to the -Z axis (vertical down).

Random Scale (Domain3) – Intervals of minimum and maximum factor for the random instance scaling along X, Y, and Z axes.

Scale Step (Number) – Determines a proportion of scaling to be applied to all instances. Otherwise, scaling is continuous.

Area Modifiers (Generic Data) – Scatters Guest objects everywhere on the Host objects, except for or exclusively in the areas specified by a V-Ray Area Modifier component.


Rhino8_VRay6.2_GH_Components_Scatter



Output Parameters


V Geo (Generic Data) – V-Ray Geometry output. Can be connected to the V-Ray Geometry input of a V-Ray Render component.





Was this helpful?