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.

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.

See below for brush settings.

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.



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

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

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