Versions Compared

Old Version 5

changes.mady.by.user Lyubomira Toshkova

Saved on

compared with

New Version Current

changes.mady.by.user Kristina Gaytandzhieva

Saved on

Key

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

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

 


Overview

...

Section
Column
width50%60%

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

Column
width5%
 

Column
45%
width35%
Align
aligncenter
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

...

Paths

...

Section
 
Column
width5%
13%


Column
width35%

Creating Scatter:

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

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

 
Column
width5%
4%


Column
width35%

Assigning Scatter:

||Appearance Manager|| > Families tab > Scatter subtab > Add Scatter Host button (left-click)

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

 
Column
width20%
13%

 




Workflow

...

width50%

...

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.



Section
When Fur or Displacement geometry is added to the material of a Scatter guest, it is ignored for the scattered instances. The Fur/Displacement is also ignored for the original instance geometry added as a guest
Column
width35%

Creating Scatter Host Objects

Select an object in the viewport. Go to Appearance Manager > Families tab > Scatter subtab > Add Scatter Host button (leftIt 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.

UI Text Box
type

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

tip

To remove the Scatter from an object, use the Delete keyboard button.



Creating Scatter Guest Objects

Add Guests – Select Guest objects can be introduced to the Host object by selecting an object in the viewport and using use 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
typetipnote

When Fur or Displacement geometry is part of a Scatter guest, it is ignored for both the added guest instance and its scattered instances.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

If the whole element has already been selected a Revit family which has been added as a Scatter hostGuest is deleted from the model, 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 face of the same element is not possible.

UI Text Box
typetip

When a Revit family instance or the family itself is deleted, its association with a Scatter as a host is also deleted from the project.

UI Text Box
typenote

is also deleted from the Scatter Guests List.

Column
width5%


Column
width60%

Image Added


Scatter

...

Section
Column
width60%

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.

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.

 
Column
width5%

Column
width45%

Image Removed

Click on the gif to enlarge it.

 

35%
Image Added


Parameters

...

Section
Column
width60%

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%

 

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. See the Max Count (Limit) example below.

Seed – Controls the random Scatter seed.

Expand
titleClick here for Seed example.
Panel
Image slider
startIndex1
Panel
borderStylenone

01_Scatter_Seed_1Image Added

Seed = 1

Panel
borderStylenone

02_Scatter_Seed_2Image Added

Seed = 2

Panel
borderStylenone

03_Scatter_Seed_3Image Added

Seed = 3

Avoid Collisions – When enabled, instances colliding with each other get discarded. See the Avoid Collisions example below.

Column
width5%

Column
width35%

Image Added


...

Example: Max Count (Limit)
Anchor
MaxCount
MaxCount

Max Count (Limit) is a limit to help avoid creating too many instances and overloading the system. This option has no effect if the Instance Count value is lower than the Max Count value. Depending on the hardware, this limit can be adjusted to ensure smooth performance and avoid excessive memory consumption. At Instances Count - 100, the scattered objects do not exceed the Max Count (Limit) - 50 and the render is the same as when the Instances Count is 50. Scattering Mode = 2D On Surfaces; Max Count (Limit) = 50.

Section
Column
width25%


Column
width50%
Panel
Image slider
startIndex1
Panel
borderStylenone

02_MaxCount_50_InstancesCount_5Image Added

Instances Count = 5

Panel
borderStylenone

03_MaxCount_50_InstancesCount_25Image Added

Instances Count = 25

Panel
borderStylenone

04_MaxCount_50_InstancesCount_50Image Added

Instances Count = 50

Column
width25%



...

Example: Multiple Objects as One - Combined Surface Area
Anchor
MaxCount
MaxCount

Scatter treats multiple host objects as one with combined surface area (or volume). If you set Scatter to produce 100 instances of a guest object over two host objects, it does not produce 100 for each host. Instead, it produces 100 randomly distributed instances over both host objects' combined surface area (or volume).


Before after
afterLabelSingle Object
darktrue
beforeLabelMultiple Objects
Panel
borderStylenone

Image Added

Panel
borderStylenone

Image Added


...


Section
Column
width25%


Column
width50%

Example: Avoid Collisions
Anchor
AvoidCollisions
AvoidCollisions

This example shows how the Avoid Collisions function works. Higher values result in larger distance between instances.

Panel
Image slider
startIndex2
Panel
borderStylenone

01_Scatter_AvoidCollisions_OffImage AddedAvoid Collisions = Off

Panel
borderStylenone

02_Scatter_AvoidCollisions_0x25Image AddedAvoid Collisions = 0.25

Panel
borderStylenone

03_Scatter_AvoidCollisions_0x5Image AddedAvoid Collisions = 0.5

Panel
borderStylenone

04_Scatter_AvoidCollisions_1Image AddedAvoid Collisions = 1

Panel
borderStylenone

05_Scatter_AvoidCollisions_2Image AddedAvoid Collisions = 2

Image Removed

 

Image Removed

 

Image Removed
Column
width25%
Column
width35%




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.

  • Currently, only the following family types can be selected as Scatter guests: Casework, Entourage, Furniture, Furniture Systems, Generic Models, Planting, Site, and Specialty Equipment. It is not allowed to add the V-Ray Decal family as a Scatter guest.
Section
Column
width30%


Column
width40%


Column
width30%
UI Text Box
sizemedium

Next:

Spline Scattering Rollout



Rollouts

...

Each Scatter rollout has its own dedicated page listed below:

Responsivegridmacro
VAlignmentstart
Columns2repeat(2, 1fr)
Columns3width1100px
Columns1repeat(3, 1fr)
Columns1width1740px
Columnsrepeat(4, 1fr)
Columns2width1290px


Div
stylepadding-left: 5px;padding-right: 5px;padding-bottom: 10px;
alignleft
classdashboard
Textboxcard
PageToIncludeSystem Requirements
CardPageLinkSpline Scattering Rollout

Spline Scattering Rollout

Textboxcard
PageToIncludeSystem Requirements
CardPageLinkSurface Scattering Rollout

Surface Scattering Rollout

Textboxcard
PageToIncludeSystem Requirements
CardPageLinkBounding Box Scattering Rollout

Bounding Box Scattering Rollout

Textboxcard
PageToIncludeSystem Requirements
CardPageLinkTransforms Rollout

Transforms Rollout

Textboxcard
PageToIncludeSystem Requirements
CardPageLinkArea Modifiers Rollout

Area Modifiers Rollout

Textboxcard
PageToIncludeSystem Requirements
CardPageLinkArea Modifiers Rollout

Camera Clipping Rollout