---
title: "Scatter"
canonical: "https://documentation.chaos.com/space/VREVIT/160694600/Scatter"
format: markdown
---
This page provides information about V-Ray Scatter in V-Ray for Revit.


## **Overview**

---



## **UI Paths**

---



## **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.





## **Scatter**

---


## **Parameters**

---

---


### **Example: Max Count**

**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.



---

### **Example: Multiple Objects**

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).



---


### **Example: Avoid Collisions**



## **Rollouts**

---

Each Scatter rollout has its own dedicated page listed below:


> Macro (children)



## **Notes**

---

- <span style="color: #000000">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.</span>
- <span style="color: #000000">When a Revit family is replaced with a V-Ray Scene, the Scatter is ignored.</span>
- <span style="color: #000000">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.</span>
- <span style="color: #000000">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.</span>

---