This page provides information about V-Ray Scatter in V-Ray for Rhino.


Overview


The V-Ray Scatter tool creates instances of objects using the surfaces of other objects or splines to generate points.




UI Paths



||Asset Editor|| > Geometries (right-click) > Scatter

||Asset Editor|| > Create Asset > Geometries > Scatter


||V-Ray Objects Toolbar|| > Scatter (left-click) > Make Scatter host from the selection

||V-Ray Objects Toolbar|| > Scatter (right-click) > Remove the Scatter host properties from the selection



Rhino Menus Ribbon

||V-Ray|| > Objects Convert to Scatter Host




Scatter Workflow


V-Ray Scatter consists of two types of objects – Host objects and Guest objects that are scattered over the Host object's surface. There are several ways to create Scatter Host and Guest objects.


Creating Scatter Host Objects

  • Select an object in the viewport. Left-click the Scatter button from the V-Ray Geometry Toolbar to make Scatter host from the selection.
  • Select an object in the viewport. Go to the V-Ray menu > Objects > Convert to Scatter Host
  • Select an object in the viewport. Open the Asset Editor > Geometry > Scatter and use the Apply to Selection option.





Creating Scatter Guest Objects

  • Select an object in the viewport and use the Add Guests button in the Asset Editor. The object appears under the Add Guests button.




Scatter


Scatter – Enables Scatter.

Add Guests – Adds the currently selected scene objects to the Guests list. The objects in this list are scattered on the base geometry.

Probability – Determines the relative probability of the guest to appear. For more information see the Probability Example below.

Guest Origin – Determines how the objects are positioned relative to the random Scatter points.

Bounding box bottom center – The bounding box bottom center of the object.
Bounding box volume center – The bounding box volume center snaps to the instance.
Object origin – The original object origin point snaps to the instance point.

Preview Mode – Changes between a bounding box or point preview for the instances. Note that the point positions are determined by the origin of the guest.

Preview Percentage – Limits the number of previews displayed in the viewport.


Rhino8_VRay6.2_Scatter_Guest_Parameters



Probability Example


This is an example of introducing multiple Guest objects with different probability settings to one Host object.



Scatter_Asset_Editor_Guest_List



Parameters


Scattering Mode – Specifies the guest objects scattering mode.

1D - On Splines – Objects are scattered along splines. When a mesh is added to the guests' list, the items are scattered along all mesh edges.
2D - On Surfaces – Objects are scattered on surfaces. It doesn't matter if the surface is horizontal, vertical, or if it is a complex 3D object
3D - In a Bounding Box – Objects are scattered inside the object's bounding box. Keep in mind that bounding boxes are cube-shaped. Using this mode on a round object, scatters instances in a cube around it. 

Max Count (Limit) – Limits the maximum number of instances.

Seed – Controls the random Scatter seed.

Avoid Collisions – When enabled, instances that would collide with each other get discarded. 


Rhino8_VRay6.2_Scatter_Parameters


Spline Scattering


This submenu is only available when the scattering mode is set to 1D - On Splines.

Spacing – Determines the spacing between instances in world units.

Jitter – Randomly jitters instances along the spline. Each instance has Spacing applied on both sides, except the instances at the end of the spline. The Jitter value is divided between those two Spacings. In order to allow instances to jitter in all their Spacing distance, the Jitter needs to be set to 2.

Offset – Determines what percentage of the Spacing instances are offset in one direction of the spline. When set to 1, all instances replace the one after them, as the offset is equal to the whole value of the Spacing.

Follow spline – Determines how scattered instances are oriented along the spline. Assigning a value of 1, makes instances follow the spline and are oriented along the local tangent direction.


Rhino8_VRay6.2_Scatter_Parameters_Spline


Surface Scattering


This submenu is only available when the scattering mode is set to 2D - On Surfaces.

Mode – Specifies the surface scattering mode.

Random Distribution – Scatters instances randomly on all mesh objects.
UV Grid – Uses UV mapping to scatter instances in regular patterns.



Random Distribution

Instances Count – Gives the total number of instances on all Host objects. Note that adding Area Modifiers or defining Slope Limitation will decrease this number. If the Per Area option is enabled, the scattering is defined by the density.

Per Area – When enabled, the number of instances is determined by the count combined with the size of the host's surface. The value specifies the length of the distribution area's side/edge. If the Count value is set to 1, this number determines the relative density of the instances.

Density – Determines the approximate count of instances based on texture input. Black color in the texture discards all instances in the respective area. Areas colored with white receive the maximum number of instances.

Map Channel – Determines the UV channel.


Rhino8_VRay6.2_Scatter_Parameters_Surface




UV Grid

Pattern – Determines a pattern to use for grid scattering.

Grid – Rectangular grid.
Running Grid – Rectangular grid with every other row offset by half of the grid spacing.
Hexagonal Grid Arranges the instances into hexagons.

Map Channel – Determines the UV channel.

Spacing – Scales the pattern in UV space. When Spacing is set to 1, the pattern occupies the whole space. When Spacing is set to 0.5, the pattern is repeated twice.

Jitter – Determines what percentage of the instances are randomly placed. When Jitter is set to 0, all instances are placed according to the UVW mapping. When Jitter is set to 100, all instances are randomly placed.

Offset – Offsets the pattern by the given value (in percentages). Keep in mind that 0 and 1 Offset give the same result, as 1 moves the pattern by one whole repetition.

Lock – When enabled the values of the V coordinate for Spacing, Jitter and Offset are locked to the U coordinate's values.


Rhino8_VRay6.2_Scatter_Parameters_Surface_UVGrid




