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 01 statistics rollup the statistics rollup gives live feedback on the polygon count 02 display rollup 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 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 04 distribute objects rollup 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! 05\ colour and texture variation rollup 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 06\ exclusion splines rollup 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 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 08 export rollup 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 docid\ zmmsbkmlfe9njycvo2iru 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