joybox 0.0.5 → 0.0.6

data/vendor/vendor-osx/cocos_2d/cocos_2d_include/CCParticleBatchNode.h

@@ -0,0 +1,99 @@
+/*
+ * cocos2d for iPhone: http://www.cocos2d-iphone.org
+ *
+ * Copyright (C) 2009 Matt Oswald
+ *
+ * Copyright (c) 2009-2010 Ricardo Quesada
+ * Copyright (c) 2011 Zynga Inc.
+ *
+ * Copyright (c) 2011 Marco Tillemans
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ *
+ */
+
+#import "CCNode.h"
+@class CCTextureAtlas;
+@class CCParticleSystem;
+
+//don't use lazy sorting for particle systems
+@interface CCNode (extension)
+-(void) setZOrder:(NSUInteger) z;
+@end
+
+/** CCParticleBatchNode is like a batch node: if it contains children, it will draw them in 1 single OpenGL call
+ * (often known as "batch draw").
+ *
+ * A CCParticleBatchNode can reference one and only one texture (one image file, one texture atlas).
+ * Only the CCParticleSystems that are contained in that texture can be added to the CCSpriteBatchNode.
+ * All CCParticleSystems added to a CCSpriteBatchNode are drawn in one OpenGL ES draw call.
+ * If the CCParticleSystems are not added to a CCParticleBatchNode then an OpenGL ES draw call will be needed for each one, which is less efficient.
+ *
+ *
+ * Limitations:
+ * - At the moment only CCParticleSystemQuad is supported
+ * - All systems need to be drawn with the same parameters, blend function, aliasing, texture
+ *
+ * Most efficient usage
+ * - Initialize the ParticleBatchNode with the texture and enough capacity for all the particle systems
+ * - Initialize all particle systems and add them as child to the batch node
+ * @since v1.1
+ */
+
+@interface CCParticleBatchNode : CCNode <CCTextureProtocol> {
+
+	CCTextureAtlas	*_textureAtlas;
+	ccBlendFunc		_blendFunc;
+}
+
+/** the texture atlas used for drawing the quads */
+@property (nonatomic, retain) CCTextureAtlas* textureAtlas;
+/** the blend function used for drawing the quads */
+@property (nonatomic, readwrite) ccBlendFunc blendFunc;
+
+/** initializes the particle system with CCTexture2D, a default capacity of 500 */
++(id)batchNodeWithTexture:(CCTexture2D *)tex;
+
+/** initializes the particle system with the name of a file on disk (for a list of supported formats look at the CCTexture2D class), a default capacity of 500 particles */
++(id)batchNodeWithFile:(NSString*) imageFile;
+
+/** initializes the particle system with CCTexture2D, a capacity of particles, which particle system to use */
++(id)batchNodeWithTexture:(CCTexture2D *)tex capacity:(NSUInteger) capacity;
+
+/** initializes the particle system with the name of a file on disk (for a list of supported formats look at the CCTexture2D class), a capacity of particles */
++(id)batchNodeWithFile:(NSString*)fileImage capacity:(NSUInteger)capacity;
+
+/** initializes the particle system with CCTexture2D, a capacity of particles */
+-(id)initWithTexture:(CCTexture2D *)tex capacity:(NSUInteger)capacity;
+
+/** initializes the particle system with the name of a file on disk (for a list of supported formats look at the CCTexture2D class), a capacity of particles */
+-(id)initWithFile:(NSString *)fileImage capacity:(NSUInteger)capacity;
+
+/** Add a child into the CCParticleBatchNode */
+-(void) addChild:(CCParticleSystem*)child z:(NSInteger)z tag:(NSInteger) aTag;
+
+/** Inserts a child into the CCParticleBatchNode */
+-(void) insertChild:(CCParticleSystem*) pSystem inAtlasAtIndex:(NSUInteger)index;
+
+/** remove child from the CCParticleBatchNode */
+-(void) removeChild:(CCParticleSystem*) pSystem cleanup:(BOOL)doCleanUp;
+
+/** disables a particle by inserting a 0'd quad into the texture atlas */
+-(void) disableParticle:(NSUInteger) particleIndex;
+@end

data/vendor/vendor-osx/cocos_2d/cocos_2d_include/CCParticleExamples.h

