/**************************************************************************** Copyright (c) 2013-2017 Chukong Technologies Inc. https://axmolengine.github.io/ 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 __CCARMATURE_DATAS_H__ #define __CCARMATURE_DATAS_H__ #include "base/CCRef.h" #include "base/ccTypes.h" #include "base/CCVector.h" #include "base/CCMap.h" #include "math/CCAffineTransform.h" #include "CCArmatureDefine.h" #include "2d/CCTweenFunction.h" #include "CocosStudioExport.h" #define AX_CREATE_NO_PARAM_NO_INIT(varType) \ public: \ static inline varType* create(void) \ { \ varType* var = new varType(); \ var->autorelease(); \ return var; \ } #define AX_CREATE_NO_PARAM(varType) \ public: \ static inline varType* create(void) \ { \ varType* var = new varType(); \ if (var->init()) \ { \ var->autorelease(); \ return var; \ } \ AX_SAFE_DELETE(var); \ return nullptr; \ } namespace cocostudio { /** * The base node include a lot of attributes. * @js NA * @lua NA */ class CCS_DLL BaseData : public ax::Ref { public: AX_CREATE_NO_PARAM_NO_INIT(BaseData) public: /** * @js ctor */ BaseData(); /** * @js NA * @lua NA */ ~BaseData(void); /* * Copy data from node * @param node A BaseData to copy data */ virtual void copy(const BaseData* node); /* * Calculate two BaseData's between value(to - from) and set to self * * @param from from BaseData * @param to to BaseData */ virtual void subtract(BaseData* from, BaseData* to, bool limit); virtual void setColor(const ax::Color4B& color); virtual ax::Color4B getColor(); public: float x; //! position x attribute float y; //! position y attribute int zOrder; //! zorder attribute, used to order the Bone's depth order /** * x y skewX skewY scaleX scaleY used to calculate transform matrix * skewX, skewY can have rotation effect * To get more matrix information, you can have a look at this paper : * http://www.senocular.com/flash/tutorials/transformmatrix/ */ float skewX; float skewY; float scaleX; float scaleY; float tweenRotate; //! SkewX, SkewY, and TweenRotate effect the rotation bool isUseColorInfo; //! Whether or not this frame have the color changed Info int a, r, g, b; }; /** * DisplayType distinguish which type your display is. */ enum DisplayType { CS_DISPLAY_SPRITE, //! display is a single Sprite CS_DISPLAY_ARMATURE, //! display is a Armature CS_DISPLAY_PARTICLE, //! display is a CCParticle. CS_DISPLAY_MAX }; /** * @js NA * @lua NA */ class CCS_DLL DisplayData : public ax::Ref { public: AX_CREATE_NO_PARAM_NO_INIT(DisplayData) static std::string changeDisplayToTexture(std::string_view displayName); public: /** * @js ctor */ DisplayData(); /** * @js NA * @lua NA */ virtual ~DisplayData(void) {} virtual void copy(DisplayData* displayData); DisplayType displayType; //! mark which type your display is std::string displayName; }; /** * @js NA * @lua NA */ class CCS_DLL SpriteDisplayData : public DisplayData { public: AX_CREATE_NO_PARAM_NO_INIT(SpriteDisplayData) public: /** * @js ctor */ SpriteDisplayData(); /** * @js NA * @lua NA */ virtual ~SpriteDisplayData(){}; void copy(DisplayData* displayData); public: BaseData skinData; }; /** * @js NA * @lua NA */ class CCS_DLL ArmatureDisplayData : public DisplayData { public: AX_CREATE_NO_PARAM_NO_INIT(ArmatureDisplayData) public: /** * @js ctor */ ArmatureDisplayData(); /** * @js NA * @lua NA */ virtual ~ArmatureDisplayData() {} }; /** * @js NA * @lua NA */ class CCS_DLL ParticleDisplayData : public DisplayData { public: AX_CREATE_NO_PARAM_NO_INIT(ParticleDisplayData) public: /** * @js ctor */ ParticleDisplayData(); /** * @js NA * @lua NA */ virtual ~ParticleDisplayData(){}; }; /** * BoneData used to init a Bone. * BoneData keeps a DisplayData list, a Bone can have many display to change. * The display information saved in the DisplayData * @js NA * @lua NA */ class CCS_DLL BoneData : public BaseData { public: AX_CREATE_NO_PARAM(BoneData) public: /** * @js ctor */ BoneData(void); /** * @js NA * @lua NA */ ~BoneData(void); virtual bool init(); void addDisplayData(DisplayData* displayData); DisplayData* getDisplayData(int index); public: std::string name; //! the bone's name std::string parentName; //! the bone parent's name ax::Vector displayDataList; //! save DisplayData informations for the Bone ax::AffineTransform boneDataTransform; }; /** * ArmatureData saved the Armature name and Bonedata needed for the CCBones in this Armature * When we create a Armature, we need to get each Bone's BoneData as it's init information. * So we can get a BoneData from the Dictionary saved in the ArmatureData. * @js NA * @lua NA */ class CCS_DLL ArmatureData : public ax::Ref { public: AX_CREATE_NO_PARAM(ArmatureData) public: /** * @js ctor */ ArmatureData(); /** * @js NA * @lua NA */ ~ArmatureData(); bool init(); void addBoneData(BoneData* boneData); BoneData* getBoneData(std::string_view boneName); public: std::string name; ax::StringMap boneDataDic; float dataVersion; }; enum BlendType { BLEND_NORMAL, BLEND_LAYER, BLEND_DARKEN, BLEND_MULTIPLY, BLEND_LIGHTEN, BLEND_SCREEN, BLEND_OVERLAY, BLEND_HARD_LIGHT, BLEND_ADD, BLEND_SUBSTRACT, BLEND_DIFFERENCE, BLEND_INVERT, BLEND_ALPHA, BLEND_ERASE }; /** * @js NA * @lua NA */ class CCS_DLL FrameData : public BaseData { public: AX_CREATE_NO_PARAM_NO_INIT(FrameData) public: /** * @js ctor */ FrameData(); /** * @js NA * @lua NA */ ~FrameData(); virtual void copy(const BaseData* baseData); public: int frameID; int duration; //! The frame will last duration frames ax::tweenfunc::TweenType tweenEasing; //! Every frame's tween easing effect int easingParamNumber; float* easingParams; bool isTween; //! Whether it's a tween key frame /** * The current display index when change to this frame. * If value is -1, then display will not be shown. */ int displayIndex; ax::BlendFunc blendFunc; std::string strEvent; /** * strMovement, strEvent, strSound, strSoundEffect do not support yet */ std::string strMovement; std::string strSound; std::string strSoundEffect; }; /** * @js NA * @lua NA */ class CCS_DLL MovementBoneData : public ax::Ref { public: AX_CREATE_NO_PARAM(MovementBoneData) public: /** * @js ctor */ MovementBoneData(); /** * @js NA * @lua NA */ ~MovementBoneData(void); virtual bool init(); void addFrameData(FrameData* frameData); FrameData* getFrameData(int index); public: float delay; //! movement delay percent, this value can produce a delay effect float scale; //! scale this movement float duration; //! this Bone in this movement will last m_iDuration frames std::string name; //! bone name ax::Vector frameList; }; /** * @js NA * @lua NA */ class CCS_DLL MovementData : public ax::Ref { public: AX_CREATE_NO_PARAM_NO_INIT(MovementData) public: /** * @js ctor */ MovementData(void); /** * @js NA * @lua NA */ ~MovementData(void); void addMovementBoneData(MovementBoneData* movBoneData); MovementBoneData* getMovementBoneData(std::string_view boneName); public: std::string name; int duration; //! the frames this movement will last float scale; //! scale this movement /** * Change to this movement will last durationTo frames. Use this effect can avoid too suddenly changing. * * Example : current movement is "stand", we want to change to "run", then we fill durationTo frames before * change to "run" instead of changing to "run" directly. */ int durationTo; /* * This is different from duration, durationTween contain tween effect. * duration is the raw time that the animation will last, it's the same with the time you edit in the Action Editor. * durationTween is the actual time you want this animation last. * Example : If we edit 10 frames in the flash, then duration is 10. When we set durationTween to 50, the movement * will last 50 frames, the extra 40 frames will auto filled with tween effect */ int durationTween; bool loop; //! whether the movement was looped /** * Which tween easing effect the movement use * TWEEN_EASING_MAX : use the value from MovementData get from flash design panel */ ax::tweenfunc::TweenType tweenEasing; /** * @brief save movement bone data * @key std::string_view * @value MovementBoneData * */ ax::StringMap movBoneDataDic; }; /** * AnimationData include all movement information for the Armature * The struct is AnimationData -> MovementData -> MovementBoneData -> FrameData * -> MovementFrameData * @js NA * @lua NA */ class CCS_DLL AnimationData : public ax::Ref { public: AX_CREATE_NO_PARAM_NO_INIT(AnimationData) public: /** * @js ctor */ AnimationData(void); /** * @js NA * @lua NA */ ~AnimationData(void); void addMovement(MovementData* movData); MovementData* getMovement(std::string_view movementName); ssize_t getMovementCount(); public: std::string name; ax::StringMap movementDataDic; std::vector movementNames; }; /* * ContourData include a contour vertex information * @js NA * @lua NA */ class CCS_DLL ContourData : public ax::Ref { public: AX_CREATE_NO_PARAM(ContourData) public: /** * @js ctor */ ContourData(); /** * @js NA * @lua NA */ ~ContourData(void); virtual bool init(); virtual void addVertex(ax::Vec2& vertex); public: std::vector vertexList; //! Save contour vertex info, vertex saved in a Vec2 }; /* * TextureData include a texture's information * @js NA * @lua NA */ class CCS_DLL TextureData : public ax::Ref { public: AX_CREATE_NO_PARAM(TextureData) public: /** * @js ctor */ TextureData(); /** * @js NA * @lua NA */ ~TextureData(void); virtual bool init(); void addContourData(ContourData* contourData); ContourData* getContourData(int index); public: float height; //! The texture's width, height float width; float pivotX; //! The texture's anchor point float pivotY; std::string name; //! The texture's name ax::Vector contourDataList; }; } // namespace cocostudio #endif /*__CCARMATURE_DATAS_H__*/