74min

Disperse (UI)

Screenshot of the Disperse rollout.
Screenshot of the Disperse rollout.

Please read the below information to learn more about the plugin.

Document image

The Disperse logo displays the SiNi version number and if there is an update available. The show checkbox when checked displays the plugin icon in the viewport. You can adjust the logo size if required.

Tip - Disperse plugin help

Clicking on the question mark in the header will open this help document page.

01. Statistics Rollup

Document image

The Statistics Rollup gives live feedback on the polygon count.

02. Display Rollup

Document image
Viewport display settings
Viewport display settings
  • Force Display Type - check this box to force the display to the selection.
  • Select the display of objects dropdown - select from the list.
  • Point Cloud Vertices Percentage - defines the number of points.
  • Independent object display dropdown - select an object to isolate it from the list.
  • Select All - selects all the Disperse objects.
  • Update All - updates all the Disperse objects and refresh draws the viewport.

Tip - Viewport display settings

For heavy scenes, with millions of polygons, we recommend setting this to Pyramid.

03. Painter Rollup

Document image

See below for brush settings.

Painter Hot Keys

Control 1 - single brush. Control 2 - multi brush. Control 3 - erase brush. Control 4 - replace brush. Control Alt - scales the brush size smaller. Control Shift - scales the brush size larger. Control - hold down to lock direction when angle snap is defined.

Select the objects you wish to include in your paintbrush. By default it paints all.

Brush - Single Objects

Document image

Single objects brush

  • If no objects are selected in the list it will paint all within the brush size.
  • Brush Size - defines the brush size.
  • Collision Distance - define the collision distance.
  • Angle Snap - sets the angle to rotate snap to.
  • Object Paint Percentage - defines the percentage of objects within the brush selection.
  • Paint on Self - tick the checkbox if you want to paint objects on themselves. See below.
Painting a single object with angle snap.
Painting a single object with angle snap.
Single object with Paint on self checked.
Single object with Paint on self checked.

Brush - Multiple Objects

Document image

Multiple objects brush

  • If no objects are selected in the list it will paint all within the brush size.
  • Brush Size - defines the brush size.
  • Collision Distance - define the collision distance.
  • Paint Amount - sets the density of objects.
  • Paint Falloff - currently disabled.
  • Object Paint Percentage - defines the percentage of objects within the brush selection.
Painting multiple objects.
Painting multiple objects.
Define the percentage of object instances in a multi-brush.
Define the percentage of object instances in a multi-brush.

Brush - Delete Objects

Document image

Deletes Disperse objects from the scene.

  • If no objects are selected in the list it will erase all within the brush size.
  • Select a single object or selection set to erase selected only.
  • Brush size - defines the brush size.
  • Erase Chance - sets a percentage for culling objects.
  • Erase on self - tick the checkbox if you want to delete items from any Paint-on-Self objects.



Brush - Replace Objects

Document image

Replaces scene objects (not in Disperse), with selected Disperse objects. This positions the Disperse objects at the location of the scene objects. Checkboxes

  • Similar - if checked Disperse finds similar objects, i.e. the same objects with different transforms.
  • Instances - if check, Disperse replaces all the objects instances.
  • Delete Target - if checked the original objects are deleted from the scene.

Replace with multiple Disperse objects

If you select a collection of objects in the list, i.e. cars, you can then select layout objects in the 3D scene (car parks), and Disperse will randomly replace each layout object.

Using replace to create a carpark.
Using replace to create a carpark.

Tip - random transforms

On the sample image above you will see the cars have all been placed in the same direction. At present, Disperse does not add random rotatation. There are two workarounds. - Select the original objects you are going to replace with Disperse and using SiNi's Jumble plugin select randomly the objects and rotate them 180 degrees. When you perform the replace objects they will import randomly! - In Disperse, export to edit mesh or proxy. Then follow the steps above (using Jumble and rotation) to add variation.



Random rotation before replacing.
Random rotation before replacing.

04. Distribute Objects Rollup

