123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999 |
- /****************************************************************************
- Copyright (c) 2008-2010 Ricardo Quesada
- Copyright (c) 2010-2012 cocos2d-x.org
- Copyright (c) 2011 Zynga Inc.
- Copyright (c) 2013-2017 Chukong Technologies Inc.
- http://www.cocos2d-x.org
- 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.
- ****************************************************************************/
- #ifndef __CCPARTICLE_SYSTEM_H__
- #define __CCPARTICLE_SYSTEM_H__
- #include "base/CCProtocols.h"
- #include "2d/CCNode.h"
- #include "base/CCValue.h"
- NS_CC_BEGIN
- /**
- * @addtogroup _2d
- * @{
- */
- class ParticleBatchNode;
- /** @struct sParticle
- Structure that contains the values of each particle.
- */
- struct particle_point
- {
- float x;
- float y;
- };
- class CC_DLL ParticleData
- {
- public:
- float* posx;
- float* posy;
- float* startPosX;
- float* startPosY;
- float* colorR;
- float* colorG;
- float* colorB;
- float* colorA;
-
- float* deltaColorR;
- float* deltaColorG;
- float* deltaColorB;
- float* deltaColorA;
-
- float* size;
- float* deltaSize;
- float* rotation;
- float* deltaRotation;
- float* timeToLive;
- unsigned int* atlasIndex;
-
- //! Mode A: gravity, direction, radial accel, tangential accel
- struct{
- float* dirX;
- float* dirY;
- float* radialAccel;
- float* tangentialAccel;
- } modeA;
-
- //! Mode B: radius mode
- struct{
- float* angle;
- float* degreesPerSecond;
- float* radius;
- float* deltaRadius;
- } modeB;
-
- unsigned int maxCount;
- ParticleData();
- bool init(int count);
- void release();
- unsigned int getMaxCount() { return maxCount; }
-
- void copyParticle(int p1, int p2)
- {
- posx[p1] = posx[p2];
- posy[p1] = posy[p2];
- startPosX[p1] = startPosX[p2];
- startPosY[p1] = startPosY[p2];
-
- colorR[p1] = colorR[p2];
- colorG[p1] = colorG[p2];
- colorB[p1] = colorB[p2];
- colorA[p1] = colorA[p2];
-
- deltaColorR[p1] = deltaColorR[p2];
- deltaColorG[p1] = deltaColorG[p2];
- deltaColorB[p1] = deltaColorB[p2];
- deltaColorA[p1] = deltaColorA[p2];
-
- size[p1] = size[p2];
- deltaSize[p1] = deltaSize[p2];
-
- rotation[p1] = rotation[p2];
- deltaRotation[p1] = deltaRotation[p2];
-
- timeToLive[p1] = timeToLive[p2];
-
- atlasIndex[p1] = atlasIndex[p2];
-
- modeA.dirX[p1] = modeA.dirX[p2];
- modeA.dirY[p1] = modeA.dirY[p2];
- modeA.radialAccel[p1] = modeA.radialAccel[p2];
- modeA.tangentialAccel[p1] = modeA.tangentialAccel[p2];
-
- modeB.angle[p1] = modeB.angle[p2];
- modeB.degreesPerSecond[p1] = modeB.degreesPerSecond[p2];
- modeB.radius[p1] = modeB.radius[p2];
- modeB.deltaRadius[p1] = modeB.deltaRadius[p2];
-
- }
- };
- //typedef void (*CC_UPDATE_PARTICLE_IMP)(id, SEL, tParticle*, Vec2);
- class Texture2D;
- /** @class ParticleSystem
- * @brief Particle System base class.
- Attributes of a Particle System:
- - emission 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 guaranteed 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 ParticleSystemQuad)
- - 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
- */
- #if (CC_TARGET_PLATFORM == CC_PLATFORM_WINRT)
- #ifdef RELATIVE
- #undef RELATIVE
- #endif
- #endif
- class CC_DLL ParticleSystem : public Node, public TextureProtocol, public PlayableProtocol
- {
- public:
- /** Mode
- * @js cc.ParticleSystem.MODE_GRAVITY;
- */
- enum class Mode
- {
- GRAVITY,
- RADIUS,
- };
-
- /** PositionType
- Possible types of particle positions.
- * @js cc.ParticleSystem.TYPE_FREE
- */
- enum class PositionType
- {
- FREE, /** Living particles are attached to the world and are unaffected by emitter repositioning. */
-
- RELATIVE, /** 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.*/
-
- GROUPED, /** Living particles are attached to the emitter and are translated along with it. */
- };
-
- //* @enum
- enum {
- /** The Particle emitter lives forever. */
- DURATION_INFINITY = -1,
-
- /** The starting size of the particle is equal to the ending size. */
- START_SIZE_EQUAL_TO_END_SIZE = -1,
-
- /** The starting radius of the particle is equal to the ending radius. */
- START_RADIUS_EQUAL_TO_END_RADIUS = -1,
- };
-
- /** Creates an initializes a ParticleSystem from a plist file.
- This plist files can be created manually or with Particle Designer:
- http://particledesigner.71squared.com/
- @since v2.0
- *
- * @param plistFile Particle plist file name.
- * @return An autoreleased ParticleSystem object.
- */
- static ParticleSystem * create(const std::string& plistFile);
- /** Create a system with a fixed number of particles.
- *
- * @param numberOfParticles A given number of particles.
- * @return An autoreleased ParticleSystemQuad object.
- * @js NA
- */
- static ParticleSystem* createWithTotalParticles(int numberOfParticles);
- /** Gets all ParticleSystem references
- */
- static Vector<ParticleSystem*>& getAllParticleSystems();
- public:
- void addParticles(int count);
-
- void stopSystem();
- /** Kill all living particles.
- */
- void resetSystem();
- /** Whether or not the system is full.
- *
- * @return True if the system is full.
- */
- bool isFull();
- /** Update the verts position data of particle,
- should be overridden by subclasses.
- */
- virtual void updateParticleQuads();
- /** Update the VBO verts buffer which does not use batch node,
- should be overridden by subclasses. */
- virtual void postStep();
- /** Call the update method with no time..
- */
- virtual void updateWithNoTime();
- /** Whether or not the particle system removed self on finish.
- *
- * @return True if the particle system removed self on finish.
- */
- virtual bool isAutoRemoveOnFinish() const;
-
- /** Set the particle system auto removed it self on finish.
- *
- * @param var True if the particle system removed self on finish.
- */
- virtual void setAutoRemoveOnFinish(bool var);
- // mode A
- /** Gets the gravity.
- *
- * @return The gravity.
- */
- virtual const Vec2& getGravity();
- /** Sets the gravity.
- *
- * @param g The gravity.
- */
- virtual void setGravity(const Vec2& g);
- /** Gets the speed.
- *
- * @return The speed.
- */
- virtual float getSpeed() const;
- /** Sets the speed.
- *
- * @param speed The speed.
- */
- virtual void setSpeed(float speed);
- /** Gets the speed variance.
- *
- * @return The speed variance.
- */
- virtual float getSpeedVar() const;
- /** Sets the speed variance.
- *
- * @param speed The speed variance.
- */
- virtual void setSpeedVar(float speed);
- /** Gets the tangential acceleration.
- *
- * @return The tangential acceleration.
- */
- virtual float getTangentialAccel() const;
- /** Sets the tangential acceleration.
- *
- * @param t The tangential acceleration.
- */
- virtual void setTangentialAccel(float t);
- /** Gets the tangential acceleration variance.
- *
- * @return The tangential acceleration variance.
- */
- virtual float getTangentialAccelVar() const;
- /** Sets the tangential acceleration variance.
- *
- * @param t The tangential acceleration variance.
- */
- virtual void setTangentialAccelVar(float t);
- /** Gets the radial acceleration.
- *
- * @return The radial acceleration.
- */
- virtual float getRadialAccel() const;
- /** Sets the radial acceleration.
- *
- * @param t The radial acceleration.
- */
- virtual void setRadialAccel(float t);
- /** Gets the radial acceleration variance.
- *
- * @return The radial acceleration variance.
- */
- virtual float getRadialAccelVar() const;
- /** Sets the radial acceleration variance.
- *
- * @param t The radial acceleration variance.
- */
- virtual void setRadialAccelVar(float t);
- /** Whether or not the rotation of each particle to its direction.
- *
- * @return True if the rotation is the direction.
- */
- virtual bool getRotationIsDir() const;
- /** Sets the rotation of each particle to its direction.
- *
- * @param t True if the rotation is the direction.
- */
- virtual void setRotationIsDir(bool t);
- // mode B
- /** Gets the start radius.
- *
- * @return The start radius.
- */
- virtual float getStartRadius() const;
- /** Sets the start radius.
- *
- * @param startRadius The start radius.
- */
- virtual void setStartRadius(float startRadius);
- /** Gets the start radius variance.
- *
- * @return The start radius variance.
- */
- virtual float getStartRadiusVar() const;
- /** Sets the start radius variance.
- *
- * @param startRadiusVar The start radius variance.
- */
- virtual void setStartRadiusVar(float startRadiusVar);
- /** Gets the end radius.
- *
- * @return The end radius.
- */
- virtual float getEndRadius() const;
- /** Sets the end radius.
- *
- * @param endRadius The end radius.
- */
- virtual void setEndRadius(float endRadius);
- /** Gets the end radius variance.
- *
- * @return The end radius variance.
- */
- virtual float getEndRadiusVar() const;
- /** Sets the end radius variance.
- *
- * @param endRadiusVar The end radius variance.
- */
- virtual void setEndRadiusVar(float endRadiusVar);
- /** Gets the number of degrees to rotate a particle around the source pos per second.
- *
- * @return The number of degrees to rotate a particle around the source pos per second.
- */
- virtual float getRotatePerSecond() const;
- /** Sets the number of degrees to rotate a particle around the source pos per second.
- *
- * @param degrees The number of degrees to rotate a particle around the source pos per second.
- */
- virtual void setRotatePerSecond(float degrees);
- /** Gets the rotate per second variance.
- *
- * @return The rotate per second variance.
- */
- virtual float getRotatePerSecondVar() const;
- /** Sets the rotate per second variance.
- *
- * @param degrees The rotate per second variance.
- */
- virtual void setRotatePerSecondVar(float degrees);
- virtual void setScale(float s) override;
- virtual void setRotation(float newRotation) override;
- virtual void setScaleX(float newScaleX) override;
- virtual void setScaleY(float newScaleY) override;
- /** Whether or not the particle system is active.
- *
- * @return True if the particle system is active.
- */
- virtual bool isActive() const;
- /** Whether or not the particle system is blend additive.
- *
- * @return True if the particle system is blend additive.
- */
- virtual bool isBlendAdditive() const;
- /** Sets the particle system blend additive.
- *
- * @param value True if the particle system is blend additive.
- */
- virtual void setBlendAdditive(bool value);
- /** Gets the batch node.
- *
- * @return The batch node.
- */
- virtual ParticleBatchNode* getBatchNode() const;
- /** Sets the batch node.
- *
- * @param batchNode The batch node.
- */
- virtual void setBatchNode(ParticleBatchNode* batchNode);
-
- /** Gets the index of system in batch node array.
- *
- * @return The index of system in batch node array.
- */
- int getAtlasIndex() const { return _atlasIndex; }
- /** Sets the index of system in batch node array.
- *
- * @param index The index of system in batch node array.
- */
- void setAtlasIndex(int index) { _atlasIndex = index; }
- /** Gets the Quantity of particles that are being simulated at the moment.
- *
- * @return The Quantity of particles that are being simulated at the moment.
- */
- unsigned int getParticleCount() const { return _particleCount; }
-
- /** Gets how many seconds the emitter will run. -1 means 'forever'.
- *
- * @return The seconds that the emitter will run. -1 means 'forever'.
- */
- float getDuration() const { return _duration; }
- /** Sets how many seconds the emitter will run. -1 means 'forever'.
- *
- * @param duration The seconds that the emitter will run. -1 means 'forever'.
- */
- void setDuration(float duration) { _duration = duration; }
-
- /** Gets the source position of the emitter.
- *
- * @return The source position of the emitter.
- */
- const Vec2& getSourcePosition() const { return _sourcePosition; }
- /** Sets the source position of the emitter.
- *
- * @param pos The source position of the emitter.
- */
- void setSourcePosition(const Vec2& pos) { _sourcePosition = pos; }
-
- /** Gets the position variance of the emitter.
- *
- * @return The position variance of the emitter.
- */
- const Vec2& getPosVar() const { return _posVar; }
- /** Sets the position variance of the emitter.
- *
- * @param pos The position variance of the emitter.
- */
- void setPosVar(const Vec2& pos) { _posVar = pos; }
- /** Gets the life of each particle.
- *
- * @return The life of each particle.
- */
- float getLife() const { return _life; }
- /** Sets the life of each particle.
- *
- * @param life The life of each particle.
- */
- void setLife(float life) { _life = life; }
- /** Gets the life variance of each particle.
- *
- * @return The life variance of each particle.
- */
- float getLifeVar() const { return _lifeVar; }
- /** Sets the life variance of each particle.
- *
- * @param lifeVar The life variance of each particle.
- */
- void setLifeVar(float lifeVar) { _lifeVar = lifeVar; }
- /** Gets the angle of each particle.
- *
- * @return The angle of each particle.
- */
- float getAngle() const { return _angle; }
- /** Sets the angle of each particle.
- *
- * @param angle The angle of each particle.
- */
- void setAngle(float angle) { _angle = angle; }
- /** Gets the angle variance of each particle.
- *
- * @return The angle variance of each particle.
- */
- float getAngleVar() const { return _angleVar; }
- /** Sets the angle variance of each particle.
- *
- * @param angleVar The angle variance of each particle.
- */
- void setAngleVar(float angleVar) { _angleVar = angleVar; }
-
- /** Switch between different kind of emitter modes:
- - kParticleModeGravity: uses gravity, speed, radial and tangential acceleration.
- - kParticleModeRadius: uses radius movement + rotation.
- *
- * @return The mode of the emitter.
- */
- Mode getEmitterMode() const { return _emitterMode; }
- /** Sets the mode of the emitter.
- *
- * @param mode The mode of the emitter.
- */
- void setEmitterMode(Mode mode) { _emitterMode = mode; }
-
- /** Gets the start size in pixels of each particle.
- *
- * @return The start size in pixels of each particle.
- */
- float getStartSize() const { return _startSize; }
- /** Sets the start size in pixels of each particle.
- *
- * @param startSize The start size in pixels of each particle.
- */
- void setStartSize(float startSize) { _startSize = startSize; }
- /** Gets the start size variance in pixels of each particle.
- *
- * @return The start size variance in pixels of each particle.
- */
- float getStartSizeVar() const { return _startSizeVar; }
- /** Sets the start size variance in pixels of each particle.
- *
- * @param sizeVar The start size variance in pixels of each particle.
- */
- void setStartSizeVar(float sizeVar) { _startSizeVar = sizeVar; }
- /** Gets the end size in pixels of each particle.
- *
- * @return The end size in pixels of each particle.
- */
- float getEndSize() const { return _endSize; }
- /** Sets the end size in pixels of each particle.
- *
- * @param endSize The end size in pixels of each particle.
- */
- void setEndSize(float endSize) { _endSize = endSize; }
- /** Gets the end size variance in pixels of each particle.
- *
- * @return The end size variance in pixels of each particle.
- */
- float getEndSizeVar() const { return _endSizeVar; }
- /** Sets the end size variance in pixels of each particle.
- *
- * @param sizeVar The end size variance in pixels of each particle.
- */
- void setEndSizeVar(float sizeVar) { _endSizeVar = sizeVar; }
- /** Gets the start color of each particle.
- *
- * @return The start color of each particle.
- */
- const Color4F& getStartColor() const { return _startColor; }
- /** Sets the start color of each particle.
- *
- * @param color The start color of each particle.
- */
- void setStartColor(const Color4F& color) { _startColor = color; }
- /** Gets the start color variance of each particle.
- *
- * @return The start color variance of each particle.
- */
- const Color4F& getStartColorVar() const { return _startColorVar; }
- /** Sets the start color variance of each particle.
- *
- * @param color The start color variance of each particle.
- */
- void setStartColorVar(const Color4F& color) { _startColorVar = color; }
- /** Gets the end color and end color variation of each particle.
- *
- * @return The end color and end color variation of each particle.
- */
- const Color4F& getEndColor() const { return _endColor; }
- /** Sets the end color and end color variation of each particle.
- *
- * @param color The end color and end color variation of each particle.
- */
- void setEndColor(const Color4F& color) { _endColor = color; }
- /** Gets the end color variance of each particle.
- *
- * @return The end color variance of each particle.
- */
- const Color4F& getEndColorVar() const { return _endColorVar; }
- /** Sets the end color variance of each particle.
- *
- * @param color The end color variance of each particle.
- */
- void setEndColorVar(const Color4F& color) { _endColorVar = color; }
- /** Gets the start spin of each particle.
- *
- * @return The start spin of each particle.
- */
- float getStartSpin() const { return _startSpin; }
- /** Sets the start spin of each particle.
- *
- * @param spin The start spin of each particle.
- */
- void setStartSpin(float spin) { _startSpin = spin; }
- /** Gets the start spin variance of each particle.
- *
- * @return The start spin variance of each particle.
- */
- float getStartSpinVar() const { return _startSpinVar; }
- /** Sets the start spin variance of each particle.
- *
- * @param pinVar The start spin variance of each particle.
- */
- void setStartSpinVar(float pinVar) { _startSpinVar = pinVar; }
- /** Gets the end spin of each particle.
- *
- * @return The end spin of each particle.
- */
- float getEndSpin() const { return _endSpin; }
- /** Sets the end spin of each particle.
- *
- * @param endSpin The end spin of each particle.
- */
- void setEndSpin(float endSpin) { _endSpin = endSpin; }
- /** Gets the end spin variance of each particle.
- *
- * @return The end spin variance of each particle.
- */
- float getEndSpinVar() const { return _endSpinVar; }
- /** Sets the end spin variance of each particle.
- *
- * @param endSpinVar The end spin variance of each particle.
- */
- void setEndSpinVar(float endSpinVar) { _endSpinVar = endSpinVar; }
- /** Gets the emission rate of the particles.
- *
- * @return The emission rate of the particles.
- */
- float getEmissionRate() const { return _emissionRate; }
- /** Sets the emission rate of the particles.
- *
- * @param rate The emission rate of the particles.
- */
- void setEmissionRate(float rate) { _emissionRate = rate; }
- /** Gets the maximum particles of the system.
- *
- * @return The maximum particles of the system.
- */
- virtual int getTotalParticles() const;
- /** Sets the maximum particles of the system.
- *
- * @param totalParticles The maximum particles of the system.
- */
- virtual void setTotalParticles(int totalParticles);
- /** does the alpha value modify color */
- void setOpacityModifyRGB(bool opacityModifyRGB) override { _opacityModifyRGB = opacityModifyRGB; }
- bool isOpacityModifyRGB() const override { return _opacityModifyRGB; }
- CC_DEPRECATED_ATTRIBUTE bool getOpacityModifyRGB() const { return isOpacityModifyRGB(); }
-
- /** Gets the particles movement type: Free or Grouped.
- @since v0.8
- *
- * @return The particles movement type.
- */
- PositionType getPositionType() const { return _positionType; }
- /** Sets the particles movement type: Free or Grouped.
- @since v0.8
- *
- * @param type The particles movement type.
- */
- void setPositionType(PositionType type) { _positionType = type; }
-
- // Overrides
- virtual void onEnter() override;
- virtual void onExit() override;
- virtual void update(float dt) override;
- virtual Texture2D* getTexture() const override;
- virtual void setTexture(Texture2D *texture) override;
- /**
- *@code
- *When this function bound into js or lua,the parameter will be changed
- *In js: var setBlendFunc(var src, var dst)
- *In lua: local setBlendFunc(local src, local dst)
- *@endcode
- */
- virtual void setBlendFunc(const BlendFunc &blendFunc) override;
- /**
- * @js NA
- * @lua NA
- */
- virtual const BlendFunc &getBlendFunc() const override;
- const std::string& getResourceFile() const { return _plistFile; }
- /// @{
- /// @name implement Playable Protocol
- virtual void start() override;
- virtual void stop() override;
- /// @} end of PlayableProtocol
-
- CC_CONSTRUCTOR_ACCESS:
- /**
- * @js ctor
- */
- ParticleSystem();
- /**
- * @js NA
- * @lua NA
- */
- virtual ~ParticleSystem();
- /** initializes a ParticleSystem*/
- bool init() override;
- /** initializes a ParticleSystem from a plist file.
- This plist files can be created manually or with Particle Designer:
- http://particledesigner.71squared.com/
- @since v0.99.3
- */
- bool initWithFile(const std::string& plistFile);
-
- /** initializes a QuadParticleSystem from a Dictionary.
- @since v0.99.3
- */
- bool initWithDictionary(ValueMap& dictionary);
-
- /** initializes a particle system from a NSDictionary and the path from where to load the png
- @since v2.1
- */
- bool initWithDictionary(ValueMap& dictionary, const std::string& dirname);
-
- //! Initializes a system with a fixed number of particles
- virtual bool initWithTotalParticles(int numberOfParticles);
-
- /** Are the emissions paused
- @return True if the emissions are paused, else false
- */
- virtual bool isPaused() const;
-
- /* Pause the emissions*/
- virtual void pauseEmissions();
-
- /* UnPause the emissions*/
- virtual void resumeEmissions();
- protected:
- virtual void updateBlendFunc();
-
- private:
- friend class EngineDataManager;
- /** Internal use only, it's used by EngineDataManager class for Android platform */
- static void setTotalParticleCountFactor(float factor);
-
- protected:
- /** 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
- */
- bool _isBlendAdditive;
- /** whether or not the node will be auto-removed when it has no particles left.
- By default it is false.
- @since v0.8
- */
- bool _isAutoRemoveOnFinish;
- std::string _plistFile;
- //! time elapsed since the start of the system (in seconds)
- float _elapsed;
- // Different modes
- //! Mode A:Gravity + Tangential Accel + Radial Accel
- struct {
- /** Gravity value. Only available in 'Gravity' mode. */
- Vec2 gravity;
- /** speed of each particle. Only available in 'Gravity' mode. */
- float speed;
- /** speed variance of each particle. Only available in 'Gravity' mode. */
- float speedVar;
- /** tangential acceleration of each particle. Only available in 'Gravity' mode. */
- float tangentialAccel;
- /** tangential acceleration variance of each particle. Only available in 'Gravity' mode. */
- float tangentialAccelVar;
- /** radial acceleration of each particle. Only available in 'Gravity' mode. */
- float radialAccel;
- /** radial acceleration variance of each particle. Only available in 'Gravity' mode. */
- float radialAccelVar;
- /** set the rotation of each particle to its direction Only available in 'Gravity' mode. */
- bool rotationIsDir;
- } modeA;
- //! 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. Only available in 'Radius' mode. */
- float startRadius;
- /** The starting radius variance of the particles. Only available in 'Radius' mode. */
- float startRadiusVar;
- /** The ending radius of the particles. Only available in 'Radius' mode. */
- float endRadius;
- /** The ending radius variance of the particles. Only available in 'Radius' mode. */
- float endRadiusVar;
- /** Number of degrees to rotate a particle around the source pos per second. Only available in 'Radius' mode. */
- float rotatePerSecond;
- /** Variance in degrees for rotatePerSecond. Only available in 'Radius' mode. */
- float rotatePerSecondVar;
- } modeB;
-
- //particle data
- ParticleData _particleData;
- //Emitter name
- std::string _configName;
- // color modulate
- // BOOL colorModulate;
- //! How many particles can be emitted per second
- float _emitCounter;
- // Optimization
- //CC_UPDATE_PARTICLE_IMP updateParticleImp;
- //SEL updateParticleSel;
- /** weak reference to the SpriteBatchNode that renders the Sprite */
- ParticleBatchNode* _batchNode;
- // index of system in batch node array
- int _atlasIndex;
- //true if scaled or rotated
- bool _transformSystemDirty;
- // Number of allocated particles
- int _allocatedParticles;
- /** Is the emitter active */
- bool _isActive;
-
- /** Quantity of particles that are being simulated at the moment */
- int _particleCount;
- /** The factor affects the total particle count, its value should be 0.0f ~ 1.0f, default 1.0f*/
- static float __totalParticleCountFactor;
-
- /** How many seconds the emitter will run. -1 means 'forever' */
- float _duration;
- /** sourcePosition of the emitter */
- Vec2 _sourcePosition;
- /** Position variance of the emitter */
- Vec2 _posVar;
- /** life, and life variation of each particle */
- float _life;
- /** life variance of each particle */
- float _lifeVar;
- /** angle and angle variation of each particle */
- float _angle;
- /** angle variance of each particle */
- float _angleVar;
- /** Switch between different kind of emitter modes:
- - kParticleModeGravity: uses gravity, speed, radial and tangential acceleration
- - kParticleModeRadius: uses radius movement + rotation
- */
- Mode _emitterMode;
- /** start size in pixels of each particle */
- float _startSize;
- /** size variance in pixels of each particle */
- float _startSizeVar;
- /** end size in pixels of each particle */
- float _endSize;
- /** end size variance in pixels of each particle */
- float _endSizeVar;
- /** start color of each particle */
- Color4F _startColor;
- /** start color variance of each particle */
- Color4F _startColorVar;
- /** end color and end color variation of each particle */
- Color4F _endColor;
- /** end color variance of each particle */
- Color4F _endColorVar;
- //* initial angle of each particle
- float _startSpin;
- //* initial angle of each particle
- float _startSpinVar;
- //* initial angle of each particle
- float _endSpin;
- //* initial angle of each particle
- float _endSpinVar;
- /** emission rate of the particles */
- float _emissionRate;
- /** maximum particles of the system */
- int _totalParticles;
- /** conforms to CocosNodeTexture protocol */
- Texture2D* _texture;
- /** conforms to CocosNodeTexture protocol */
- BlendFunc _blendFunc;
- /** does the alpha value modify color */
- bool _opacityModifyRGB;
- /** does FlippedY variance of each particle */
- int _yCoordFlipped;
- /** particles movement type: Free or Grouped
- @since v0.8
- */
- PositionType _positionType;
-
- /** is the emitter paused */
- bool _paused;
- static Vector<ParticleSystem*> __allInstances;
-
- private:
- CC_DISALLOW_COPY_AND_ASSIGN(ParticleSystem);
- };
- // end of _2d group
- /// @}
- NS_CC_END
- #endif //__CCPARTICLE_SYSTEM_H__
|