本文来自http://blog.csdn.net/runaying ,引用必须注明出处!
cocos2d-x节点(CCActionGrid.h)API
温馨提醒:为了大家能更好学习,强烈推荐大家看看本人的这篇博客 Cocos2d-X权威指南笔记
各种网格 action 效果
///cocos2d-x-3.0alpha0/cocos2dx/actions
//各种网格 action 效果
#ifndef __ACTION_CCGRID_ACTION_H__
#define __ACTION_CCGRID_ACTION_H__
#include "CCActionInterval.h"
#include "CCActionInstant.h"
NS_CC_BEGIN
class GridBase;
/**
* @addtogroup actions
* @{
*/
/** @brief Base class for Grid actions */
class CC_DLL GridAction : public ActionInterval
{
public:
/** 使用 size 、 duration 创建一个 action*/
bool initWithDuration(float duration, const Size& gridSize);
/** returns the grid */
virtual GridBase* getGrid();
// overrides
virtual GridAction * clone() const override = 0;
virtual GridAction* reverse() const override;
virtual void startWithTarget(Node *target) override;
protected:
Size _gridSize;
};
/**
@brief Base class for Grid3D actions.
Grid3D actions 可以修改一个 non-tiled(非瓷砖) grid.
*/
class CC_DLL Grid3DAction : public GridAction
{
public:
/** returns the grid */
virtual GridBase* getGrid(void);
/** returns 顶点在网格中的位置
* @js NA
* @lua NA
*/
Vertex3F getVertex(const Point& position) const;
/** @过时不再需要建议使用新的 API 建议使用 getVertex() 代替
* @js NA
* @lua NA
*/
CC_DEPRECATED_ATTRIBUTE inline Vertex3F vertex(const Point& position) { return getVertex(position); }
/** returns non-transformed(未转化的)顶点在网格中的位置
* @js NA
* @lua NA
*/
Vertex3F getOriginalVertex(const Point& position) const;
/** @过时不再需要建议使用新的 API getOriginalVertex() 代替
* @js NA
* @lua NA
*/
CC_DEPRECATED_ATTRIBUTE inline Vertex3F originalVertex(const Point& position) { return getOriginalVertex(position); }
/** 网格中的特定位置设置一个新的顶点
* @js NA
* @lua NA
*/
void setVertex(const Point& position, const Vertex3F& vertex);
// Overrides
virtual Grid3DAction * clone() const override = 0;
};
/** @brief Base class for TiledGrid3D actions */
class CC_DLL TiledGrid3DAction : public GridAction
{
public:
/** 使用 size 、 duration 创建一个 action
* @js NA
* @lua NA
*/
static TiledGrid3DAction* create(float duration, const Size& gridSize);
/** returns grid (网格) 中特定位置的瓷砖(tile)
* @js NA
* @lua NA
*/
Quad3 getTile(const Point& position) const;
/** @过时不再需要建议使用新的 API ,可以使用 getTile() 代替
* @js NA
* @lua NA
*/
CC_DEPRECATED_ATTRIBUTE Quad3 tile(const Point& position) { return getTile(position); }
/** returns grid (网格) 中特定位置为发生转换的瓷砖(tile)
* @js NA
* @lua NA
*/
Quad3 getOriginalTile(const Point& position) const;
/** @过时不再需要建议使用新的 API ,可以使用 getOriginalTile() 代替
* @js NA
* @lua NA
*/
CC_DEPRECATED_ATTRIBUTE Quad3 originalTile(const Point& position) { return getOriginalTile(position); }
/** sets grid (网格) 中特定位置的瓷砖(tile)
* @js NA
* @lua NA
*/
void setTile(const Point& position, const Quad3& coords);
/** returns the grid */
virtual GridBase* getGrid(void);
// Override
virtual TiledGrid3DAction * clone() const override = 0;
};
/** @brief AccelDeccelAmplitude(加速减速幅度) action */
class CC_DLL AccelDeccelAmplitude : public ActionInterval
{
public:
/** 使用 具有振幅属性的内部 action 、duration 创建一个 action */
static AccelDeccelAmplitude* create(Action *pAction, float duration);
/**
* @js NA
* @lua NA
*/
virtual ~AccelDeccelAmplitude(void);
/** 使用 具有振幅属性的内部 action 、duration 初始化一个 action */
bool initWithAction(Action *pAction, float duration);
/** returns 一个动作的副本 */
virtual AccelDeccelAmplitude* clone() const;
/** returns 一个动作的逆顺序 */
virtual AccelDeccelAmplitude* reverse() const;
/** get 振幅速率 */
inline float getRate(void) const { return _rate; }
/** set 振幅速率 */
inline void setRate(float fRate) { _rate = fRate; }
// Overrides
virtual void startWithTarget(Node *target) override;
virtual void update(float time) override;
protected:
float _rate;
ActionInterval *_other;
};
/** @brief AccelAmplitude(加速幅度) action */
class CC_DLL AccelAmplitude : public ActionInterval
{
public:
/** 使用 具有振幅属性的内部 action 、duration 创建一个 action */
static AccelAmplitude* create(Action *pAction, float duration);
/**
* @js NA
* @lua NA
*/
virtual ~AccelAmplitude(void);
/** 使用 具有振幅属性的内部 action 、duration 初始化一个 action */
bool initWithAction(Action *pAction, float duration);
/** get 振幅速率 */
inline float getRate(void) const { return _rate; }
/** set 振幅速率 */
inline void setRate(float fRate) { _rate = fRate; }
// Overrides
virtual void startWithTarget(Node *target) override;
virtual void update(float time) override;
virtual AccelAmplitude* clone() const override;
virtual AccelAmplitude* reverse() const override;
protected:
float _rate;
ActionInterval *_other;
};
/** @brief DeccelAmplitude action */
class CC_DLL DeccelAmplitude : public ActionInterval
{
public:
/** 使用 具有振幅属性的内部 action 、duration 创建一个 action */
static DeccelAmplitude* create(Action *pAction, float duration);
/**
* @js NA
* @lua NA
*/
virtual ~DeccelAmplitude();
/** 使用 具有振幅属性的内部 action 、duration 初始化一个 action */
bool initWithAction(Action *pAction, float duration);
/** get 振幅速率 */
inline float getRate(void) const { return _rate; }
/** set 振幅速率 */
inline void setRate(float fRate) { _rate = fRate; }
// overrides
virtual void startWithTarget(Node *target) override;
virtual void update(float time) override;
virtual DeccelAmplitude* clone() const;
virtual DeccelAmplitude* reverse() const;
protected:
float _rate;
ActionInterval *_other;
};
/** @brief StopGrid action.
@warning 如果另一个 grid action 激活了,就不要再调用这个方法了
如果你要移除 grid 效果可以调用他. Example:
Sequence::actions(Lens::action(...), StopGrid::action(...), NULL);
*/
class CC_DLL StopGrid : public ActionInstant
{
public:
/** Allocates and initializes the action */
static StopGrid* create(void);
// Overrides
virtual void startWithTarget(Node *target) override;
virtual StopGrid* clone() const override;
virtual StopGrid* reverse() const override;
};
/** @brief ReuseGrid action */
class CC_DLL ReuseGrid : public ActionInstant
{
public:
/** 使用 当前 grid(网格)被重用的次数 创建一个 action */
static ReuseGrid* create(int times);
/** 使用 当前 grid(网格)被重用的次数 初始化
一个 action */
bool initWithTimes(int times);
// Override
virtual void startWithTarget(Node *target) override;
virtual ReuseGrid* clone() const override;
virtual ReuseGrid* reverse() const override;
protected:
int _times;
};
// end of actions group
/// @}
NS_CC_END
#endif // __ACTION_CCGRID_ACTION_H__