axmol/extensions/spine/SkeletonRenderer.h

163 lines
6.9 KiB
C
Raw Normal View History

2019-11-23 20:27:39 +08:00
/******************************************************************************
2019-12-12 23:26:12 +08:00
* Spine Runtimes License Agreement
2022-11-07 15:48:19 +08:00
* Last updated September 24, 2021. Replaces all prior versions.
2019-11-23 20:27:39 +08:00
*
2022-11-07 15:48:19 +08:00
* Copyright (c) 2013-2021, Esoteric Software LLC
2019-11-23 20:27:39 +08:00
*
2019-12-12 23:26:12 +08:00
* Integration of the Spine Runtimes into software or otherwise creating
* derivative works of the Spine Runtimes is permitted under the terms and
* conditions of Section 2 of the Spine Editor License Agreement:
* http://esotericsoftware.com/spine-editor-license
2019-11-23 20:27:39 +08:00
*
2019-12-12 23:26:12 +08:00
* Otherwise, it is permitted to integrate the Spine Runtimes into software
* or otherwise create derivative works of the Spine Runtimes (collectively,
* "Products"), provided that each user of the Products must obtain their own
* Spine Editor license and redistribution of the Products in any form must
* include this license and copyright notice.
*
2020-01-05 03:09:32 +08:00
* THE SPINE RUNTIMES ARE PROVIDED BY ESOTERIC SOFTWARE LLC "AS IS" AND ANY
* EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
* WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL ESOTERIC SOFTWARE LLC BE LIABLE FOR ANY
* DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
* (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES,
* BUSINESS INTERRUPTION, OR LOSS OF USE, DATA, OR PROFITS) HOWEVER CAUSED AND
* ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
* THE SPINE RUNTIMES, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
2019-11-23 20:27:39 +08:00
*****************************************************************************/
#ifndef SPINE_SKELETONRENDERER_H_
#define SPINE_SKELETONRENDERER_H_
#include "cocos2d.h"
2020-01-05 03:09:32 +08:00
#include <spine/spine.h>
2019-11-23 20:27:39 +08:00
namespace spine {
2020-01-05 03:09:32 +08:00
2022-11-07 15:48:19 +08:00
// class AttachmentVertices;
2020-01-05 03:09:32 +08:00
2019-12-12 23:26:12 +08:00
/* Draws a skeleton. */
2022-11-07 15:48:19 +08:00
class SP_API SkeletonRenderer : public cocos2d::Node, public cocos2d::BlendProtocol {
2019-12-12 23:26:12 +08:00
public:
CREATE_FUNC(SkeletonRenderer);
2022-11-07 15:48:19 +08:00
static SkeletonRenderer *createWithSkeleton(Skeleton *skeleton, bool ownsSkeleton = false, bool ownsSkeletonData = false);
static SkeletonRenderer *createWithData(SkeletonData *skeletonData, bool ownsSkeletonData = false);
static SkeletonRenderer *createWithFile(const std::string &skeletonDataFile, Atlas *atlas, float scale = 1);
static SkeletonRenderer *createWithFile(const std::string &skeletonDataFile, const std::string &atlasFile, float scale = 1);
2020-01-05 03:09:32 +08:00
2022-11-07 15:48:19 +08:00
void update(float deltaTime) override;
void draw(cocos2d::Renderer *renderer, const cocos2d::Mat4 &transform, uint32_t transformFlags) override;
cocos2d::Rect getBoundingBox() const override;
void onEnter() override;
void onExit() override;
2020-01-05 03:09:32 +08:00
2022-11-07 15:48:19 +08:00
Skeleton *getSkeleton() const;
2020-01-05 03:09:32 +08:00
2019-12-12 23:26:12 +08:00
void setTimeScale(float scale);
float getTimeScale() const;
2020-01-05 03:09:32 +08:00
2019-12-12 23:26:12 +08:00
/* */
void setDebugSlotsEnabled(bool enabled);
bool getDebugSlotsEnabled() const;
2020-01-05 03:09:32 +08:00
2019-12-12 23:26:12 +08:00
void setDebugBonesEnabled(bool enabled);
bool getDebugBonesEnabled() const;
2020-01-05 03:09:32 +08:00
2019-12-12 23:26:12 +08:00
void setDebugMeshesEnabled(bool enabled);
bool getDebugMeshesEnabled() const;
2020-01-05 03:09:32 +08:00
void setDebugBoundingRectEnabled(bool enabled);
bool getDebugBoundingRectEnabled() const;
2019-12-12 23:26:12 +08:00
// --- Convenience methods for common Skeleton_* functions.
2022-11-07 15:48:19 +08:00
void updateWorldTransform();
2020-01-05 03:09:32 +08:00
2022-11-07 15:48:19 +08:00
void setToSetupPose();
void setBonesToSetupPose();
void setSlotsToSetupPose();
2020-01-05 03:09:32 +08:00
2019-12-12 23:26:12 +08:00
/* Returns 0 if the bone was not found. */
2022-11-07 15:48:19 +08:00
Bone *findBone(const std::string &boneName) const;
2019-12-12 23:26:12 +08:00
/* Returns 0 if the slot was not found. */
2022-11-07 15:48:19 +08:00
Slot *findSlot(const std::string &slotName) const;
2020-01-05 03:09:32 +08:00
2019-12-12 23:26:12 +08:00
/* Sets the skin used to look up attachments not found in the SkeletonData defaultSkin. Attachments from the new skin are
* attached if the corresponding attachment from the old skin was attached.
* @param skin May be empty string ("") for no skin.*/
2022-11-07 15:48:19 +08:00
void setSkin(const std::string &skinName);
2019-12-12 23:26:12 +08:00
/** @param skin May be 0 for no skin.*/
2022-11-07 15:48:19 +08:00
void setSkin(const char *skinName);
2020-01-05 03:09:32 +08:00
2019-12-12 23:26:12 +08:00
/* Returns 0 if the slot or attachment was not found. */
2022-11-07 15:48:19 +08:00
Attachment *getAttachment(const std::string &slotName, const std::string &attachmentName) const;
2019-12-12 23:26:12 +08:00
/* Returns false if the slot or attachment was not found.
* @param attachmentName May be empty string ("") for no attachment. */
2022-11-07 15:48:19 +08:00
bool setAttachment(const std::string &slotName, const std::string &attachmentName);
2019-12-12 23:26:12 +08:00
/* @param attachmentName May be 0 for no attachment. */
2022-11-07 15:48:19 +08:00
bool setAttachment(const std::string &slotName, const char *attachmentName);
2020-01-05 03:09:32 +08:00
2019-12-12 23:26:12 +08:00
/* Enables/disables two color tinting for this instance. May break batching */
void setTwoColorTint(bool enabled);
/* Whether two color tinting is enabled */
bool isTwoColorTint();
2020-01-05 03:09:32 +08:00
2019-12-12 23:26:12 +08:00
/* Sets the range of slots that should be rendered. Use -1, -1 to clear the range */
void setSlotsRange(int startSlotIndex, int endSlotIndex);
2020-01-05 03:09:32 +08:00
2019-12-12 23:26:12 +08:00
// --- BlendProtocol
2022-11-07 15:48:19 +08:00
void setBlendFunc(const cocos2d::BlendFunc &blendFunc) override;
const cocos2d::BlendFunc &getBlendFunc() const override;
void setOpacityModifyRGB(bool value) override;
bool isOpacityModifyRGB() const override;
2020-01-05 03:09:32 +08:00
2022-11-07 15:48:19 +08:00
CC_CONSTRUCTOR_ACCESS : SkeletonRenderer();
SkeletonRenderer(Skeleton *skeleton, bool ownsSkeleton = false, bool ownsSkeletonData = false, bool ownsAtlas = false);
SkeletonRenderer(SkeletonData *skeletonData, bool ownsSkeletonData = false);
SkeletonRenderer(const std::string &skeletonDataFile, Atlas *atlas, float scale = 1);
SkeletonRenderer(const std::string &skeletonDataFile, const std::string &atlasFile, float scale = 1);
2020-01-05 03:09:32 +08:00
2022-11-07 15:48:19 +08:00
virtual ~SkeletonRenderer();
2020-01-05 03:09:32 +08:00
2022-11-07 15:48:19 +08:00
void initWithSkeleton(Skeleton *skeleton, bool ownsSkeleton = false, bool ownsSkeletonData = false, bool ownsAtlas = false);
void initWithData(SkeletonData *skeletonData, bool ownsSkeletonData = false);
void initWithJsonFile(const std::string &skeletonDataFile, Atlas *atlas, float scale = 1);
void initWithJsonFile(const std::string &skeletonDataFile, const std::string &atlasFile, float scale = 1);
void initWithBinaryFile(const std::string &skeletonDataFile, Atlas *atlas, float scale = 1);
void initWithBinaryFile(const std::string &skeletonDataFile, const std::string &atlasFile, float scale = 1);
2020-01-05 03:09:32 +08:00
2022-11-07 15:48:19 +08:00
virtual void initialize();
2020-01-05 03:09:32 +08:00
2019-12-12 23:26:12 +08:00
protected:
2022-11-07 15:48:19 +08:00
void setSkeletonData(SkeletonData *skeletonData, bool ownsSkeletonData);
2019-12-12 23:26:12 +08:00
void setupGLProgramState(bool twoColorTintEnabled);
2022-11-07 15:48:19 +08:00
virtual void drawDebug(cocos2d::Renderer *renderer, const cocos2d::Mat4 &transform, uint32_t transformFlags);
2020-01-05 03:09:32 +08:00
2019-12-12 23:26:12 +08:00
bool _ownsSkeletonData;
bool _ownsSkeleton;
2020-01-05 03:09:32 +08:00
bool _ownsAtlas = false;
2022-11-07 15:48:19 +08:00
Atlas *_atlas;
AttachmentLoader *_attachmentLoader;
cocos2d::CustomCommand _debugCommand;
cocos2d::BlendFunc _blendFunc;
2019-12-12 23:26:12 +08:00
bool _premultipliedAlpha;
2022-11-07 15:48:19 +08:00
Skeleton *_skeleton;
2019-12-12 23:26:12 +08:00
float _timeScale;
bool _debugSlots;
bool _debugBones;
bool _debugMeshes;
2020-01-05 03:09:32 +08:00
bool _debugBoundingRect;
2022-11-07 15:48:19 +08:00
SkeletonClipping *_clipper;
cocos2d::Rect _boundingRect;
2020-01-05 03:09:32 +08:00
2019-12-12 23:26:12 +08:00
int _startSlotIndex;
int _endSlotIndex;
2020-01-05 03:09:32 +08:00
bool _twoColorTint;
2022-11-07 15:48:19 +08:00
//Pool<AttachmentVertices*> _verticesPool;
2019-12-12 23:26:12 +08:00
};
2020-01-05 03:09:32 +08:00
2022-11-07 15:48:19 +08:00
}// namespace spine
2019-11-23 20:27:39 +08:00
#endif /* SPINE_SKELETONRENDERER_H_ */