Difference between revisions of "Particles:addParticles"

Line 1: Line 1:
 
__NOTOC__
 
__NOTOC__
'''Available since:''' Gideros 2016.06<br/>
+
'''<translate>Available since</translate>:''' Gideros 2016.06<br/>
=== Description ===
+
=== <translate>Description</translate> ===
 
<translate>Add particle a single particle (short form)  or several ones (long form) to this particle system.
 
<translate>Add particle a single particle (short form)  or several ones (long form) to this particle system.
 
<br/>
 
<br/>
Line 24: Line 24:
 
(number or table) = Particles:addParticles(particles)
 
(number or table) = Particles:addParticles(particles)
 
</source>
 
</source>
=== Parameters ===
+
=== <translate>Parameters</translate> ===
 
'''particles''': (table or arguments) <translate>table for multiple particles or arguments for single</translate> <br/>
 
'''particles''': (table or arguments) <translate>table for multiple particles or arguments for single</translate> <br/>
=== Return values ===
+
=== <translate>Return values</translate> ===
'''Returns''' (number or table) <translate>index or table with indexes of added particles</translate><br/>
+
'''<translate>Returns</translate>''' (number or table) <translate>index or table with indexes of added particles</translate><br/>

Revision as of 08:26, 24 August 2018

Available since: Gideros 2016.06

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: [[Special:MyLanguage/particles:addParticles{particleDesc1,particleDesc2,...,particleDescN}|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)

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