A particle system for the Sparrow framework, compatible with the "Particle Designer" from 71squared.com
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 15 commits ahead of PrimaryFeather:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Sparrow Extension: Particle System

The Sparrow Extension class "SXParticleSystem" provides an easy way to display particle systems from within the Sparrow Framework. That way, adding special effects like explosions, smoke, snow, fire, etc. is very easy to do.

The particle system is controlled by a configuration file in the format that is created by Particle Designer. While you don't need that tool to create particle systems, it makes designing them much easier.


In the src-directory, you will find 2 classes - the SXParticleSystem and a helper class. Add those classes directly to your Sparrow-powered game.


The demo-directory contains a sample project. If you have configured your system for Sparrow, the project should compile and run out of the box.

The project contains 4 sample configurations. Switch between configurations in Game.m by changing the init-method:

mParticleSystem = [[SXParticleSystem alloc] initWithContentsOfFile:@"sun.pex"];

The following configurations are available:

  • drugs.pex
  • fire.pex
  • sun.pex
  • waterfall.pex

Sample Code

This is all you have to do to create a particle system. The class SXParticleSystem is a subclass of SPDisplayObject and behaves as such. You can add it as a child to the stage or to any other container. As usual, you have to add it to a juggler (or call its advanceTime: method once per frame) to animate it.

// create particle system
SXParticleSystem *ps = [[SXParticleSystem alloc] initWithContentsOfFile:@"sun.pex"];    
ps.x = 160.0f;
ps.y = 240.0f;

// add it to the stage and the juggler
[self addChild:ps];
[self.juggler addObject:ps];
[ps release];

// start emitting particles
[ps start];

// stop emitting particles
[ps stop];

More information

Find more information about this extension on the Sparrow Wiki.