Difference between revisions of "Particles:addParticles"

(added example)
(modified example)
Line 37: Line 37:
 
stars:setPosition(64, 64)
 
stars:setPosition(64, 64)
 
stage:addChild(stars)
 
stage:addChild(stars)
stars:addParticles({
+
stage:addEventListener(Event.ENTER_FRAME, function()
{x=math.random(128*64),y=math.random(5*64),size=math.random(1,3),color=0xD9B589,ttl=30*60,speedX=0,speedY=0},
+
stars:addParticles({
{x=math.random(128*64),y=math.random(5*64),size=math.random(1,3),color=0xffff00,ttl=30*60,speedX=1,speedY=0},
+
{x=math.random(4*64),y=math.random(5*64),size=math.random(1,30),color=0xD9B589,ttl=1*60,speedX=0,speedY=0},
})
+
{x=math.random(2*64),y=math.random(5*64),size=math.random(1,30),color=0xffff00,ttl=30*60,speedX=1,speedY=0},
 +
})
 +
end)
 
</source>
 
</source>
  

Revision as of 03:50, 24 November 2019



Available since: Gideros 2016.06
Class: Particles

Description

Add particle a single particle (short form) or several ones (long form) to this particle system.
Short form (single particle): particles:addParticles(x,y,size,angle,ttl)
Extended form: particles:addParticles{particleDesc1,particleDesc2,...,particleDescN}
where particleDescX is a table describing a particle to be added. This table can contain the following parameters:

  • x,y: particle position
  • size: particle size
  • angle: particle orientation
  • color: particle color
  • alpha: particle alpha
  • ttl: time to leave, number of frames this particle will stay on screen
  • tag: tag associated with this particle
  • speedX,speedY,speedAngular,speedGrowth: Amount added to x,y,angle and size at the beginning of each frame
  • decay,decayAngular,decayGrowth,decayAlpha: factor applied to speedX and speedY, speedAngular, speedGrowth and alpha at the beginning of each frame


(number or table) = Particles:addParticles(particles)


Example

Example::

local stars = Particles.new()
stars:setPosition(64, 64)
stage:addChild(stars)
stage:addEventListener(Event.ENTER_FRAME, function()
	stars:addParticles({
		{x=math.random(4*64),y=math.random(5*64),size=math.random(1,30),color=0xD9B589,ttl=1*60,speedX=0,speedY=0},
		{x=math.random(2*64),y=math.random(5*64),size=math.random(1,30),color=0xffff00,ttl=30*60,speedX=1,speedY=0},
	})
end)

Parameters

particles: (table or arguments) table for multiple particles or arguments for single

Return values

Returns (number or table) index or table with indexes of added particles