~~NOTOC~~

====== SAP Particles Extension ======

---- dataentry extension ----
author_mail   : unknownflasher@gmail.com Sergey Gonchar
description   :            # enter a short description of the extension
lastupdate_dt : 2015-03-24 # the date you created the extension
compatible    : v1.6.1       # the Starling version you tested the extension with
depends       :            # if the ext. depends on others, list them here
tags          : particles, effects           # enter a few tags, separated by commas
homepage_url  : https://github.com/gonchar/SAP           # if the ext. has an URL (e.g. a Gist-page), add it here
download_url  : https://github.com/gonchar/SAP/archive/master.zip           # a direct link to the download (e.g. the Gist-archive)
----

===== Overview =====

SAP is a port of [[https://github.com/AlternativaPlatform/Alternativa3D|Alternativa3D Particle System]] to Starling Framework. This particle system is really well optimized for rendering on mobile. All particle data goes to GPU through vertexconstants. There are no any vertexbuffer uploads each frame. 

Basic concepts:
  * PartcleSystem manages ParticleEffects
  * To create your effect you have to extends ParticleEffect class which will manage ParticlePrototype instances inside.
  * ParticleEffect and ParticlePrototype have timelines. You can add keys to them with addKey method.
  * Check out Source Code section with [[http://bit.ly/1BLd9w3|Fire]] example
  * Each particle has "z" property that can be used as a sort value. To enable this feature, please set ParticleSystem.sortParticlesByZ flag to true

Github repository includes the source code of this [[http://bit.ly/1BLd9w3|Demo]]

SAP Editor coming soon.

===== Changelog =====

  * //2015/03/25 19:11//: First public version

===== Source Code =====

Fire Effect example
%gist(4eef3c0798a96f6c9530)%

===== User Comments =====

//Feel free to edit this part of the page!//