{{newin|[[0.9.0]]|090|type=function}}
Emits a burst of particles from the particle emitter.
== Function ==
=== Synopsis ===
<source lang="lua">
ParticleSystem:emit( numparticles )
</source>
=== Arguments ===
{{param|number|numparticles|The amount of particles to emit. The number of emitted particles will be truncated if the particle system's max [[ParticleSystem:getBufferSize|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 [[:File:Love-game-logo-256x256.png|löve logo]] as an example image.
<source lang="lua">
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
</source>

== See Also ==
* [[parent::ParticleSystem]]
[[Category:Functions]]
{{#set:Description=Emits a burst of particles from the particle emitter.}}

== Other Languages ==
{{i18n|ParticleSystem:emit}}