cocos2d-x  3.0-rc0
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
ActionManager Class Reference

ActionManager is a singleton that manages all the actions. More...

#include <CCActionManager.h>

Inheritance diagram for ActionManager:
Ref

Public Member Functions

 ActionManager (void)
 ~ActionManager (void)
void addAction (Action *action, Node *target, bool paused)
 Adds an action with a target. More...
 
void removeAllActions ()
 Removes all actions from all the targets. More...
 
void removeAllActionsFromTarget (Node *target)
 Removes all actions from a certain target. More...
 
void removeAction (Action *action)
 Removes an action given an action reference. More...
 
void removeActionByTag (int tag, Node *target)
 Removes an action given its tag and the target. More...
 
var removeActionByTag ( var tag, var target)
 Removes an action given its tag and the target. More...
 
local removeActionByTag ( local tag, local target)
 Removes an action given its tag and the target. More...
 
ActiongetActionByTag (int tag, const Node *target) const
 Gets an action given its tag an a target. More...
 
ssize_t getNumberOfRunningActionsInTarget (const Node *target) const
 Returns the numbers of actions that are running in a certain target. More...
 
CC_DEPRECATED_ATTRIBUTE ssize_t numberOfRunningActionsInTarget (Node *target) const
local numberOfRunningActionsInTarget ( local target)
void pauseTarget (Node *target)
 Pauses the target: all running actions and newly added actions will be paused. More...
 
void resumeTarget (Node *target)
 Resumes the target. More...
 
Vector< Node * > pauseAllRunningActions ()
 Pauses all running actions, returning a list of targets whose actions were paused. More...
 
void resumeTargets (const Vector< Node * > &targetsToResume)
 Resume a set of targets (convenience function to reverse a pauseAllRunningActions call) More...
 
void update (float dt)
- Public Member Functions inherited from Ref
void retain ()
 Retains the ownership. More...
 
void release ()
 Release the ownership immediately. More...
 
Refautorelease ()
 Release the ownership sometime soon automatically. More...
 
unsigned int getReferenceCount () const
 Returns the Ref's current reference count. More...
 
virtual ~Ref ()

Protected Member Functions

void removeActionAtIndex (ssize_t index, struct _hashElement *element)
var removeActionAtIndex ( var index, var element)
local removeActionAtIndex ( local index, local element)
void deleteHashElement (struct _hashElement *element)
void actionAllocWithHashElement (struct _hashElement *element)
- Protected Member Functions inherited from Ref
 Ref ()
 Constructor. More...
 

Protected Attributes

struct _hashElement * _targets
struct _hashElement * _currentTarget
var _currentTarget
local _currentTarget
bool _currentTargetSalvaged
var _currentTargetSalvaged
local _currentTargetSalvaged
- Protected Attributes inherited from Ref
unsigned int _referenceCount
 count of references More...
 

Detailed Description

ActionManager is a singleton that manages all the actions.

Normally you won't need to use this singleton directly. 99% of the cases you will use the Node interface, which uses this singleton. But there are some cases where you might need to use this singleton. Examples:

  • When you want to run an action where the target is different from a Node.
  • When you want to pause / resume the actions
Since
v0.8

Constructor & Destructor Documentation

ActionManager ( void  )
var ctor (   )
local ActionManager (   )
~ActionManager ( void  )

Member Function Documentation

void actionAllocWithHashElement ( struct _hashElement *  element)
protected
var actionAllocWithHashElement ( var  element)
protected
local actionAllocWithHashElement ( local  element)
protected
void addAction ( Action action,
Node target,
bool  paused 
)

Adds an action with a target.

If the target is already present, then the action will be added to the existing target. If the target is not present, a new instance of this target will be created either paused or not, and the action will be added to the newly created target. When the target is paused, the queued actions won't be 'ticked'.

var addAction ( var  action,
var  target,
var  paused 
)

Adds an action with a target.

If the target is already present, then the action will be added to the existing target. If the target is not present, a new instance of this target will be created either paused or not, and the action will be added to the newly created target. When the target is paused, the queued actions won't be 'ticked'.

local addAction ( local  action,
local  target,
local  paused 
)

Adds an action with a target.

If the target is already present, then the action will be added to the existing target. If the target is not present, a new instance of this target will be created either paused or not, and the action will be added to the newly created target. When the target is paused, the queued actions won't be 'ticked'.

void deleteHashElement ( struct _hashElement *  element)
protected
var deleteHashElement ( var  element)
protected
local deleteHashElement ( local  element)
protected
Action* getActionByTag ( int  tag,
const Node target 
) const

