ParticleSystem:emit

Available since LÖVE 0.9.0
This function is not supported in earlier versions.

Emits a burst of particles from the particle emitter.

Function

Synopsis

1	`ParticleSystem:emit( numparticles )`

Arguments

number numparticles: The amount of particles to emit. The number of emitted particles will be truncated if the particle system's max buffer size is reached.

Returns

Nothing.

Examples

Spawn a bunch of particles

This example will create a burst of particles when the spacebar is pressed. You can use the löve logo as an example image.

function love.load()
    local img = love.graphics.newImage('logo.png')
  
    psystem = love.graphics.newParticleSystem(img, 32)
    psystem:setParticleLifetime(2, 5) -- Particles live at least 2s and at most 5s.
    psystem:setLinearAcceleration(-5, -5, 50, 100) -- Randomized movement towards the bottom of the screen.
    psystem:setColors(255, 255, 255, 255, 255, 255, 255, 0) -- Fade to black.
end
  
function love.draw()
    -- Draw the particle system at the center of the game window.
    love.graphics.draw(psystem, love.graphics.getWidth() * 0.5, love.graphics.getHeight() * 0.5)
end
  
function love.update(dt)
    psystem:update(dt)
end
  
function love.keypressed(key)
    if key == 'space' then
        psystem:emit(32)
    end
end

ParticleSystem:emit

ParticleSystem:emit

Function

Synopsis

Arguments

Returns

Examples

Spawn a bunch of particles

See Also