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 share the following properties:
| Property | Default Value | Description |
|---|---|---|
| Randomize Direction | 0 | Randomness factor of the particle direction. A value of 0 means no random directions, 1 is total chaos, while intermediate values add a little bit of randomness while keeping the overall particle direction of the emission shape. |
| Velocity Offset | (0, 0, 0) | Velocity that is added on top of the initial particle velocity. |
Point Shape
Point Shape emits the particles from the same position, using the Up vector of the particle entity as direction.
Sphere Shape
Sphere Shape uses a sphere for the emission. Its parameters control the size of the emission sphere, whether the particles are emitted from the 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 surface, false if they are placed from inside the sphere volume.  |
| From Center | true | If the particles are moving from the sphere center or all in the same direction (Up vector).  |
Box Shape
Box Shape uses a box for the emission. Its parameters control the size of the emission box.
| Property | Default Value | Description |
|---|---|---|
| Size | (1, 1, 1) | The size of the emission box |
| From Center | true | If the particles are moving from the box center or all in the same direction (Up vector).  |
Circle Shape
Circle Shape uses a circle for the emission. Its parameters control the size of the emission circle, 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 inside the circle area.  |
| From Center | true | If the particles are moving from the center or all in the same direction (Up vector).  |
Edge Shape
Edge Shape uses a line for the emission. Its parameters control 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 in the same direction (Up vector).  |
Entity Shape
Entity Shape is an emission shape where particles are emitted from a specific Entity in 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 access the scene entities.
| Property | Default Value | Description |
|---|---|---|
| Emission Source | Vertex | The part of the mesh topology where the particles are emitted. Its values can be Vertex or Triangle. |