Gets an action given its tag an a target.

Returns
the Action the with the given tag
var getActionByTag ( var  tag,
var  target 
)

Gets an action given its tag an a target.

Returns
the Action the with the given tag
local getActionByTag ( local  tag,
local  target 
)

Gets an action given its tag an a target.

Returns
the Action the with the given tag
ssize_t
getNumberOfRunningActionsInTarget
( const Node target) const

Returns the numbers of actions that are running in a certain target.

Composable actions are counted as 1 action. Example:

  • If you are running 1 Sequence of 7 actions, it will return 1.
  • If you are running 7 Sequences of 2 actions, it will return 7.
var
getNumberOfRunningActionsInTarget
( var  target)

Returns the numbers of actions that are running in a certain target.

Composable actions are counted as 1 action. Example:

  • If you are running 1 Sequence of 7 actions, it will return 1.
  • If you are running 7 Sequences of 2 actions, it will return 7.
local
getNumberOfRunningActionsInTarget
( local  target)

Returns the numbers of actions that are running in a certain target.

Composable actions are counted as 1 action. Example:

  • If you are running 1 Sequence of 7 actions, it will return 1.
  • If you are running 7 Sequences of 2 actions, it will return 7.
CC_DEPRECATED_ATTRIBUTE
ssize_t
numberOfRunningActionsInTarget
( Node target) const
inline
var numberOfRunningActionsInTarget ( var  target)
inline
local
numberOfRunningActionsInTarget
( local  target)
inline
Vector<Node*>
pauseAllRunningActions
( )

Pauses all running actions, returning a list of targets whose actions were paused.

var pauseAllRunningActions ( )

Pauses all running actions, returning a list of targets whose actions were paused.

local pauseAllRunningActions ( )

Pauses all running actions, returning a list of targets whose actions were paused.

void pauseTarget ( Node target)

Pauses the target: all running actions and newly added actions will be paused.

var pauseTarget ( var  target)

Pauses the target: all running actions and newly added actions will be paused.

local pauseTarget ( local  target)

Pauses the target: all running actions and newly added actions will be paused.

void removeAction ( Action action)

Removes an action given an action reference.

var removeAction ( var  action)

Removes an action given an action reference.

local removeAction ( local  action)

Removes an action given an action reference.

void removeActionAtIndex ( ssize_t  index,
struct _hashElement *  element 
)
protected
var removeActionAtIndex ( var  index,
var  element 
)
protected
local removeActionAtIndex ( local  index,
local  element 
)
protected
void removeActionByTag ( int  tag,
Node target 
)

Removes an action given its tag and the target.

var removeActionByTag ( var  tag,
var  target 
)

Removes an action given its tag and the target.

local removeActionByTag ( local  tag,
local  target 
)

Removes an action given its tag and the target.

void removeAllActions ( )

Removes all actions from all the targets.

var removeAllActions ( )

Removes all actions from all the targets.

local removeAllActions ( )

Removes all actions from all the targets.

void removeAllActionsFromTarget ( Node target)

Removes all actions from a certain target.

All the actions that belongs to the target will be removed.

var removeAllActionsFromTarget ( var  target)

Removes all actions from a certain target.

All the actions that belongs to the target will be removed.

local removeAllActionsFromTarget ( local  target)

Removes all actions from a certain target.

All the actions that belongs to the target will be removed.

void resumeTarget ( Node target)

Resumes the target.

All queued actions will be resumed.

var resumeTarget ( var  target)

Resumes the target.

All queued actions will be resumed.

local resumeTarget ( local  target)

Resumes the target.

All queued actions will be resumed.

void resumeTargets ( const Vector< Node * > &  targetsToResume)

Resume a set of targets (convenience function to reverse a pauseAllRunningActions call)

var resumeTargets ( var  targetsToResume)

Resume a set of targets (convenience function to reverse a pauseAllRunningActions call)

local resumeTargets ( local  targetsToResume)

Resume a set of targets (convenience function to reverse a pauseAllRunningActions call)

void update ( float  dt)
var update ( var  dt)
local update ( local  dt)

Member Data Documentation

struct _hashElement* _currentTarget
protected
var _currentTarget
protected
local _currentTarget
protected
bool _currentTargetSalvaged
protected
var _currentTargetSalvaged
protected
local _currentTargetSalvaged
protected
struct _hashElement* _targets
protected

The documentation for this class was generated from the following file: