voronoi shatter

 

This node lets you fracture particle shape into multiple fragments by using the Voronoi diagram.

 

 

[Inputs]

 

#Particle Stream - This pin requires a particle stream to be connected.

 

#Pass1 - This pin allows you to pass through values directly to the Pass1 output pin.

 

#Pass2 - This pin allows you to pass through values directly to the Pass2 output pin.

 

Enabled - Enable or disable node evaluation.

 

Particle Group - Generated particles will belong this this group. Particles in the input and output group must not be in the same group.

 

Location Type - Choose how seed points are created. The final fragments shape and distribution are based on the seed points. There are three options.

  • Surface: Seed points will be placed on the shape surface.
  • Point Cloud: Seed points will be placed inside a volume.
  • Particle Group: Use particles from different particle group as seed points.

 

Cluster Center Type - Seed points can be grouped around the user defined point. Options presented here will vary depending on the Location Type.

 

  • Location Type: Surface
  • None: Seed points will be placed randomly over the shape surface.
  • Random Surface: Seed points center will be chosen from a random position on the shape.
  • Custom Location: A user defined location.

 

  • Location Type: Point Cloud
  • None: Seed points will be placed randomly over the shape volume.
  • Particle: The input particle location will be the center of the seed point cloud.
  • Random Surface: Seed points center will be chosen from a random position on the shape.
  • Random Volume: Seed points center will be chosen from a random position inside the shape volume.
  • Custom Location: A user defined location.
  • Particle Group: Each particle from the particle group will be used as a cluster center around which seed points will be generated.

 

#Custom Location - A user defined cluster center.

 

Distribution Type - Determines how seed points will be distributed around the cluster center.

  • Uniform: Seed points will be placed uniformly around the cluster center
  • Normal: Seed points will be distributed based on the normal distribution.
  • Concentric: Seed point will be placed concentrically.

 

Number of Clusters - Defines the number of point clusters on the surface or in the volume depending on the Location Type and Cluster Center Type values.

 

Use Selected Faces - If this option is enables, cluster center and seed points will be generated only on selected faces.

 

Display Points - Display all seed points.

 

Seed - A random number generator for the cluster center points placement.

 

 

Voronoi Shatter Examples

 

 

Point Distribution

Available options will depend on the Location Type and Cluster Center Type options.

 

Number of Points - Total number of seed points.

 

Number of Points Var% - Variation of number of points per input particle.

 

Minimum Distance - Points that are within Minimum Distance from other points won't be used for fragmentation. This parameter can be used to avoid too small and tiny fragments.

 

Radius - Maximum seed distance from the Cluster Center position.

 

Radius Var % - Per particle Radius variation.

 

Bias - Point distribution bias that will group particles closer to the cluster center or towards the maximum distance as defined with the Radius parameter.

 

Exclude Outside Radius - Delete points that might end up outside of the user defined Radius.

 

Distribution Type: Normal

 

Mean Distance - A Normal distribution mean distance relative to Radius. A value of 1.0 means that points will be concentrated at the Radius distance from the cluster center.

 

Standard Deviation - A Normal distribution standard deviation relative to Radius. A value of 1.0 would mean that points will be spread distance will be a Radius value. A Value of 0.0 means that all points will be located at exactly Mean Distance.

 

Distribution Type: Concentric

 

Rings Count - A number of rings that will be formed around the cluster center.

 

Angular Jitter % - Jittering added to the angular seed point placement.

 

Distance Jitter % - Jittering added to the distance of the seed point placement.

 

Scale X - Seed point location scale along the world X axis.

 

Scale Y - Seed point location scale along the world Y axis.

 

Scale Z - Seed point location scale along the world Z axis.

 

Scale Var % - Seed point scale variation.

 

Seed - A random number generator for the points placement.

 

 

Fragments

 

Scale X % - Scale fragments along the X-axis.

 

Scale Y % - Scale fragments along the Y-axis.

 

Scale Z % - Scale fragments along the Z-axis.

 

Fragment Gap - Creates a gap between individual fragments. Size of the gap is in particle shape coordinate space which means that shapes will have the same gap width regardless of the scale factor.

 

Fragment Capping - Enable this option if you want to fragment a volume object. Otherwise, resulting chunks will be a 2D surface.

 

Smooth Faces - Enable if you want to assign a smoothing group to capped faces.

 

Select Faces - Enable if you want to flag capped faces as selected.

 

Generate UV Mapping - Enable this option to generate UV mapping on capped faces. Mapping is applied in world scale.

 

UV Scale - UV Mapping scale factor.

 

Custom Material ID - Set custom Material ID for capped faces. If this option is left unchecked then capped faces will have the same material ID as original shape.

 

Material ID - Material ID for capped faces.

 

 

Particles

Life Span - A life span of the generated particle.

 

Life Span Var % - Life Span variation.

 

Inherit Velocity % - Each fragment can inherit the initial object velocity.

 

Speed - User defined fragment speed.

 

Speed Var % - Fragment speed variation.

 

Direction - Fragment velocity direction.

 

Direction Var % - Fragment velocity direction variation.

 

Density - Particle density. Particle mass is computed from shape volume and density.

 

Density Var % - Density variation.

 

Seed - Random number generator seed value.