Voronoi Attributes

From Fracture FX
(Difference between revisions)
Jump to: navigation, search
m (Regenerate during sim)
 
(34 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
= Point cloud =
 
= Point cloud =
  
== Distribution ==
+
==== Distribution ====
 
Option menu providing 4 alternate methods of point distribution in a voronoi point cloud.
 
Option menu providing 4 alternate methods of point distribution in a voronoi point cloud.
 
* [[Voronoi_Attributes#uniform|uniform]]
 
* [[Voronoi_Attributes#uniform|uniform]]
Line 11: Line 11:
  
 
=== uniform ===
 
=== uniform ===
 +
 +
Places particles by choosing uniformly-distributed random numbers along each coordinate axis.
  
 
==== Num points ====
 
==== Num points ====
Integer value with a minimum value of 1.
+
{| class="wikitable" style="width: 100%"
<gallery widths="300px" perrow="2">
+
|-
 +
! scope="row" width="75" | type
 +
| int
 +
|-
 +
! scope="row" width="75" | default
 +
| 100
 +
|-
 +
! scope="row" width="75" |
 +
| The number of points (particles) to generate around the object. Each point will give rise to a voronoi cell. There may be fewer fragments than cells, depending on how they intersect the object.
 +
 
 +
<gallery widths="150px" perrow="2">
 
File:Uniform-25-0.png|25
 
File:Uniform-25-0.png|25
 
File:Uniform-100-0.png|100 (default)
 
File:Uniform-100-0.png|100 (default)
Line 20: Line 32:
 
File:Uniform-10000-0.png|10000
 
File:Uniform-10000-0.png|10000
 
</gallery>
 
</gallery>
 +
|}
  
 
==== Seed ====
 
==== Seed ====
Integer value with a minimum value of 0.
+
{| class="wikitable" style="width: 100%"
<gallery widths="300px" perrow="2">
+
|-
 +
! scope="row" width="75" | type
 +
| int
 +
|-
 +
! scope="row" width="75" | default
 +
| 0
 +
|-
 +
! scope="row" width="75" |
 +
| The random number sequence seed value. Change this to get a different arrangement of points.
 +
 
 +
<gallery widths="150px" perrow="2">
 
File:Uniform-100-0.png|0 (default)
 
File:Uniform-100-0.png|0 (default)
 
File:Uniform-100-1.png|1
 
File:Uniform-100-1.png|1
Line 29: Line 52:
 
File:Uniform-100-3.png|3
 
File:Uniform-100-3.png|3
 
</gallery>
 
</gallery>
 +
|}
  
 
=== poisson ===
 
=== poisson ===
 +
 +
Places particles such that the approximate distance between them is the same. Gives rise to more evenly shaped cells.
  
 
==== Approx num ====
 
==== Approx num ====
<gallery widths="300px" perrow="2">
+
{| class="wikitable" style="width: 100%"
 +
|-
 +
! scope="row" width="75" | type
 +
| int
 +
|-
 +
! scope="row" width="75" | default
 +
| 100
 +
|-
 +
! scope="row" width="75" |
 +
| The number of points to aim for. This will not be achieved exactly, since the aim of this distribution mode is equally spaced points.
 +
 
 +
<gallery widths="150px" perrow="2">
 
File:Posssion-25-0.png|25
 
File:Posssion-25-0.png|25
 
File:Posssion-100-0.png|100 (default)
 
File:Posssion-100-0.png|100 (default)
Line 39: Line 76:
 
File:Posssion-10000-0.png|10000
 
File:Posssion-10000-0.png|10000
 
</gallery>
 
</gallery>
 
+
|}
  
 
=== radial ===
 
=== radial ===
 
The radial option creates a radial distribution of voronoi cells from a center point. This option uses the the same [[Voronoi_Attributes#Num_points|Num point]] and [[Voronoi_Attributes#Seeds|seed]] attributes as the uniform option. The dispersion of cells around the center point is determined by the '''Radial bias''' attribute.
 
The radial option creates a radial distribution of voronoi cells from a center point. This option uses the the same [[Voronoi_Attributes#Num_points|Num point]] and [[Voronoi_Attributes#Seeds|seed]] attributes as the uniform option. The dispersion of cells around the center point is determined by the '''Radial bias''' attribute.
 +
 
==== Radial bias ====
 
==== Radial bias ====
Float attribute with a minimum value of 0.5
+
{| class="wikitable" style="width: 100%"
<gallery caption="Radial bias examples" widths="300px" perrow="2">
+
|-
 +
! scope="row" width="75" | type
 +
| float
 +
|-
 +
! scope="row" width="75" | default
 +
| 1.0
 +
|-
 +
! scope="row" width="75" | minimum
 +
| 0.5
 +
|-
 +
! scope="row" width="75" |
 +
| How much influence the center point has when distorting particle positions.
 +
 
 +
<gallery caption="Radial bias examples" widths="150px" perrow="2">
 
File:Radial-radius-100-0.5-0.png|Radius 0.5
 
File:Radial-radius-100-0.5-0.png|Radius 0.5
 
File:Radial-radius-100-1-0.png|Radius 1 (default)
 
File:Radial-radius-100-1-0.png|Radius 1 (default)
Line 51: Line 102:
 
File:Radial-radius-100-2-0.png|Radius 2.0
 
File:Radial-radius-100-2-0.png|Radius 2.0
 
</gallery>
 
</gallery>
 +
  
  
 
The generated cells, as seen above, is merely a preview of the fragments that will be generated upon a collision. The actual center point is determined by the point of the collision.
 
The generated cells, as seen above, is merely a preview of the fragments that will be generated upon a collision. The actual center point is determined by the point of the collision.
<gallery caption="Pre-simulation" widths="300px" perrow="2">
+
<gallery caption="Pre-simulation" widths="150px" perrow="2">
 
File:Radial-start-400-0.5-0 persp.png|Perspective view show the wall with the radial fragments and the primitive sphere that will collide with it
 
File:Radial-start-400-0.5-0 persp.png|Perspective view show the wall with the radial fragments and the primitive sphere that will collide with it
 
File:Radial-start-400-0.5-0 side.png|Side view showing the actual position of the colliding primitive sphere
 
File:Radial-start-400-0.5-0 side.png|Side view showing the actual position of the colliding primitive sphere
 
</gallery>
 
</gallery>
<gallery caption="Radial dispersion at collision time" widths="300px" perrow="2">
+
<gallery caption="Radial dispersion at collision time" widths="150px" perrow="2">
 
File:Radial-simulation-400-0.5-0 persp.png
 
File:Radial-simulation-400-0.5-0 persp.png
 
File:Radial-simulation-400-0.5-0 side.png
 
File:Radial-simulation-400-0.5-0 side.png
 
</gallery>
 
</gallery>
 +
|}
  
 
=== cluster ===
 
=== cluster ===
 +
 +
Tries to create clusters of points, to give more variation in cell size.
  
 
==== Num clusters ====
 
==== Num clusters ====
<gallery widths="300px" perrow="2">
+
{| class="wikitable" style="width: 100%"
 +
|-
 +
! scope="row" width="75" | type
 +
| int
 +
|-
 +
! scope="row" width="75" | default
 +
| 10
 +
|-
 +
! scope="row" width="75" | minimum
 +
| 2
 +
|-
 +
! scope="row" width="75" |
 +
| The number of clusters to place amongst the original particle set. Particles are moved towards the nearest cluster.
 +
 
 +
<gallery widths="150px" perrow="2">
 
File:Cluster-100-2-1.0-0.png|2
 
File:Cluster-100-2-1.0-0.png|2
 
File:Cluster-100-5-1.0-0.png|5
 
File:Cluster-100-5-1.0-0.png|5
Line 72: Line 141:
 
File:Cluster-100-20-1.0-0.png|20
 
File:Cluster-100-20-1.0-0.png|20
 
</gallery>
 
</gallery>
 +
|}
  
 
==== Cluster bias ====
 
==== Cluster bias ====
<gallery caption="Cluster bias examples (Num clusters set to 2)" widths="300px" perrow="2">
+
{| class="wikitable" style="width: 100%"
 +
|-
 +
! scope="row" width="75" | type
 +
| float
 +
|-
 +
! scope="row" width="75" | default
 +
| 1.0
 +
|-
 +
! scope="row" width="75" |
 +
| How much influence the cluster has on the final particle position.
 +
 
 +
<gallery caption="Cluster bias examples (Num clusters set to 2)" widths="150px" perrow="2">
 
File:Cluster-100-2-.25-0.png|0.25
 
File:Cluster-100-2-.25-0.png|0.25
 
File:Cluster-100-2-.5-0.png|0.5
 
File:Cluster-100-2-.5-0.png|0.5
 
File:Cluster-100-2-.75-0.png|0.75
 
File:Cluster-100-2-.75-0.png|0.75
File:Cluster-100-2-1.0-0.png|1.0
+
File:Cluster-100-2-1.0-0.png|1.0 (default)
 
</gallery>
 
</gallery>
 +
|}
  
 
== Options ==
 
== Options ==
  
=== Regenerate during sim ===
+
==== Regenerate during sim ====
type: boolean
+
{| class="wikitable" style="width: 100%"
default: True
+
|-
description: Enable this to re-generate the point cloud when different objects are broken during a simulation
+
! scope="row" width="75" | type
 +
| bool
 +
|-
 +
! scope="row" width="75" | default
 +
| True
 +
|-
 +
! scope="row" |
 +
| Enable this to re-generate the point cloud when different objects are broken during a simulation
 +
|}
  
=== Radial center at impact ===
+
==== Radial center at impact ====
 +
{| class="wikitable" style="width: 100%"
 +
|-
 +
! scope="row" width="75" | type
 +
| bool
 +
|-
 +
! scope="row" width="75" | default
 +
| True
 +
|}
  
=== Particles ===
+
==== Particles ====
 +
{| class="wikitable" style="width: 100%"
 +
|-
 +
! scope="row" width="75" | type
 +
| string
 +
|-
 +
! scope="row" width="75" |
 +
| The particle shape in which the generated points are stored
 +
|}
  
=== Data name ===
+
==== Data name ====
 +
{| class="wikitable" style="width: 100%"
 +
|-
 +
! scope="row" width="75" | type
 +
| string
 +
|-
 +
! scope="row" width="75" | default
 +
| cell
 +
|-
 +
! scope="row" |
 +
| The name of the custom data to be attached to fragments, identifying (integer) the particle whose voronoi cell they originate from
 +
|}
  
 
= Voxel =
 
= Voxel =
  
=== Accuracy (%) ===
+
==== Accuracy (%) ====

Latest revision as of 03:58, 6 July 2012

Contents

[edit] Point cloud

[edit] Distribution

Option menu providing 4 alternate methods of point distribution in a voronoi point cloud.

Each distribution type may have it's own attribute(s) that are unique. The only common attribute found among each distribution is Seed.

[edit] uniform

Places particles by choosing uniformly-distributed random numbers along each coordinate axis.

[edit] Num points

type int
default 100
The number of points (particles) to generate around the object. Each point will give rise to a voronoi cell. There may be fewer fragments than cells, depending on how they intersect the object.

[edit] Seed

type int
default 0
The random number sequence seed value. Change this to get a different arrangement of points.

[edit] poisson

Places particles such that the approximate distance between them is the same. Gives rise to more evenly shaped cells.

[edit] Approx num

type int
default 100
The number of points to aim for. This will not be achieved exactly, since the aim of this distribution mode is equally spaced points.

[edit] radial

The radial option creates a radial distribution of voronoi cells from a center point. This option uses the the same Num point and seed attributes as the uniform option. The dispersion of cells around the center point is determined by the Radial bias attribute.

[edit] Radial bias

type float
default 1.0
minimum 0.5
How much influence the center point has when distorting particle positions.


The generated cells, as seen above, is merely a preview of the fragments that will be generated upon a collision. The actual center point is determined by the point of the collision.

[edit] cluster

Tries to create clusters of points, to give more variation in cell size.

[edit] Num clusters

type int
default 10
minimum 2
The number of clusters to place amongst the original particle set. Particles are moved towards the nearest cluster.

[edit] Cluster bias

type float
default 1.0
How much influence the cluster has on the final particle position.

[edit] Options

[edit] Regenerate during sim

type bool
default True
Enable this to re-generate the point cloud when different objects are broken during a simulation

[edit] Radial center at impact

type bool
default True

[edit] Particles

type string
The particle shape in which the generated points are stored

[edit] Data name

type string
default cell
The name of the custom data to be attached to fragments, identifying (integer) the particle whose voronoi cell they originate from

[edit] Voxel

[edit] Accuracy (%)

Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox