Main Module (Particle System)
The particle system main module is used to store all data displayed in the Inspector panel, manage particle generation, playback, updates, and destroy related modules.
|Duration||Total running time of the particle system.|
|Capacity||The maximum number of particles that the particle system can generate.|
|Loop||Whether the particle system loops.|
|PlayOnAwake||Whether the particle system automatically starts playing after loading.|
|Prewarm||After being selected, the particle system will start playing after one round has been played (only valid when loop playback is enabled).|
|SimulationSpace||The coordinate system where the particle coordinates are calculated.|
|SimulationSpeed||The update rate of the entire particle system.|
|StartDelay||The delayed emission time of the particles after the particle system starts running. (StartDelay will be set to 0 if Prewarm is selected)|
|StartLifetime||The life cycle of particles.|
|StartColor||The initial color of particles.|
|ScaleSpace||The coordinate system in which the particle is scaled
Local: scaling based on the local coordinate system
World: scaling based on the world coordinate system
Custom: custom scaling, not affected by the node's scale property.
|StartSize3D||The initial size of the X, Y, and Z axes of particles.|
|StartSize||The initial size of the X-axis of particles. Cannot be used with as
|StartSpeed||The initial velocity of particle.|
|StartRotation3D||The initial rotation angles of the X, Y, and Z axes of particles.|
|StartRotation||The initial rotation angle of particles.|
|GravityModifier||Gravity coefficient for particles affected by gravity (only CPU particles are supported).|
|RateOverTime||Number of particles emitted per second.|
|RateOverDistance||Number of particles emitted per moving unit distance.|
|Bursts||The number of Bursts that will emit the specified number of particles at the specified time. It can be adjusted by the following properties:
Time: how long the particles play before the Burst starts to emit
RepeatCount: number of Burst triggers
RepeatInterval: time interval for each trigger
Count: number of particles fired.
|DataCulling||Particle system asset culling, please refer to the description below for details.|
|RenderCulling||Particle culling, please refer to the description below for details.|
Click the button to the right of the above property input box to open the particle curve/gradient editor and edit the particle properties, please refer to the Particle Property Editor documentation.
To use Particle System, please refer to the Particle System API.
Particle System Asset Culling
The DataCulling option is used to cull the asset data of useless modules in the particle system.
Each module in the particle system exists as an independent object, and each module stores some module-related data, so the data recorded for modules that are not checked for use are useless data. When the developer does not need to dynamically open these unused modules at runtime, he can check the DataCulling option to cull these useless data and thus reduce asset usage.
Note: before v3.4 this option was EnableCulling, in v3.4 it was renamed to DataCulling to distinguish it from RenderCulling below. This adjustment has been done for compatibility, and it does not affect users in any way.
Starting with v3.4, a new RenderCulling option has been added to the particle system to enable particle culling.
If this option is enabled, the particle emitter will automatically calculate a culling box, that will be used to cull the particle emitter at runtime depending on whether the culling box is within the visible range of the camera, or not. The culling operation will be performed every frame, which is suitable for some time-consuming effects, it is not recommended to turn this feature on if the number of particles is small.
The size of the bounding box can be adjusted by using the AabbHalf button in the picture below. Once the adjustment is complete, click the Regenerate bounding box button to recalculate the bounding box.
|CullingMode||The behavior of the particle emitter after it has been culled. Possible options include Pause, Pause and Catchup, Always Simulate.
Pause: if the particle emitter bounding box is not in the visible range of the camera, particles will pause the simulation. If it resumes visibility, particles will continue the simulation at the same time as the last pause;
Pause and Catchup: if the particle emitter bounding box is not in the visible range of the camera, particles will pause the simulation. If it resumes visibility, particles will start simulating at the current time;
Always Simulate: particles will always simulate whether or not the particle emitter box is in the camera's visible range, but it will not render when it is not in the camera's visible range.
|AabbHalfX||The half-width of the particle emitter bounding box.|
|AabbHalfY||The half-height of the particle emitter bounding box.|
|AabbHalfZ||The half-length of the particle emitter bounding box.|
|Show Bounds||Shows the particle emitter bounding box in the Scene panel.|
|Regenerate bounding box||Click this button to recalculate the bounding box after it has been resized.|