Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Overview

...

Section
Column
width50%

The V-Ray Scatter creates instances of objects using on the surface of another object to generate pointsa selected object. The most common example is scattering trees and planting on the terrain.

Column
width5%
 
Column
width45%
HTML
<iframe width="560" height="315" src="https://www.youtube.com/embed/xc1kXS1Xa40" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

...

UI Path

...

Section
Column
width5%

 

Column
width35%

Creating Scatter:

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

||V-Ray Asset Editor|| > Create Asset (left-click) > Geometries Scatter

Column
width5%

 

Column
width35%

Assigning Scatter:

||Appearance Manager|| > Families Tab tab > Scatter Tab subtab > Add Scatter Host button (right-click) > Pick Face

Column
width20%

 

...

Workflow

...

Section
If the whole element has already been selected as a Scatter host, it must be removed from the host's list in the Appearance Manager first. After this change, the user can use either a whole element or some of its faces selected at once, as a Scatter host.
Assigning one Scatter to one face and another Scatter to a different

:

  • the scattered objects, which are referred to as Scatter Guests
  • and the object or surface on which the guests are scattered, which is referred to as Scatter Host

V-Ray Scatter is created and filled with guests in the V-Ray Asset Editor. It is then associated with a host from within the Scatter sub-tab of the Appearance Manager Families tab. The scattered objects are visible only at render time.

The V-Ray Scatter asset is found in the Geometry creation menu of the V-Ray Asset Editor.
Once created, use the Add Guests button to add guest(s) to it in one of two ways:

  1. In any Revit view, select a family which you want to scatter and press the Add Guests button. It appears in the Guests List below that button.
  2. Click the Add Guests button. You are prompted to make a selection. Select a single or multiple families. Click the Finish button at the bottom part of the Revit ribbon to finalize the selection and see the families added to the Guests List.

 

face of the same element is not possible.

Column
width50%

The V-Ray Scatter consists of requires associating with two types of objects Host object and Guest objects that are scattered over the Host object's surface.

It is possible to pick some of the faces of a given element and use them as a Scatter host. The Pick Host button appears ||Appearance Manager|| > Families Tab > Scatter Tab > Add Scatter Host button (right-click) > Pick Face.

Scatter Host object can be created from the ||Appearance Manager|| > Families Tab > Scatter Tab > Add Scatter Host button.

Guest objects can be introduced to the Host object by selecting an object in the viewport and using the Add Guests button in the Asset Editor. The object appears under the Add Guests button.

If no object(s) has been selected prior to pressing the Add Guests button or the Pick Face, V-Ray for Revit prompts you to make a selection and then press the Finish button.

UI Text Box
typetip

Select a host object from the list (Appearance Manager > Families tab > Scatter subtab) and press Delete key to delete the host object. 

UI Text Box
typetip
UI Text Box
typetip

When If a Revit family instance or the family itself is deleted, its association with a Scatter as a host which has been added as a Scatter Guest is deleted from the model, it is also deleted from the projectScatter Guests List.

UI Text Box
typenote

When Fur or Displacement geometry is added to the material part of a Scatter guest, it is ignored for both the added guest instance and its scattered instances. The Fur/Displacement is also ignored for the original instance geometry added as a guest

After Scatter is created and guests are added to it, it needs to be applied to a host object. Adding hosts and associating Scatter with them is explained in the following article.

Column
width5%
 
Column
width45%

Click on the gif to enlarge it.

...

Parameters

...

Section
Column
width60%

Besides adding guests, V-Ray Scatter's UI in the Asset Editor includes various parameters that affect how the scattered items are rendered in terms of density and orientation.

Scatter – Turns on/off V-Ray Scatter.

Density – Determines the approximate count of instances in a square meter. When a texture is used, the density value can still be used. Black color in the texture discards all instances in the area. Areas colored with white receive maximum density.

Seed – Controls the random seed of the Scatter. Change the integer value and refresh to get a different random distribution.

Axis Filter – Filters the faces that will be used for instance positioning.

All Faces – The points/instances are generated uniformly on all object faces.
Facing Up – The points/instances are only placed on object faces oriented upwards in the scene. Note that host component transformations are ignored.

Orientation – Specifies 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.

Collision Detection – When enabled, instances with overlapping bounding boxes are discarded. Eliminating collisions reduces the initial density count and may alter the predetermined ratio between multiple guests.

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

 

UI Text Box
typeinfo
 The Scatter scale randomization is disabled by default.

The Scatter Linked files mode Image Removed button specifies how V-Ray scatters coming from linked files are treated. The functionality provides three methods for scatters display with respect to the host file or to the linked file.

Discard – All V-Ray scatters are discarded.
View & Override – Linked V-Ray scatters can be viewed, rendered, or overridden with scatters created in the host project

.

Read-only – Linked V-Ray scatters are rendered but are hidden from the list. An override is not allowed. This mode can be used for reducing the list in the Appearance Manager.

 

Starting with V-Ray 6, a surface(с) from an element can be selected as Scatter host as well as an entire element with the Image Removed button in the Asset Manager.

Left Click – Triggers selection of a whole element.
Right Click – Shows the Pick Face button. Clicking on it triggers selection of a face as Scatter host.

Column
width5%
 
Column
width35%

 Image Removed

 

 Image Removed

Notes

...

Fancy Bullets
typecircle
  • When a Revit family is replaced with a V-Ray Proxy or a Cosmos asset and its instance is associated with a Scatter, the V-Ray Proxy/Cosmos asset is the one that is scattered across the Scatter's Host object associated with the respective replacement.
  • When a Revit family is replaced with a V-Ray Scene, the Scatter is ignored.
  • Currently, only the following family types can be selected as Scatter hosts: Floor, Wall, Roof Ceiling, Curtain System, Curtain Panels, Column, Ramp, Stair, Toposurface, Mass.