ShapeModule
The shape module is mainly used to set the particle emitter shape, particle emission direction and velocity.
Public properties
There are a number of properties that are common to all types of emitters, including:
| Property | Features |
|---|---|
| ShapeType | Emitter shapes. The types Box, Circle, Cone, Sphere, Hemisphere are currently supported. |
| Position | The position of the emitter relative to the node where it is located |
| Rotation | Rotation of the emitter relative to its node, which can be used to adjust the particle emission direction |
| Scale | Scaling of the emitter relative to the node it is on can be used to adjust the size of the emitter shape, i.e. the particle emission range |
| AlignToDirection | The direction of particle movement is determined by the initial direction of particle emission, which can be used to simulate an effect similar to water spilling out of a bucket |
| RandomDirectionAmount | Particle generation direction random mix setting. No effect when set to 0; Random direction when set to 1 |
| SphericalDirectionAmount | Indicates the interpolation between the current emission direction and the direction of the line from the current position to the center of the node. When this value is set to 1, particles are emitted from the center to the outside (the same behavior as when ShapeType is set to Sphere) |
| RandomPositionAmount | The particle generation position is set randomly, when this value is set not 0, the particle generation position will be out of the size range of the generator |
Box
When the ShapeType property is set to Box, it is a box emitter.
The special property items if box emitter are described as follows.
| Properties | Description |
|---|---|
| EmitFrom | The part of the box from which the emitter emits particles, including: Volume: Emitted from inside the box Shell: Emitted from the box surface Edge: Emitted from the box edge |
| BoxThickness | The thickness of the box in each emitting direction, effective only when EmitFrom is selected for Shell mode |
Also in the Scene Editor there will be a box Gizmo that shows the shape size of the box emitter.
The Scale property of the box emitter can be adjusted by dragging the box Gizmo's square control point directly:
Circle
When the ShapeType property is set to Circle, it is a circle emitter.
The special property items are described as follows:
| Properties | Description |
|---|---|
| Radius | Set the radius of the circle emitter |
| RadiusThickness | The position of the round emitter emitting particles. When set to 0, it means firing from the circumference of the circle When set to 1, it means firing from the center of the circle When set to between 0~1, it means firing from the center of the circle to the circumference of the circle, within a certain proportional range |
| Arc | Set the fan area where the circle emitter emits particles |
| ArcMode | Sets how the particles are emitted in the sector, including. Random: random firing Loop: cyclic firing in a certain direction, each cycle in the same direction PingPong: cyclic firing, each cycle in the opposite direction of the previous one |
| ArcSpread | Sets the discrete interval around the arcs where particles may be generated. Example: When set to 0, particles can be generated anywhere in the arc; when set to 0.2, particles are generated only at 20% intervals around the arc. |
| ArcSpeed | Indicates the velocity of the particle emitted along the arc. Click the down icon button on the right to open the curve editor to edit the curve for this property. |
Also in the Scene Editor there will be a circular Gizmo showing the shape size of the emitter.
The Radius property of the circle emitter can be adjusted by directly dragging the square control point of the circular Gizmo.
Cone
When the ShapeType property is set to Cone, we call it a cone emitter. In the Scene Editor there will be a Cone Gizmo that shows the shape size of the emitter:
The cross section below the cone with the smaller radius is called the bottom of the cone, as shown in the above illustration.
The properties of the cone emitter are shown in the Inspector panel as follows.
The special property items are described as follows.
| Properties | Description |
|---|---|
| EmitFrom | From which part of the cone the emitter emits particles, including： Base: Emitted from the bottom of the cone Shell: Emitted from the circumference of the bottom of the cone Volume: Emitted from the inside of the cone |
| Radius | Set the radius of the bottom cross section of the cone |
| RadiusThickness | The position of the emitted particles from the cone emitter. When set to 0, it means emitting from the surface of the cone When set to 1, it means emitting from the center of the cone When set to between 0~1, it means emitting from the center of the cone to the surface, within a certain proportional range |
| Angle | The angle between the axis of the cone and the bus, the larger the value the greater the angle, the greater the degree of opening and closing of the cone emitter |
| Arc | Set the fan area where the cone emitter emits particles |
| ArcMode | indicates how the particles are emitted in the fan area. Random: random position Loop: Emitted cyclically in a certain direction, each cycle in the same direction PingPong: Emitted cyclically, each cycle in the opposite direction spread: indicates that the particle is emitted at a certain interval, for example, 0 means it can be emitted at any position; 0.1 means it is emitted every tenth of the circumference of the circle |
| ArcSpeed | The speed of the particle emitted along the arc |
| ArcSpread | indicates the velocity of the particle along the arc. Click the down icon button on the right to open the curve editor to edit the curve |
| Length | The axis length of the top section of the cone from the bottom |
The Angle, Length, and Radius properties of the cone emitter can also be set by directly dragging the cone Gizmo's square control point in the scene.
Sphere / Hemisphere
When the ShapeType property is set to Sphere/Hemisphere, we call it a sphere/hemisphere emitter.
The properties of the sphere emitter and the hemisphere emitter are the same, and here we use the sphere emitter as an example.
The special property items are described as follows.
| Properties | Description |
|---|---|
| EmitFrom | From which part of the sphere the emitter emits particles, including: Volume: Emits from inside the sphere Shell: Emits from the surface of the sphere (not in effect yet, can be set by RadiusThickness) |
| Radius | The radius of the sphere. You can also set it by dragging the control point of the sphere Gizmo in the Scene Editor directly |
| RadiusThickness | The position of the particle emitted by the sphere emitter. When set to 0, it means emitting from the surface of the ball When set to 1, it means emitting from the center of the sphere When set to between 0~1, it means emitting from the surface to the center of the sphere, within a certain proportional range |
The sphere emitter will have a sphere Gizmo in the Scene Editor that shows the shape size of the emitter.
Similarly, the hemisphere emitter has a hemisphere Gizmo in the Scene Editor that shows the shape size of the emitter:
