Particle emission shapes
The particle system emission shape controls the position and direction of the particles when they are spawned.
Common parameters
All the emission shapes shares the next properties:
| Property | Default value | Description |
|---|---|---|
| Randomize Direction | 0 | Randomness factor of the particle direction. A value of 0 mean no random directions, 1 is total chaos, while intermediate values sort of adds a little bit of randomness while keeping the overall particle direction of the emission shape. |
| Velocity Offset | (0, 0, 0) | Velocity that it's added on top of initial particle velocity. |
Point Shape
Point Shape emits the particles from the same position, and using the Up vector of the particles entity as direction.
Sphere Shape
Sphere Shape uses a sphere for the emission. Its parameters controls the size of the emission sphere, whether the particles are emitted from sphere volume or only from its surface, and the direction of the new particles (from the sphere center or following the up vector).
| Property | Default value | Description |
|---|---|---|
| Radius | 1 | The radius of the emission sphere |
| From Surface | _false | True if the particles are spawned from the sphere carcass, false if they are placed from inside the sphere volume.  |
| From Center | true | If the particles are moving from the sphere center or all to the same direction (Up vector).  |
Box Shape
Box Shape uses a box for the emission. Its parameters controls the size of the emission box.
| Property | Default value | Description |
|---|---|---|
| Size | (1, 1, 1) | The size of the emission cube |
| From Center | true | If the particles are moving from the box center or all to the same direction (Up vector).  |
Circle Shape
**Circle Shape** uses a circle for the emission. Its parameters controls the size of the emission circle and whether the particles are emitted from the circle area or its circumference, and the direction of the new particles (from the circle center or following the up vector).| Property | Default value | Description |
|---|---|---|
| Radius | 1 | The radius of the emission circle |
| From Circumference | false | True if the particles are spawned from the circle circumference, false if they are placed from inside the circle area.  |
| From Center | true | If the particles are moving from the center or all to the same direction (Up vector).  |
Edge Shape
Edge Shape uses a line for the emission. Its parameters controls the length of the edge or line and the direction of the new particles (from the line or following the up vector).
| Property | Default value | Description |
|---|---|---|
| Length | 1 | The length of the emission line |
| From Center | true | If the particles are moving from the center or all to the same direction (Up vector).  |
Entity Shape
Entity Shape is an emission shape where particles are emitted from a specific Entity of the scene. More specifically, the particle system uses the meshes of the entity and its children.
Note
The target entity is not defined in the Entity Shape Emitter because it's part of the Particle System asset hence is not bound to any specific scene. It's defined in the ParticlesComponent component, which can have access to the scene entities.
| Property | Default value | Description |
|---|---|---|
| EmissionSource | Vertex | The part of the mesh topology where the particles are emitted. Its values can be Vertex or Triangle. |