Hexococos2dx 3.0 ---- Action 2014-12-17

class CC_DLL Action : public Ref, public Clonable
{
public:
    static const int INVALID_TAG = -1;
    virtual std::string description() const;

    /* 返回拷贝动作 */
    virtual Action* clone() const = 0;

    /* 返回逆动作 */
    virtual Action* reverse() const = 0;

    /* 动作是否结束 */
    virtual bool isDone() const;

    /* 在动作开始前调用 */
    /* 初始化 */
    virtual void startWithTarget(Node *target);

    /* 不要自己调用stop */
    /* 把这破事交给ActionManger吧 */
    virtual void stop();

    /* 在ActionManager的update中每一帧调用 */
    /* PS ：原文注释中提示，如果你不知道自己在做什么，就不要重写step */
    virtual void step(float dt);

    /* 每一帧调用的函数 */
    /* time的值是从 0 到 1 */
    /* 0   表示开始 */
    /* 0.5 表示执行一半 */
    /* 1   表示结束 */
    virtual void update(float time);

    inline Node* getTarget() const { return _target; }
    inline void setTarget(Node *target) { _target = target; }

    inline Node* getOriginalTarget() const { return _originalTarget; }
    /* 弱引用 ？ */
    inline void setOriginalTarget(Node *originalTarget) { _originalTarget = originalTarget; }

    inline int getTag() const { return _tag; }
    inline void setTag(int tag) { _tag = tag; }

protected:
    Action();
    virtual ~Action();

    Node    *_originalTarget;
    /* 用startWithTarget设置 */
    /* 当调用stop的时候置为null */
    Node    *_target;

    /* 标识 */
    int     _tag;

private:
    /* 禁用拷贝构造函数, 禁止重载等号运算符 */
    CC_DISALLOW_COPY_AND_ASSIGN(Action);
};

class CC_DLL FiniteTimeAction : public Action
{
public:
    inline float getDuration() const { return _duration; }
    inline void setDuration(float duration) { _duration = duration; }

    virtual FiniteTimeAction* reverse() const override = 0;
    virtual FiniteTimeAction* clone() const override = 0;

protected:
    FiniteTimeAction() : _duration(0) {}
    virtual ~FiniteTimeAction(){}

    /* 时长 */
    float _duration;

private:
    CC_DISALLOW_COPY_AND_ASSIGN(FiniteTimeAction);
};

class CC_DLL Speed : public Action
{
    /* 此处略去 */

protected:
    /* 在step中起关键作用 */
    float _speed;

    /* 保存目标动作 */
    /* 强引用 */
    ActionInterval *_innerAction;

private:
    CC_DISALLOW_COPY_AND_ASSIGN(Speed);
};

void Speed::step(float dt) 
{
    _innerAction->step(dt * _speed);
}

class CC_DLL Follow : public Action
{
public:
    static Follow* create(Node *followedNode, const Rect& rect = Rect::ZERO);

    inline bool isBoundarySet() const { return _boundarySet; }
    /* 开启关闭边界 */
    inline void setBoudarySet(bool value) { _boundarySet = value; }

    virtual Follow* clone() const override;
    virtual Follow* reverse() const override;
    virtual void step(float dt) override;
    virtual bool isDone() const override;
    virtual void stop() override;

CC_CONSTRUCTOR_ACCESS:
    /* 略去初始化函数，以及初始化列表 */

    virtual ~Follow();

    /* 跟随节点的引用计数会增加 */
    bool initWithTarget(Node *followedNode, const Rect& rect = Rect::ZERO);

protected:
    /* 跟随节点 */
    Node *_followedNode;

    /* 是否开启边界 */
    bool _boundarySet;

    /* 若边界大于整个屏幕，则不需要跟随动作了 */
    bool _boundaryFullyCovered;

    /* 快速访问屏幕尺寸 */
    Point _halfScreenSize;
    Point _fullScreenSize;

    /* 边界 */
    float _leftBoundary;
    float _rightBoundary;
    float _topBoundary;
    float _bottomBoundary;
    Rect _worldRect;

private:
    CC_DISALLOW_COPY_AND_ASSIGN(Follow);
};