Difference between revisions of "ParticleSystem:setColors"

(Created for 0.8.0)
 
(Added note about argument limits)
Line 2: Line 2:
 
Sets a series of colors to apply to the particle sprite. The particle system will interpolate between each color evenly over the particle's lifetime. Color modulation needs to be activated for this function to have any effect.
 
Sets a series of colors to apply to the particle sprite. The particle system will interpolate between each color evenly over the particle's lifetime. Color modulation needs to be activated for this function to have any effect.
  
Arguments are passed in groups of four, representing the components of the desired RGBA value.
+
Arguments are passed in groups of four, representing the components of the desired RGBA value. At least one color must be specified. A maximum of eight may be used.
 
== Function ==
 
== Function ==
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
ParticleSystem:setColors( r1, g1, b1, a1, r2, g2, b2, a2, ..., rn, gn, bn, an )
+
ParticleSystem:setColors( r1, g1, b1, a1, r2, g2, b2, a2, ..., r8, g8, b8, a8 )
 
</source>
 
</source>
 
=== Arguments ===
 
=== Arguments ===
Line 17: Line 17:
 
{{param|number|b2|Second color, blue component (0-255).}}
 
{{param|number|b2|Second color, blue component (0-255).}}
 
{{param|number|a2|Second color, alpha component (0-255).}}
 
{{param|number|a2|Second color, alpha component (0-255).}}
{{param|number|rn|Final color, red component (0-255).}}
+
{{param|number|r8|Eighth color, red component (0-255).}}
{{param|number|gn|Final color, green component (0-255).}}
+
{{param|number|g8|Eighth color, green component (0-255).}}
{{param|number|bn|Final color, blue component (0-255).}}
+
{{param|number|b8|Eighth color, blue component (0-255).}}
{{param|number|an|Final color, alpha component (0-255).}}
+
{{param|number|a8|Eighth color, alpha component (0-255).}}
 
=== Returns ===
 
=== Returns ===
 
Nothing.
 
Nothing.

Revision as of 07:47, 6 February 2012

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

Sets a series of colors to apply to the particle sprite. The particle system will interpolate between each color evenly over the particle's lifetime. Color modulation needs to be activated for this function to have any effect.

Arguments are passed in groups of four, representing the components of the desired RGBA value. At least one color must be specified. A maximum of eight may be used.

Function

Synopsis

ParticleSystem:setColors( r1, g1, b1, a1, r2, g2, b2, a2, ..., r8, g8, b8, a8 )

Arguments

number r1
First color, red component (0-255).
number g1
First color, green component (0-255).
number b1
First color, blue component (0-255).
number a1
First color, alpha component (0-255).
number r2
Second color, red component (0-255).
number g2
Second color, green component (0-255).
number b2
Second color, blue component (0-255).
number a2
Second color, alpha component (0-255).
number r8
Eighth color, red component (0-255).
number g8
Eighth color, green component (0-255).
number b8
Eighth color, blue component (0-255).
number a8
Eighth color, alpha component (0-255).

Returns

Nothing.

See Also


Other Languages