ParticleSystem

A ParticleSystem can be used to create particle effects like fire or smoke.

The particle system has to be created using love.graphics.newParticleSystem. Just like any other Drawable it can be drawn to the screen using love.graphics.draw. You also have to update it in the update callback to see any changes in the particles emitted.

The particle system won't create any particles unless you call setParticleLifetime and setEmissionRate.

Constructors

love.graphics.newParticleSystem Creates a new ParticleSystem.

Functions

Object:release Immediately destroys the object's Lua reference. Added since 11.0
Object:type Gets the type of the object as a string.
Object:typeOf Checks whether an object is of a certain type.
ParticleSystem:clone Creates an identical copy of the ParticleSystem in the stopped state. Added since 0.9.1
ParticleSystem:count Gets the amount of particles that are currently in the system. Removed in 0.9.0
ParticleSystem:emit Emits a burst of particles from the particle emitter. Added since 0.9.0
ParticleSystem:getAreaSpread Gets the area-based spawn parameters for the particles. Added since 0.9.0 Deprecated in 11.0
ParticleSystem:getBufferSize Gets the maximum number of particles the ParticleSystem can have at once. Added since 0.9.0
ParticleSystem:getColors Gets the colors to apply to the particle sprite. Added since 0.9.0
ParticleSystem:getCount Gets the number of particles that are currently in the system. Added since 0.9.0
ParticleSystem:getDirection Gets the direction of the particle emitter (in radians).
ParticleSystem:getEmissionArea Gets the area-based spawn parameters for the particles. Added since 11.0
ParticleSystem:getEmissionRate Gets the amount of particles emitted per second. Added since 0.9.0
ParticleSystem:getEmitterLifetime Gets how long the particle system will emit particles Added since 0.9.0
ParticleSystem:getImage Gets the image used for the particles. Added since 0.9.0 Removed in 0.10.0
ParticleSystem:getInsertMode Gets the mode used when the ParticleSystem adds new particles. Added since 0.9.0
ParticleSystem:getLinearAcceleration Gets the linear acceleration (acceleration along the x and y axes) for particles. Added since 0.9.0
ParticleSystem:getLinearDamping Gets the amount of linear damping (constant deceleration) for particles. Added since 0.9.2
ParticleSystem:getOffset Gets the particle image's draw offset. Added since 0.9.0
ParticleSystem:getOffsetX Get the x coordinate of the particle rotation offset. Removed in 0.9.0
ParticleSystem:getOffsetY Get the y coordinate of the particle rotation offset. Removed in 0.9.0
ParticleSystem:getParticleLifetime Gets the lifetime of the particles. Added since 0.9.0
ParticleSystem:getPosition Gets the position of the emitter.
ParticleSystem:getQuads Gets a series of Quads used for the particle sprites. Added since 0.9.2
ParticleSystem:getRadialAcceleration Gets the radial acceleration (away from the emitter). Added since 0.9.0
ParticleSystem:getRotation Gets the rotation of the image upon particle creation (in radians). Added since 0.9.0
ParticleSystem:getSizeVariation Gets the amount of size variation. Added since 0.9.0
ParticleSystem:getSizes Gets the sizes of the particle over its lifetime. Added since 0.9.0
ParticleSystem:getSpeed Gets the speed of the particles. Added since 0.9.0
ParticleSystem:getSpin Gets the spin of the sprite. Added since 0.9.0
ParticleSystem:getSpinVariation Gets the amount of spin variation. Added since 0.9.0
ParticleSystem:getSpread Gets the amount of directional spread of the particle emitter (in radians).
ParticleSystem:getTangentialAcceleration Gets the tangential acceleration (acceleration perpendicular to the particle's direction). Added since 0.9.0
ParticleSystem:getTexture Gets the texture (Image or Canvas) used for the particles. Added since 0.9.1
ParticleSystem:getX Gets the x-coordinate of the particle emitter's position. Removed in 0.9.0
ParticleSystem:getY Gets the y-coordinate of the particle emitter's position. Removed in 0.9.0
ParticleSystem:hasRelativeRotation Gets whether particle angles and rotations are relative to their velocities. Added since 0.9.1
ParticleSystem:isActive Checks whether the particle system is actively emitting particles.
ParticleSystem:isEmpty Checks whether the particle system is empty of particles. Removed in 0.9.0
ParticleSystem:isFull Checks whether the particle system is full of particles. Removed in 0.9.0
ParticleSystem:isPaused Checks whether the particle system is paused. Added since 0.9.0
ParticleSystem:isStopped Checks whether the particle system is stopped. Added since 0.9.0
ParticleSystem:moveTo Moves the position of the emitter. Added since 0.9.1
ParticleSystem:pause Pauses the particle emitter.
ParticleSystem:reset Resets the particle emitter, removing existing particles and resetting the lifetime counter.
ParticleSystem:setAreaSpread Sets area-based spawn parameters for the particles. Added since 0.9.0 Deprecated in 11.0
ParticleSystem:setBufferSize Sets the size of the buffer (the max allowed amount of particles in the system).
ParticleSystem:setColor Sets the color of the image. Removed in 0.8.0
ParticleSystem:setColors Sets the colors to apply to the particle sprite. Added since 0.8.0
ParticleSystem:setDirection Sets the direction the particles will be emitted in.
ParticleSystem:setEmissionArea Sets area-based spawn parameters for the particles. Added since 11.0
ParticleSystem:setEmissionRate Sets the amount of particles emitted per second.
ParticleSystem:setEmitterLifetime Sets how long the particle system should emit particles Added since 0.9.0
ParticleSystem:setGravity Sets the gravity affecting the particles (acceleration along the y-axis). Removed in 0.9.0
ParticleSystem:setImage Sets the image to be used for the particles. Added since 0.9.0 Removed in 0.10.0
ParticleSystem:setInsertMode Sets the mode to use when the ParticleSystem adds new particles. Added since 0.9.0
ParticleSystem:setLifetime Sets how long the particle system should emit particles (if -1 then it emits particles forever). Removed in 0.9.0
ParticleSystem:setLinearAcceleration Sets the linear acceleration (acceleration along the x and y axes) for particles. Added since 0.9.0
ParticleSystem:setLinearDamping Sets the amount of linear damping (constant deceleration) for particles. Added since 0.9.2
ParticleSystem:setOffset Set the offset position which the particle sprite is rotated around.
ParticleSystem:setParticleLife Sets the life of the particles. Removed in 0.9.0
ParticleSystem:setParticleLifetime Sets the lifetime of the particles. Added since 0.9.0
ParticleSystem:setPosition Sets the position of the emitter.
ParticleSystem:setQuads Sets a series of Quads to use for the particle sprites. Added since 0.9.2
ParticleSystem:setRadialAcceleration Set the radial acceleration (away from the emitter).
ParticleSystem:setRelativeRotation Sets whether particle angles and rotations are relative to their velocities. Added since 0.9.1
ParticleSystem:setRotation Sets the rotation of the image upon particle creation (in radians).
ParticleSystem:setSize Sets the size of the particle (1.0 being normal size). Removed in 0.8.0
ParticleSystem:setSizeVariation Sets the amount of size variation.
ParticleSystem:setSizes Sets the sizes of the particle over its lifetime. Added since 0.8.0
ParticleSystem:setSpeed Sets the speed of the particles.
ParticleSystem:setSpin Sets the spin of the sprite.
ParticleSystem:setSpinVariation Sets the amount of spin variation.
ParticleSystem:setSpread Sets the amount of spread for the system.
ParticleSystem:setSprite Sets the image which is to be emitted. Removed in 0.9.0
ParticleSystem:setTangentialAcceleration Sets the tangential acceleration (acceleration perpendicular to the particle's direction).
ParticleSystem:setTexture Sets the texture (Image or Canvas) to be used for the particles. Added since 0.9.1
ParticleSystem:start Starts the particle emitter.
ParticleSystem:stop Stops the particle emitter, resetting the lifetime counter.
ParticleSystem:update Updates the particle system; moving, creating and killing particles.

Enums

AreaSpreadDistribution Types of particle area spread distribution. Added since 0.9.0
ParticleInsertMode How newly created particles are added to the ParticleSystem. Added since 0.9.0

Supertypes

See Also


Particle editors:

Other Languages