@@ -0,0 +1,117 @@
+/*
+ * cocos2d for iPhone: http://www.cocos2d-iphone.org
+ *
+ * Copyright (c) 2008-2010 Ricardo Quesada
+ * Copyright (c) 2011 Zynga Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ *
+ */
+
+
+#import "ccMacros.h"
+#import "CCParticleSystemQuad.h"
+
+//! A fire particle system
+@interface CCParticleFire: CCParticleSystemQuad
+{
+}
+// needed for BridgeSupport
+-(id) init;
+@end
+
+//! A fireworks particle system
+@interface CCParticleFireworks : CCParticleSystemQuad
+{
+}
+// needed for BridgeSupport
+-(id) init;
+@end
+
+//! A sun particle system
+@interface CCParticleSun : CCParticleSystemQuad
+{
+}
+// needed for BridgeSupport
+-(id) init;
+@end
+
+//! A galaxy particle system
+@interface CCParticleGalaxy : CCParticleSystemQuad
+{
+}
+// needed for BridgeSupport
+-(id) init;
+@end
+
+//! A flower particle system
+@interface CCParticleFlower : CCParticleSystemQuad
+{
+}
+// needed for BridgeSupport
+-(id) init;
+@end
+
+//! A meteor particle system
+@interface CCParticleMeteor : CCParticleSystemQuad
+{
+}
+// needed for BridgeSupport
+-(id) init;
+@end
+
+//! An spiral particle system
+@interface CCParticleSpiral : CCParticleSystemQuad
+{
+}
+// needed for BridgeSupport
+-(id) init;
+@end
+
+//! An explosion particle system
+@interface CCParticleExplosion : CCParticleSystemQuad
+{
+}
+// needed for BridgeSupport
+-(id) init;
+@end
+
+//! An smoke particle system
+@interface CCParticleSmoke : CCParticleSystemQuad
+{
+}
+// needed for BridgeSupport
+-(id) init;
+@end
+
+//! An snow particle system
+@interface CCParticleSnow : CCParticleSystemQuad
+{
+}
+// needed for BridgeSupport
+-(id) init;
+@end
+
+//! A rain particle system
+@interface CCParticleRain : CCParticleSystemQuad
+{
+}
+// needed for BridgeSupport
+-(id) init;
+@end

data/vendor/vendor-osx/cocos_2d/cocos_2d_include/CCParticleSystem.h

