Skip to content
07-848 2005

V-Ray for SketchUp

Scatter

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

Last updated 1 September 2026

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

Overview

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

youtu.be

UI Paths

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

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

SketchUp Menus Ribbon

||Extensions|| > V-Ray > Objects > Scatter over Selection

||Extensions|| > V-Ray > Objects > Scatter Viewer

||V-Ray Objects Toolbar|| > Scatter over Selection

SketchUp2026_VRay7.4.0_Scatter_Toolbar_ScatterOverSeletion.png

||V-Ray Legacy Toolbar|| > Scatter Viewer

SketchUp2026_VRay7.4.0_Scatter_Toolbar_ScatterViewer.png

Accessing Scatter Viewport Preview from the V-Ray Toolbar or the V-Ray Menu in SketchUp 2023 or later versions opens the following notification.

SketchUp2023_VRay6.2_Toolbar_Scatter_ViewerNotification

Preview Overlay

Select V-Ray Object previews to be displayed in the SketchUp viewport from ||V-Ray|| > Overlays > Preview Overlay.

Enable or disable all previously selected V-Ray Object previews from ||Window|| > Default Tray > Overlays > V-Ray Preview.

SketchUp2026_VRay7.3_DefaultTray_Overlays.png
SketchUp2026_VRay7.3_Overlays_PreviewOverlays.png

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. Click the Scatter over Selection button from the V-Ray Geometry Toolbar. The button is inactive until an object is selected in the viewport window.
  • Select an object in the viewport. Go to the Extensions menu > V-Ray > Objects > Scatter over Selection.
  • Select an object in the viewport. Open the Asset Editor > Geometry > Scatter and use the Apply to Selection option.

Creating Scatter Guest Objects

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

Drag and drop – Drag and drop a preselected scene object from the viewport onto the Scatter Host object.

  1. First, make sure the Scatter over Selection is still active after Scatter is applied over the Host object.
  2. Then select the object that will become a Guest.
  3. Drag and drop it onto the Scatter Host object.
SketchUp2026_VRay7.4_Scatter_Create.gif

Scatter Viewport Preview Workflow

Enable the Scatter Viewport Preview from the Overlays tray in SketchUp 2023 or later versions. This provides a visual representation of the scattered objects in the viewport.

SketchUp2026_VRay7.4_ScatterViewportPreview.gif

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 likelihood that the guest will appear. See the Probability examples 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 – Switches between a bounding box and point preview for the instances. Note that the origin of the guest determines the point positions. See the Preview Mode examples below.

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

SketchUp2023_VRay6.2_Scatter_Guest_Parameters

Example: Probability

This is an example of introducing multiple Guest objects with different probability settings into a single Host object.

01_probability_rocksediment_1.jpg
03_probability_rocksediment_10.jpg
04_probability_rocksediment_50.jpg

Example: Preview Mode

This example shows the different preview modes.

00_guests.jpg

Scatter Guest Objects

01_previewmode_none.jpg

Scatter Host Object

02_previewmode_points.jpg

Point Preview

03_previewmode_boundingboxes.jpg

Bounding Box Preview

Example: Preview Percentage

This example shows how the Preview Percentage changes the number of previews displayed in the viewport

01_previwepercentage_0.jpg

Preview Percentage

= 0

02_previwepercentage_25.jpg

Preview Percentage

= 25

03_previwepercentage_50.jpg

Preview Percentage

= 50

04_previwepercentage_100.jpg

Preview Percentage

= 100

Parameters

Scattering Mode – Specifies the guest objects' scattering mode.

1D - On Splines – Scatters objects along splines. When a mesh is added to the guests' list, the items are scattered along all mesh edges.
2D - On Surfaces – Scatters objects 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 – Scatters objects 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 and Multiple Objects examples below.

Seed – Controls the random Scatter seed.

Example: Seed

01_scatter_seed_1.jpg
02_scatter_seed_2.jpg
03_scatter_seed_3.jpg

Avoid Collisions – When enabled, instances that collide with each other are discarded. See the Avoid Collisions example below.

SketchUp2023_VRay6.2_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.

02_maxcount_50_instancescount_5.jpg

Max Count

= 50

Instances

= 5

03_maxcount_50_instancescount_25.jpg

Max Count

= 50

Instances

= 25

04_maxcount_50_instancescount_50.jpg

Max Count

= 50

Instances

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

01_multipleobjects_combinedsurfacearea_instancescount10.jpg

Multiple Objects

02_singleobject_surfacearea_instancescount10.jpg

Single Object

Example: Avoid Collisions

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

01_scatter_avoidcollisions_off.jpg

Avoid Collisions

= Off

03_scatter_avoidcollisions_0x5.jpg

Avoid Collisions

= 0.5

05_scatter_avoidcollisions_2.jpg

Avoid Collisions

= 2

Notes

  • V-Ray 6 provides the option for multiple special objects to be added in combination with a single group/component. This allows for Fur, Scatter, and Displacement special objects to be used simultaneously. Multiple Fur and Scatter assets can be added to a single object.
  • Special objects can be removed from geometry by double-clicking on the group/component, selecting the special object's widget, and then selecting the Erase option from the context menu (right-click to open the context menu).
  • When Mesh Light or Clipper are applied, no other special objects are allowed.
  • The Scatter Density map currently does not support raytraced textures.
  • Curve objects need to be grouped via G shortcut on windows or command + G on macOS to be added as Scatter Area Modifiers.
  • If Scatter is applied to a spline closing a face, its segments (edges of the face) are treated as individual splines.
  • Apply a material with 0 opacity for host objects that you don’t want visible in the rendered image.
  • Scene units in SketchUp are always calculated in inches.

Rollouts

Each Scatter rollout has its own dedicated page listed below: