Disperse (UI)
Please read the below information to learn more about the plugin.
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.
The Statistics Rollup gives live feedback on the polygon count.
- 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.
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
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.
Brush - Multiple Objects
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.
Brush - Delete Objects
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
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.
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.
The list view displays all objects added to Disperse.
Buttons
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.
- 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!
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.
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.
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.
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.
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 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? Left-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.
