This page provides information about the V-Ray Scatter component in Grasshopper.
Overview
Creates instances of the input V-Ray Geometry with random transformations, optionally with collision avoidance. The number of scattered instances depends on the density. Density is calculated by the number of instances per square unit.
Input Parameters
Seed (Integer) – Controls the random seed of the scatter. Changing this value and refreshing gets you a different random distribution.
Collisions (Boolean) – When enabled, bounding boxes of instances that overlap other instance bounding boxes are skipped.
Density (Number) – Determines the approximate count of instances in a square unit. The density value can be used with a texture in place. Black color texture discards all instances in the area. Areas colored with white receive maximum density.
Map (AColorTex) - Specifies a texture map for the probability of an instance to appear at given point on the host's surface. Black color in the texture discards all instances in the area. Areas colored with white will receive maximum density.
Axis Filter (Integer) – Filters the faces used for instance positioning.
All Faces – The points/instances are generated uniformly on all object faces.
Facing Up – The points/instances are placed only on object faces oriented upwards in the scene. Note that host component transformations are ignored.
Orientation (Integer) – Sets the initial orientation of the instances.
World Up – All instances are positioned upright independent of the base/host surface face normals.
Along Normals – The instances are oriented based on the base surface face normals.
Rotation (Domain) – Sets a range for the minimum and maximum angle for the random instance rotation around its up axis.
Scale (Domain) – Sets a range for the minimum and maximum factors for the random instance scaling.
Origin (Integer) – Determines how objects are positioned relative to the random Scatter points.
Bounding box bottom center – The bounding box bottom center of the object matches the Scatter point.
Bounding box volume center – The bounding box volume center snaps to the Scatter point.
Object origin – The original object origin point snaps to the Scatter point.
Weight (Number) – Determines a list of factors for the relative probability of each guest to appear.
• V Geo (Generic Data) – Sets a list of V Geo objects to scatter.
Host (Generic Data) – Makes a list of meshable geometric objects to scatter the guests over.
Output Parameters
• V Geo (Generic Data) – Sets a V-Ray Geometry output. Can be connected to the V-Ray Render/Geometry slot.
Distribution (Transform) – Sets a data tree of transformations making the guests distribution over the hosts.
Workflow