2020-10-17 16:32:16 +08:00
|
|
|
/****************************************************************************
|
2019-11-24 23:15:56 +08:00
|
|
|
Copyright (c) 2013-2017 Chukong Technologies Inc.
|
2019-11-23 20:27:39 +08:00
|
|
|
|
2022-07-10 09:47:41 +08:00
|
|
|
https://axis-project.github.io/
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
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 __CCDISPLAYMANAGER_H__
|
|
|
|
#define __CCDISPLAYMANAGER_H__
|
|
|
|
|
2020-10-21 10:12:00 +08:00
|
|
|
#include "CCArmatureDefine.h"
|
|
|
|
#include "CCDecorativeDisplay.h"
|
|
|
|
#include "CCDatas.h"
|
|
|
|
#include "CocosStudioExport.h"
|
2019-11-23 20:27:39 +08:00
|
|
|
|
2021-12-25 10:04:45 +08:00
|
|
|
namespace cocostudio
|
|
|
|
{
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
class Bone;
|
|
|
|
|
|
|
|
/**! DisplayManager manages Bone's display
|
|
|
|
* @js NA
|
|
|
|
* @lua NA
|
|
|
|
*/
|
2022-07-11 17:50:21 +08:00
|
|
|
class CCS_DLL DisplayManager : public axis::Ref
|
2019-11-23 20:27:39 +08:00
|
|
|
{
|
|
|
|
public:
|
2021-12-25 10:04:45 +08:00
|
|
|
static DisplayManager* create(Bone* bone);
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
public:
|
|
|
|
DisplayManager();
|
|
|
|
~DisplayManager();
|
|
|
|
|
2021-12-25 10:04:45 +08:00
|
|
|
bool init(Bone* bone);
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Use BoneData to init the display list.
|
2021-12-25 10:04:45 +08:00
|
|
|
* If display is a sprite, and it have texture info in the TextureData, then use TextureData to init the display's
|
|
|
|
* anchor point If the display is a Armature, then create a new Armature
|
2019-11-23 20:27:39 +08:00
|
|
|
*/
|
2021-12-25 10:04:45 +08:00
|
|
|
virtual void initDisplayList(BoneData* boneData);
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Add display and use _DisplayData init the display.
|
|
|
|
* If index already have a display, then replace it.
|
|
|
|
* If index is current display index, then also change display to _index
|
|
|
|
*
|
|
|
|
* @param displayData it include the display information, like DisplayType.
|
|
|
|
* If you want to create a sprite display, then create a SpriteDisplayData param
|
|
|
|
*
|
|
|
|
* @param index the index of the display you want to replace or add to
|
|
|
|
* -1 : append display from back
|
|
|
|
*/
|
2021-12-25 10:04:45 +08:00
|
|
|
void addDisplay(DisplayData* displayData, int index);
|
2019-11-23 20:27:39 +08:00
|
|
|
|
2022-07-11 17:50:21 +08:00
|
|
|
void addDisplay(axis::Node* display, int index);
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
void removeDisplay(int index);
|
|
|
|
|
2022-07-11 17:50:21 +08:00
|
|
|
const axis::Vector<DecorativeDisplay*>& getDecorativeDisplayList() const;
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
/*
|
|
|
|
* @deprecated, please use changeDisplayWithIndex and changeDisplayWithName
|
|
|
|
*/
|
2022-07-15 19:44:31 +08:00
|
|
|
CC_DEPRECATED_ATTRIBUTE void changeDisplayByIndex(int index, bool force);
|
|
|
|
CC_DEPRECATED_ATTRIBUTE void changeDisplayByName(std::string_view name, bool force);
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/**
|
|
|
|
* Change display by index. You can just use this method to change display in the display list.
|
|
|
|
* The display list is just used for this bone, and it is the displays you may use in every frame.
|
|
|
|
*
|
|
|
|
* Note : if index is the same with prev index, the method will not effect
|
|
|
|
*
|
|
|
|
* @param index The index of the display you want to change
|
2021-12-25 10:04:45 +08:00
|
|
|
* @param force If true, then force change display to specified display, or current display will set to display
|
|
|
|
* index edit in the flash every key frame.
|
2019-11-23 20:27:39 +08:00
|
|
|
*/
|
|
|
|
void changeDisplayWithIndex(int index, bool force);
|
2021-12-31 12:12:40 +08:00
|
|
|
void changeDisplayWithName(std::string_view name, bool force);
|
2019-11-23 20:27:39 +08:00
|
|
|
|
2022-07-11 17:50:21 +08:00
|
|
|
axis::Node* getDisplayRenderNode() const;
|
2019-11-23 20:27:39 +08:00
|
|
|
DisplayType getDisplayRenderNodeType() const;
|
|
|
|
|
|
|
|
int getCurrentDisplayIndex() const;
|
|
|
|
|
2021-12-25 10:04:45 +08:00
|
|
|
virtual void setCurrentDecorativeDisplay(DecorativeDisplay* decoDisplay);
|
|
|
|
virtual DecorativeDisplay* getCurrentDecorativeDisplay() const;
|
|
|
|
virtual DecorativeDisplay* getDecorativeDisplayByIndex(int index) const;
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Sets whether the display is visible
|
|
|
|
* The default value is true, a node is default to visible
|
|
|
|
*
|
|
|
|
* @param visible true if the node is visible, false if the node is hidden.
|
|
|
|
*/
|
|
|
|
virtual void setVisible(bool visible);
|
|
|
|
/**
|
|
|
|
* Determines if the display is visible
|
|
|
|
*
|
|
|
|
* @see setVisible(bool)
|
|
|
|
* @return true if the node is visible, false if the node is hidden.
|
|
|
|
*/
|
|
|
|
virtual bool isVisible() const;
|
|
|
|
|
2022-07-11 17:50:21 +08:00
|
|
|
axis::Size getContentSize() const;
|
|
|
|
axis::Rect getBoundingBox() const;
|
2019-11-23 20:27:39 +08:00
|
|
|
|
2022-07-11 17:50:21 +08:00
|
|
|
axis::Vec2 getAnchorPoint() const;
|
|
|
|
axis::Vec2 getAnchorPointInPoints() const;
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Check if the position is inside the bone.
|
|
|
|
*/
|
2022-07-11 17:50:21 +08:00
|
|
|
virtual bool containPoint(axis::Vec2& _point);
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Check if the position is inside the bone.
|
|
|
|
*/
|
|
|
|
virtual bool containPoint(float x, float y);
|
|
|
|
|
|
|
|
virtual void setForceChangeDisplay(bool force) { _forceChangeDisplay = force; }
|
|
|
|
virtual bool isForceChangeDisplay() const { return _forceChangeDisplay; }
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
protected:
|
2022-07-11 17:50:21 +08:00
|
|
|
axis::Vector<DecorativeDisplay*> _decoDisplayList;
|
2019-11-23 20:27:39 +08:00
|
|
|
//! Display render node.
|
2022-07-11 17:50:21 +08:00
|
|
|
axis::Node* _displayRenderNode;
|
2019-11-23 20:27:39 +08:00
|
|
|
//! Display render node type
|
|
|
|
DisplayType _displayType;
|
|
|
|
//! Include current display information, like contour sprite, etc.
|
2021-12-25 10:04:45 +08:00
|
|
|
DecorativeDisplay* _currentDecoDisplay;
|
2019-11-23 20:27:39 +08:00
|
|
|
//! Current display index
|
|
|
|
int _displayIndex;
|
|
|
|
|
|
|
|
bool _forceChangeDisplay;
|
|
|
|
|
|
|
|
//! Whether of not the bone is visible. Default is true
|
|
|
|
bool _visible;
|
|
|
|
|
2021-12-25 10:04:45 +08:00
|
|
|
Bone* _bone;
|
2019-11-23 20:27:39 +08:00
|
|
|
};
|
|
|
|
|
2021-12-25 10:04:45 +08:00
|
|
|
} // namespace cocostudio
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
#endif /*__CCDISPLAYMANAGER_H__*/
|