ParticleSystem

Used to create cool effects, like fire. The particle systems are created and drawn on the screen using functions in love.graphics. They also need to be updated in the update(dt) callback for you to see any changes in the particles emitted.

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
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
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.

... further results

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


Other Languages