Slope Limitation

Limits scattering only to 'slopes' at certain angles. The lower the angle range is set, the smaller the angle at which scattering stops.

Local – The slope limitation is measured according to the up vector of each individual guest object.1
World – The Slope Limitation for all guest objects is measured relative to world up vector.

Angle From – The lower limit of the range outside which instances get filtered out. See the Slope Limitation Angle Example.

Angle To – The upper limit of the range outside which instances get filtered out. See the Slope Limitation Angle Example.


Rhino8_VRay6.2_Scatter_Parameters_SlopeLimitation



Slope Limitation Angle Example

The Slope Limitation Angle removes instances based on the angle of the underlying geometry. This option can be used to remove geometry from steep areas as well as shallow areas.


Angle From = 0.0, Angle To = 45.0

Angle From = 0.0, Angle To= 20.0

Angle From = 5.0, Angle To = 20.0



Bounding Box Scattering


This submenu is only available when the scattering mode is set to 3D -  In a Bounding Box.

Instances Count – Gives the total number of instances on all Host objects. Note that adding Area Modifiers or defining Slope Limitation will decrease this number. If the Per Cubic Volume option is enabled, the scattering is defined by the density.

Per Cubic Volume – When enabled, the number of instances is determined by the count combined with the size of the host's bounding box volume. The value specifies the length of the distribution cube's side/edge. If the Count value is set to 1, this number determines the relative density of the instances.


Rhino8_VRay6.2_Scatter_Parameters_BoundingBox



Transforms



Random Translation


Moves the instances From the given distance To the given distance on the corresponding axis. A map can be attached. If the map is enabled, it overwrites the translation values. RGB maps can be used to control translations in specific axes (Red = X; Green = Y; Blue = Z). Grayscale maps control all axes proportionally.

Step Size – Specifies the random step size.


Rhino8_VRay6.2_Scatter_Parameters_RandomTranslation


Random Rotation


Rotates the instances From the given degrees up To the given degrees continuously. A map can be applied. If it is enabled for a given axis, its rotation values are overwritten by the map. RGB maps can be used to control the rotation of each axes individually ( Red = X; Green = Y; Blue = Z). Grayscale maps control the rotation of all axes proportionally.

Step Size – Specifies the random step size.

Normal Alignment – When a value, different than 0 is entered, the instances are aligned according to the world up 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).

Preserve Rotation – Preserves the original rotation of the objects. This option is always enabled in V-Ray for Rhino.


Rhino8_VRay6.2.2_Scatter_Parameters_RandomRotation

Random Scale


Scales the instances From the given value To the given value continuously. When Uniform scale is enabled, the X axis values are applied on the whole Distribute-on target object. A map can be applied. If it is enabled for an axis, the values of that axis are overwritten. RGB maps can be used to scale axes individually ( Red = X; Green = Y; Blue = Z). Grayscale maps control the scale of all axes proportionally.

Step Size – Specifies the random step size.

Uniform Scaling – When enabled the X axis values are also used for the Y and Z axes.

Preserve Scaling – Preserves the original scaling of the objects. This option is always enabled in V-Ray for Rhino.


Rhino8_VRay6.2_Scatter_Parameters_RandomScale



Area Modifiers


Add Modifier – Specifies objects to be used for generating projected areas of exclusion or inclusion of Scatter guests. These areas are projected along specified axes and determined by the dimensions of objects or splines included in this list. Scatter Area Modifier objects cannot be the same as the Scatter Host objects. Note that Area Modifiers are available only in Surface and Volume Scatter modes.

Operation 

Include – only instances within the projected area are created.
Exclude – only instances outside the projected area are created.

Axis – Determines the plane of the area modifier projection along the X, Y or Z axis.

Falloff Near – Determines the distance from the selected area modifier object where the falloff begins its effect. The falloff range is the gradual fading of the area modifier effect between 100% and 0%.

Falloff Far – Determines the distance from the selected area modifier object where the falloff range ends and the area modifier loses effect.

Scale – Scale factor affecting instances between the Near and Far Falloff distances. The value represents the effect strength at the end of the falloff range.
For example, a value of 0.5 causes instances to have a scale of 0% at the Falloff Near distance gradually increasing to 50% at the Falloff Far distance. Note that a value of 0 negates the falloff effect altogether.

Density – Density factor affecting instances between the Near and Far Falloff distances. The value represents the effect strength at the end of the falloff range. For example, a value of 0.5 causes instances to appear at a density of 0% at the Falloff Near distance gradually increasing to 50% at the Falloff Far distance. Note that a value of 0 negates the falloff effect altogether.


Rhino8_VRay6.2_Scatter_Parameters_AreaModifiers



Scatter in Rhino Properties Panel


The button creates a new Scatter plugin and assigns it to the selection. The  button opens the geometry property panel of the selected Scatter asset in the V-Ray Asset Editor for edition.

Make Unique – Makes the selected instance of a Scatter unique. It creates a new Scatter (copy of the current one) item in the Asset Editor that is linked only to the selected object.

Select Instances – Selects all objects that have an instance of the same Scatter in the viewport.




Notes


  • Starting with V-Ray 5.20.01, V-Ray special objects (Fur/Clipper/Displacement/Mesh Light/Scatter) are not deleted from the Asset Editor, when the last item with the corresponding special object assigned to it, is deleted from the viewport.
  • Scatter Density map currently does not support raytraced textures.
  • 1There is no Local space in Rhino. As a result, this mode uses the World space Up vector. This option is exposed in the UI to ensure interoperability with other V-Ray products where a distinction between local and world positions is valid.