class ParticleGroup

Create a new particle group instance.

Parameters:

The amount of times the animations will loop during lifetime. Settings it to 0 will stop the animation playback and each particle will have a random frame assigned at emission time.

Configures blending mode for this group.

Optional color gradient texture for tinting.

Initial particle X offset.

Initial particle Y offset.

Normalized particle emission direction angle.

Fixed delay before particle appears after being emitted.

Usage note for non-relative mode: Particle will use configuration that was happened at time of emission, not when delay timer runs out.

When enabled, particle rotation will match the particle movement direction angle.

Additional random particle position distance from emission point.

Secondary random position distance modifier (used by Box emitMode)

If enabled, group will emit new particles indefinitely maintaining number of particles at ParticleGroup.nparts.

The pattern in which particles are emitted. See individual PartEmitMode values for more details.

Initial particle position distance from emission point.

Randomized synchronization delay before particle appears after being emitted.

Usage note for non-relative mode: Particle will use configuration that was happened at time of emission, not when delay timer runs out.

Disabling the group immediately removes it from rendering and resets it's state.

The time in seconds during which particle alpha fades in after being emitted.

The time in seconds at which particle will start to fade out before dying. Fade out time can be calculated with lifetime - fadeOut.

The exponent of the alpha transition speed on fade in and fade out.

Total count of frames used by the group.

When 0, amount of frames in a group calculated by frameDivisionX * frameDivisionY.

Otherwise it's min(frameDivisionX * frameDivisionY, frameCount).

Horizontal frame divisor.

Vertical frame divisor.

Gravity applied to the particle.

The gravity angle in radians. 0 points down.

If enabled, particle will increase on X-axis with sizeIncr.

If enabled, particle will increase on Y-axis with sizeIncr.

When enabled, causes particles to always render relative to the emitter position, moving along with it. Otherwise, once emitted, particles won't follow the emitter, and will render relative to the scene origin.

Non-relative mode is useful for simulating something like a smoke coming from a moving object, while relative mode things like jet flame that have to stick to its emission source.

Initial particle lifetime.

Additional random lifetime increase when particle is created.

The group name.

Maximum number of particles alive at a time.

Should group rebuild on parameters change.

Note that some parameters take immediate effect on the existing particles, and some would force rebuild regardless of this setting.

Parameters that take immediate effect: speedIncr, gravity, gravityAngle, fadeIn, fadeOut, fadePower, rotAuto, rotInit, incrX, incrY, emitLoop and blendMode

Parameters that will always force rebuild: enable, sortMode, isRelative, texture, frameCount, frameDivisionX, frameDivisionY and nparts

Parameters that newer cause rebuild: blendMode, colorGradient and animationRepeat

If enabled, particles will be automatically rotated in the direction of particle velocity.

Initial particle rotation.

Initial rotation speed of the particle.

Additional random rotation speed when particle is created.

Initial particle size.

If set, particle will change it's size with time.

Additional random size increase when particle is created.

Does nothing.

Initial particle velocity.

If set, particle velocity will change over time.

Additional random velocity increase when particle is created.

The texture used to render particles.

Loads the particle group configuration from a given object.

Parameters:

Reset current state of particle group and re-emit all particles.

Saves the particle group configuration into a Dynamic object.