一、Action

  2. class CC_DLL Action : public Ref, public Clonable
  3. {
  4. public:
  5.     static const int INVALID_TAG = -1;            // 默认tag
  6.     virtual std::string description() const;    // 一般用于日志
  8.     virtual Action* cl3
  9.     virtual Action* reverse() const;            // 生成一个翻转action
  11.     virtual bool isDone() const;                // 知否执行完成
  13.     // Called before the action start. It will also set the target. 
  14.     virtual void startWithTarget(Node *target);
  16.     // Called after the action has finished. It will set the 'target' to nil.
  17.     // IMPORTANT: You should never call "Action::stop()" manually. Instead, use: "target->stopAction(action);".
  18.     virtual void stop();
  20.     // Action的执行就在这里开始，dt表示距离上step的时间间隔。
  21.     // Called every frame
  22.     virtual void step(float dt);
  24.     // 每个Action的实际执行逻辑，called once per frame，由step调用
  25.     // time:    动画执行进度
  26.     //     - 0 Means that the action just started.
  27.     //     - 0.5 Means that the action is in the middle.
  28.     //    - 1 Means that the action is over.
  29.     virtual void update(float time);
  31.     Node* getTarget() const;
  32.     // The action will modify the target properties. 
  33.     void setTarget(Node *target);
  35.     // original Target
  36.     Node* getOriginalTarget() const;
  37.     void setOriginalTarget(Node *originalTarget);
  39.     // identify action，注意这并不是唯一识别
  40.     int getTag() const;
  41.     void setTag(int tag);
  43.     // flag field that is used to group the actions easily.
  44.     unsigned int getFlags() const;
  45.     void setFlags(unsigned int flags) { _flags = flags; }
  47.     ......
  48. };

二、ActionManager

  2. class CC_DLL ActionManager : public Ref
  3. {
  4. public:
  6.     // hash表存储action，桶bucket number与target一一对应，一个target一个桶
  7.     // 插入对应桶中，桶不存在就创建
  8.     // paused为false，action不会执行
  9.     virtual void addAction(Action *action, Node *target, bool paused);
  11.     // 清空hash表，如果是正在执行的target、action，则在执行完之后删除
  12.     virtual void removeAllActions();
  14.     // 清除target对应桶中的action，如果是正在执行的target、action，则在执行完之后删除
  15.     virtual void removeAllActionsFromTarget(Node *target);
  17.     // 删除指定action，如果是正在执行的target、action，则在执行完之后删除
  18.     virtual void removeAction(Action *action);
  20.     // tag:    The action's tag.
  21.     // 只会删除找到的第一个action
  22.     virtual void removeActionByTag(int tag, Node *target);    
  23.     virtual void removeAllActionsByTag(int tag, Node *target);
  25.     // Removes all actions matching at least one bit in flags and the target.
  26.     virtual void removeActionsByFlags(unsigned int flags, Node *target);
  28.     // 返回符合条件的第一个action
  29.     virtual Action* getActionByTag(int tag, const Node *target) const;
  31.     // 返回target桶中的action数量
  32.     // Composable actions are counted as 1 action. Example:
  33.     // - If you are running 1 Sequence of 7 actions, it will return 1.
  34.     // - If you are running 7 Sequences of 2 actions, it will return 7.
  35.     virtual ssize_t getNumberOfRunningActionsInTarget(const Node *target) const;
  37.     // 返回所有target桶中的action数量之和
  38.     virtual ssize_t getNumberOfRunningActions() const;
  40.     // 返回target桶中指定tag的action数量
  41.     virtual size_t getNumberOfRunningActionsInTargetByTag(const Node *target, int tag);
  43.     // target桶中的所有action都会停止执行
  44.     virtual void pauseTarget(Node *target);
  46.     // 暂停所有action，并返回从!paused变paused的action
  47.     virtual Vector<Node*> pauseAllRunningActions();
  49.     virtual void resumeTarget(Node *target);    // 恢复执行
  50.     virtual void resumeTargets(const Vector<Node*>& targetsToResume);
  52.     virtual void update(float dt);                // 在这里执行所有动画
  54.     ......
  55. };

三、Node

  2. class CC_DLL Node : public Ref {
  4.     // 更换actionManager，默认是default action manager
  5.     // 注意如果是new的，则之前的action全部被remove掉
  6.     virtual void setActionManager(ActionManager* actionManager);
  7.     virtual ActionManager* getActionManager();
  9.     // 由当前的actionmanager执行。
  10.     // Executes an action, and returns the action that is executed.
  11.     // This node becomes the action's target. Refer to Action::getTarget().
  12.     virtual Action* runAction(Action* action);
  14.     // actionManager->removeAllActionsFromTarget();
  15.     // stop and remove 当前节点作为target的所有action
  16.     void stopAllActions();
  18.     // stop and remove action
  19.     // 先通过action->getOrignalTarget找到桶，再从桶中找到action去删除。
  20.     // 注意，这里可以没有说action的target一定是当前node（this），而是通过getOrignalTarget获取
  21.     void stopAction(Action* action);
  23.     // 移除当前target桶中指定tag的action，只删除遇到的第一个。
  24.     void stopActionByTag(int tag);
  26.     // 同上，不同之处是删除所有指定tag的action
  27.     void stopAllActionsByTag(int tag);
  29.     // 删除满足以下条件的action
  30.     // (action->getFlag() &  flags) != 0 && action->getOrignalTarget() == this
  31.     void stopActionsByFlags(unsigned int flags);
  33.     // this桶中的指定tag的第一个action
  34.     Action* getActionByTag(int tag);
  36.     // Returns the numbers of actions that are running plus the ones
  37.     // that are schedule to run (actions in actionsToAdd and actions arrays).
  38.     // _actionManager->getNumberOfRunningActionsInTarget( this );
  39.     ssize_t getNumberOfRunningActions() const;
  41.     // actionManager->resumeTarget(this);
  42.     void resumeSchedulerAndActions();
  44.     // actionManager->pauseTarget(this);
  45.     void pauseSchedulerAndActions();
  47.     /**
  48.      * Returns the numbers of actions that are running plus the ones that are
  49.      * schedule to run (actions in actionsToAdd and actions arrays) with a
  50.      * specific tag.
  51.      *
  52.      * Composable actions are counted as 1 action. Example:
  53.      *    If you are running 1 Sequence of 7 actions, it will return 1.
  54.      *    If you are running 7 Sequences of 2 actions, it will return 7.
  55.      *
  56.      * @param  tag The tag that will be searched.
  57.      *
  58.      * @return The number of actions that are running plus the
  59.      *         ones that are schedule to run with specific tag.
  60.      */
  61.     ssize_t getNumberOfRunningActionsByTag(int tag) const;
  63. }