Document image

The list view displays all objects added to Disperse.

Buttons

Document image

From left to right

  • Add objects - click to manually pick objects from the scene. Click to stop selecting.
  • Add by name - opens the 3ds Max scene explorer to pick objects.
  • Delete objects - select objects from the list and click to delete.
  • Replace objects - replaces the selected object from the list with another object in the scene. Pick to replace.

Object Management

Tip - double click objects for object management

When you double-click an object in the list the pop up appears. See below for details.

Document image
  • Rename - change the name to easily locate it in the list.
  • ProxSi conversion - Disperse allows you to convert objects into a proxy saved externally. This may be used to keep large scenes lightweight. Objects that are converted have a P symbol placed next to them in the list. To convert back into a Disperse object, open the Object Management and click on Export ProxSi to Object.

Random Transforms

Tick the checkbox to activate transforms. This will expose the right side column meaning you can input (lower) to (higher) numbers. Disperse will use these figures to randomly adjust each instance.

Seed - click seed to re-generate the transformation settings.

Tip - transformations

In the list panel - if All Objects is selected this will apply global settings to all objects in the list, ignoring their individual settings. Selected objected - if you select a single object, you can adjust independently its transforms.

Animation Offset - disabled

At present, the animation settings are disabled meaning Disperse will ignore any animation information in the model. We aim to address this in time!

05. Colour and Texture Variation Rollup

Document image

Apply variation to selected objects.

Tick checkbox to activate. Click on the Seed button to apply random seeding.

Variation count - Up to 500 colour variations.

Diffuse and texture colour adjustment sliders.

  • Hue shift - adds hue variation.
  • Saturation - adds saturation variation.
  • Brightness - adds brightness variations.
  • Contrast - adds contrast variations.
Colour and texture variation. Left - off. Right - on.
Colour and texture variation. Left - off. Right - on.

Tick checkbox for material name filtering Texture Name - select the material name you want to apply to. Click the plus (+) to add.

Include/Exclude Select the option you prefer. For example on a tree, you may want to exclude the bark material.

06. Exclusion Splines Rollup

Document image

Exclusion splines are used to mask out areas to exclude from the calculation. To use, click on the bottom right button to select the spline or splines you wish to use. To remove a spline, select it in the display box and click the delete button below.

07. Camera Clipping Rollup

Document image

Tick enable to cull 3D geometry outside the camera field of view.

  • Active View Camera - use the active camera.
  • Selected Camera - click to select the camera. - Pick Camera - Pick the camera to use.
  • F.O.V Expansion - field of view expansion. Increasing this widens the cull point to includes objects that may cast shadows in the camera view. See the below image for reference.
Top - not active. Mid - active. Bot - expansion adjustment.
Top - not active. Mid - active. Bot - expansion adjustment.

08. Export Rollup

Document image

Export options

  • Export normally - exports as an edit mesh.

Export to Multi Mesh This exports each 3D object as a collapsed (combined) single object.

Export to Single Objects This exports each 3D object as an individual object and creates instances. Full Mesh (greyed out) - By default, exporting is set to full display resolution.

  • Export as ProxSi - exports each 3D object in ProxSi proxy format. ProxSi
  • Export as V-Ray proxy - exports each 3D object in V-Ray proxy format.
  • Export as Corona proxy - exports each 3D object in Corona proxy format.

All proxy formats export and save instances.

If you select one of the proxy formats you have the option to select the display settings.



ProxSi

V-Ray

Corona

Logo







Pyramid







Bounding Box







Squirrel







Point cloud







Preview Edges







Preview Faces







Wireframe Box







Half mesh







Full mesh











Tip - rearrange the Disperse Rollups

Did you know you can rearrange the Rollups to your preferred workflow? Right-click on the dot grid in the top right corner of each Rollup and hold down to move or right-click to open the config tab.

Disperse Rollup config.
Disperse Rollup config.



Updated 29 Oct 2021
Did this page help?
Yes
No