@@ -0,0 +1,464 @@
+/*
+ * cocos2d for iPhone: http://www.cocos2d-iphone.org
+ *
+ * Copyright (c) 2008-2010 Ricardo Quesada
+ * Copyright (c) 2011 Zynga Inc.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ * THE SOFTWARE.
+ *
+ */
+
+
+#import "CCProtocols.h"
+#import "CCNode.h"
+#import "ccTypes.h"
+#import "ccConfig.h"
+
+@class CCParticleBatchNode;
+
+//* @enum
+enum {
+	/** The Particle emitter lives forever */
+	kCCParticleDurationInfinity = -1,
+
+	/** The starting size of the particle is equal to the ending size */
+	kCCParticleStartSizeEqualToEndSize = -1,
+
+	/** The starting radius of the particle is equal to the ending radius */
+	kCCParticleStartRadiusEqualToEndRadius = -1,
+
+	// backward compatible
+	kParticleStartSizeEqualToEndSize = kCCParticleStartSizeEqualToEndSize,
+	kParticleDurationInfinity = kCCParticleDurationInfinity,
+};
+
+//* @enum
+enum {
+	/** Gravity mode (A mode) */
+	kCCParticleModeGravity,
+
+	/** Radius mode (B mode) */
+	kCCParticleModeRadius,
+};
+
+
+/** @typedef tCCPositionType
+ possible types of particle positions
+ */
+typedef enum {
+	/** Living particles are attached to the world and are unaffected by emitter repositioning. */
+	kCCPositionTypeFree,
+
+	/** Living particles are attached to the world but will follow the emitter repositioning.
+	 Use case: Attach an emitter to an sprite, and you want that the emitter follows the sprite.
+	 */
+	kCCPositionTypeRelative,
+
+	/** Living particles are attached to the emitter and are translated along with it. */
+	kCCPositionTypeGrouped,
+}tCCPositionType;
+
+// backward compatible
+enum {
+	kPositionTypeFree = kCCPositionTypeFree,
+	kPositionTypeGrouped = kCCPositionTypeGrouped,
+};
+
+/** @struct tCCParticle
+ Structure that contains the values of each particle
+ */
+typedef struct sCCParticle {
+	CGPoint		pos;
+	CGPoint		startPos;
+
+	ccColor4F	color;
+	ccColor4F	deltaColor;
+
+	float		size;
+	float		deltaSize;
+
+	float		rotation;
+	float		deltaRotation;
+
+	ccTime		timeToLive;
+
+	NSUInteger	atlasIndex;
+
+	union {
+		// Mode A: gravity, direction, radial accel, tangential accel
+		struct {
+			CGPoint		dir;
+			float		radialAccel;
+			float		tangentialAccel;
+		} A;
+
+		// Mode B: radius mode
+		struct {
+			float		angle;
+			float		degreesPerSecond;
+			float		radius;
+			float		deltaRadius;
+		} B;
+	} mode;
+
+}tCCParticle;
+
+typedef void (*CC_UPDATE_PARTICLE_IMP)(id, SEL, tCCParticle*, CGPoint);
+
+@class CCTexture2D;
+
+/** Particle System base class
+ Attributes of a Particle System:
+	- emmision rate of the particles
+	- Gravity Mode (Mode A):
+		- gravity
+		- direction
+		- speed +-  variance
+		- tangential acceleration +- variance
+		- radial acceleration +- variance
+	- Radius Mode (Mode B):
+		- startRadius +- variance
+		- endRadius +- variance
+		- rotate +- variance
+	- Properties common to all modes:
+		- life +- life variance
+		- start spin +- variance
+		- end spin +- variance
+		- start size +- variance
+		- end size +- variance
+		- start color +- variance
+		- end color +- variance
+		- life +- variance
+		- blending function
+	- texture
+
+ cocos2d also supports particles generated by Particle Designer (http://particledesigner.71squared.com/).
+ 'Radius Mode' in Particle Designer uses a fixed emit rate of 30 hz. Since that can't be guarateed in cocos2d,
+ cocos2d uses a another approach, but the results are almost identical.
+
+ cocos2d supports all the variables used by Particle Designer plus a bit more:
+	- spinning particles (supported when using CCParticleSystemQuad)
+	- tangential acceleration (Gravity mode)
+	- radial acceleration (Gravity mode)
+	- radius direction (Radius mode) (Particle Designer supports outwards to inwards direction only)
+
+ It is possible to customize any of the above mentioned properties in runtime. Example:
+
+ @code
+	emitter.radialAccel = 15;
+	emitter.startSpin = 0;
+ @endcode
+
+ */
+@interface CCParticleSystem : CCNode <CCTextureProtocol>
+{
+	// is the particle system active ?
+	BOOL _active;
+	// duration in seconds of the system. -1 is infinity
+	float _duration;
+	// time elapsed since the start of the system (in seconds)
+	float _elapsed;
+
+	// position is from "superclass" CocosNode
+	CGPoint _sourcePosition;
+	// Position variance
+	CGPoint _posVar;
+
+	// The angle (direction) of the particles measured in degrees
+	float _angle;
+	// Angle variance measured in degrees;
+	float _angleVar;
+
+	// Different modes
+
+	NSInteger _emitterMode;
+	union {
+		// Mode A:Gravity + Tangential Accel + Radial Accel
+		struct {
+			// gravity of the particles
+			CGPoint gravity;
+
+			// The speed the particles will have.
+			float speed;
+			// The speed variance
+			float speedVar;
+
+			// Tangential acceleration
+			float tangentialAccel;
+			// Tangential acceleration variance
+			float tangentialAccelVar;
+
+			// Radial acceleration
+			float radialAccel;
+			// Radial acceleration variance
+			float radialAccelVar;
+			} A;
+
+		// Mode B: circular movement (gravity, radial accel and tangential accel don't are not used in this mode)
+		struct {
+
+			// The starting radius of the particles
+			float startRadius;
+			// The starting radius variance of the particles
+			float startRadiusVar;
+			// The ending radius of the particles
+			float endRadius;
+			// The ending radius variance of the particles
+			float endRadiusVar;
+			// Number of degress to rotate a particle around the source pos per second
+			float rotatePerSecond;
+			// Variance in degrees for rotatePerSecond
+			float rotatePerSecondVar;
+		} B;
+	} _mode;
+
+	// start ize of the particles
+	float _startSize;
+	// start Size variance
+	float _startSizeVar;
+	// End size of the particle
+	float _endSize;
+	// end size of variance
+	float _endSizeVar;
+
+	// How many seconds will the particle live
+	float _life;
+	// Life variance
+	float _lifeVar;
+
+	// Start color of the particles
+	ccColor4F _startColor;
+	// Start color variance
+	ccColor4F _startColorVar;
+	// End color of the particles
+	ccColor4F _endColor;
+	// End color variance
+	ccColor4F _endColorVar;
+
+	// start angle of the particles
+	float _startSpin;
+	// start angle variance
+	float _startSpinVar;
+	// End angle of the particle
+	float _endSpin;
+	// end angle ariance
+	float _endSpinVar;
+
+	// Array of particles
+	tCCParticle *_particles;
+	// Maximum particles
+	NSUInteger _totalParticles;
+	// Count of active particles
+	NSUInteger _particleCount;
+    // Number of allocated particles
+    NSUInteger _allocatedParticles;
+
+	// How many particles can be emitted per second
+	float _emissionRate;
+	float _emitCounter;
+
+	// Texture of the particles
+	CCTexture2D *_texture;
+	// blend function
+	ccBlendFunc	_blendFunc;
+	// Texture alpha behavior
+	BOOL _opacityModifyRGB;
+
+	// movment type: free or grouped
+	tCCPositionType	_positionType;
+
+	// Whether or not the node will be auto-removed when there are not particles
+	BOOL	_autoRemoveOnFinish;
+
+	//  particle idx
+	NSUInteger _particleIdx;
+
+	// Optimization
+	CC_UPDATE_PARTICLE_IMP	_updateParticleImp;
+	SEL						_updateParticleSel;
+
+	// for batching. If nil, then it won't be batched
+	CCParticleBatchNode *_batchNode;
+
+	// index of system in batch node array
+	NSUInteger _atlasIndex;
+
+	//YES if scaled or rotated
+	BOOL _transformSystemDirty;
+}
+
+/** Is the emitter active */
+@property (nonatomic,readonly) BOOL active;
+/** Quantity of particles that are being simulated at the moment */
+@property (nonatomic,readonly) NSUInteger	particleCount;
+/** How many seconds the emitter wil run. -1 means 'forever' */
+@property (nonatomic,readwrite,assign) float duration;
+/** sourcePosition of the emitter */
+@property (nonatomic,readwrite,assign) CGPoint sourcePosition;
+/** Position variance of the emitter */
+@property (nonatomic,readwrite,assign) CGPoint posVar;
+/** life, and life variation of each particle */
+@property (nonatomic,readwrite,assign) float life;
+/** life variance of each particle */
+@property (nonatomic,readwrite,assign) float lifeVar;
+/** angle and angle variation of each particle */
+@property (nonatomic,readwrite,assign) float angle;
+/** angle variance of each particle */
+@property (nonatomic,readwrite,assign) float angleVar;
+
+/** Gravity value. Only available in 'Gravity' mode. */
+@property (nonatomic,readwrite,assign) CGPoint gravity;
+/** speed of each particle. Only available in 'Gravity' mode.  */
+@property (nonatomic,readwrite,assign) float speed;
+/** speed variance of each particle. Only available in 'Gravity' mode. */
+@property (nonatomic,readwrite,assign) float speedVar;
+/** tangential acceleration of each particle. Only available in 'Gravity' mode. */
+@property (nonatomic,readwrite,assign) float tangentialAccel;
+/** tangential acceleration variance of each particle. Only available in 'Gravity' mode. */
+@property (nonatomic,readwrite,assign) float tangentialAccelVar;
+/** radial acceleration of each particle. Only available in 'Gravity' mode. */
+@property (nonatomic,readwrite,assign) float radialAccel;
+/** radial acceleration variance of each particle. Only available in 'Gravity' mode. */
+@property (nonatomic,readwrite,assign) float radialAccelVar;
+
+/** The starting radius of the particles. Only available in 'Radius' mode. */
+@property (nonatomic,readwrite,assign) float startRadius;
+/** The starting radius variance of the particles. Only available in 'Radius' mode. */
+@property (nonatomic,readwrite,assign) float startRadiusVar;
+/** The ending radius of the particles. Only available in 'Radius' mode. */
+@property (nonatomic,readwrite,assign) float endRadius;
+/** The ending radius variance of the particles. Only available in 'Radius' mode. */
+@property (nonatomic,readwrite,assign) float endRadiusVar;
+/** Number of degress to rotate a particle around the source pos per second. Only available in 'Radius' mode. */
+@property (nonatomic,readwrite,assign) float rotatePerSecond;
+/** Variance in degrees for rotatePerSecond. Only available in 'Radius' mode. */
+@property (nonatomic,readwrite,assign) float rotatePerSecondVar;
+
+/** start size in pixels of each particle */
+@property (nonatomic,readwrite,assign) float startSize;
+/** size variance in pixels of each particle */
+@property (nonatomic,readwrite,assign) float startSizeVar;
+/** end size in pixels of each particle */
+@property (nonatomic,readwrite,assign) float endSize;
+/** end size variance in pixels of each particle */
+@property (nonatomic,readwrite,assign) float endSizeVar;
+/** start color of each particle */
+@property (nonatomic,readwrite,assign) ccColor4F startColor;
+/** start color variance of each particle */
+@property (nonatomic,readwrite,assign) ccColor4F startColorVar;
+/** end color and end color variation of each particle */
+@property (nonatomic,readwrite,assign) ccColor4F endColor;
+/** end color variance of each particle */
+@property (nonatomic,readwrite,assign) ccColor4F endColorVar;
+//* initial angle of each particle
+@property (nonatomic,readwrite,assign) float startSpin;
+//* initial angle of each particle
+@property (nonatomic,readwrite,assign) float startSpinVar;
+//* initial angle of each particle
+@property (nonatomic,readwrite,assign) float endSpin;
+//* initial angle of each particle
+@property (nonatomic,readwrite,assign) float endSpinVar;
+/** emission rate of the particles */
+@property (nonatomic,readwrite,assign) float emissionRate;
+/** maximum particles of the system */
+@property (nonatomic,readwrite,assign) NSUInteger totalParticles;
+/** conforms to CocosNodeTexture protocol */
+@property (nonatomic,readwrite, retain) CCTexture2D * texture;
+/** conforms to CocosNodeTexture protocol */
+@property (nonatomic,readwrite) ccBlendFunc blendFunc;
+/** does the alpha value modify color */
+@property (nonatomic, readwrite, getter=doesOpacityModifyRGB, assign) BOOL opacityModifyRGB;
+/** whether or not the particles are using blend additive.
+ If enabled, the following blending function will be used.
+ @code
+	source blend function = GL_SRC_ALPHA;
+	dest blend function = GL_ONE;
+ @endcode
+ */
+@property (nonatomic,readwrite) BOOL blendAdditive;
+/** particles movement type: Free or Grouped
+ @since v0.8
+ */
+@property (nonatomic,readwrite) tCCPositionType positionType;
+/** whether or not the node will be auto-removed when it has no particles left.
+ By default it is NO.
+ @since v0.8
+ */
+@property (nonatomic,readwrite) BOOL autoRemoveOnFinish;
+/** Switch between different kind of emitter modes:
+   - kCCParticleModeGravity: uses gravity, speed, radial and tangential acceleration
+   - kCCParticleModeRadius: uses radius movement + rotation
+ */
+@property (nonatomic,readwrite) NSInteger emitterMode;
+
+/** weak reference to the CCSpriteBatchNode that renders the CCSprite */
+@property (nonatomic,readwrite,assign) CCParticleBatchNode *batchNode;
+
+@property (nonatomic,readwrite) NSUInteger atlasIndex;
+
+/** creates an initializes a CCParticleSystem from a plist file.
+ This plist files can be creted manually or with Particle Designer:
+	http://particledesigner.71squared.com/
+ @since v0.99.3
+ */
++(id) particleWithFile:(NSString*)plistFile;
+
+/* creates an void particle emitter with a maximun number of particles.
+ @since v2.1
+*/
++(id) particleWithTotalParticles:(NSUInteger) numberOfParticles;
+
+
+/** initializes a CCParticleSystem from a plist file.
+ This plist files can be creted manually or with Particle Designer:
+	http://particledesigner.71squared.com/
+ @since v0.99.3
+ */
+-(id) initWithFile:(NSString*) plistFile;
+
+/** initializes a particle system from a NSDictionary.
+ @since v0.99.3
+ */
+-(id) initWithDictionary:(NSDictionary*)dictionary;
+
+/** initializes a particle system from a NSDictionary and the path from where to load the png
+ @since v2.1
+ */
+-(id) initWithDictionary:(NSDictionary *)dictionary path:(NSString*)dirname;
+
+//! Initializes a system with a fixed number of particles
+-(id) initWithTotalParticles:(NSUInteger) numberOfParticles;
+//! stop emitting particles. Running particles will continue to run until they die
+-(void) stopSystem;
+//! Kill all living particles.
+-(void) resetSystem;
+//! whether or not the system is full
+-(BOOL) isFull;
+
+//! should be overriden by subclasses
+-(void) updateQuadWithParticle:(tCCParticle*)particle newPosition:(CGPoint)pos;
+//! should be overriden by subclasses
+-(void) postStep;
+
+//! called in every loop.
+-(void) update: (ccTime) dt;
+
+-(void) updateWithNoTime;
+
+@end