CCAction Class 和 CCActionInterval Class 和 CCActionMoveTo Class ---Cocos2D-Swift v3.3
CCAction Class Reference
| Inherits from | NSObject |
| Conforms to | NSCopying |
| Declared in | CCAction.h |
Overview
CCAction is an abstract base class for all actions. Actions animate nodes by manipulating node properties over time such as position, rotation, scale and opacity.
CCaction是一个关于所有动作的基本类型。通过操纵node属性，比如位置，旋转，透明度，规模等，激活Nodes。
For more information see the Concepts:Actions article in the Developer Guide
Subclasses
The following actions inherit directly from CCAction and can be used “as is”:
- CCActionFollow (parent node follows the target node’s movement)
- CCActionRepeatForever (runs a CCActionInterval in an endless loop until stopped)
- CCActionSpeed (modifies the speed of a CCActionInterval action while it is running)
These action subclasses are abstract base classes for instant and “over time” actions, see their references for more information:
Tasks
Creating an Action
Action Targets
targetpropertyoriginalTargetproperty
Identifying an Action
tagproperty
Action Methods Implemented by Subclasses
Properties
originalTarget
@property (nonatomic, readonly, unsafe_unretained) id originalTargetDeclared In
CCAction.htarget
The “target” is typically the node instance that received the [CCNode runAction:] message. The action will modify the target properties. The target will be set with the ‘startWithTarget’ method. When the ‘stop’ method is called, target will be set to nil.
"target”是典型的node实例，可以接收[CCNode runAction:] 方法。acition会定义target属性。target可以通过startWithTarget方法设置，当stop方法被调用时，target会被置为nil。
@property (nonatomic, readonly, unsafe_unretained) id targetDiscussion
Warning: The target is ‘assigned’ (unsafe unretained), it is not ‘retained’ nor managed by ARC.
Declared In
CCAction.hInstance Methods
init
Initializes and returns an action object.
初始化和返回一个action对象。
- (id)initReturn Value
An initialized CCAction Object.
Declared In
CCAction.hisDone
Return YES if the action has finished.
- (BOOL)isDoneReturn Value
Action completion status
动作完成状态。
Declared In
CCAction.hstartWithTarget:
Assigns a target to the action Called before the action is started.
分配一个target给action。这回在action开始之前被调用。
- (void)startWithTarget:(id)targetParameters
- target
-
Target to assign to action (weak reference).
Declared In
CCAction.hstep:
Steps the action. Called for every frame with step interval.
action的步骤。每一帧被调用，步骤间隔。
- (void)step:(CCTime)dtParameters
- dt
-
Ellapsed interval since last step.
Discussion
Note: Do not override unless you know what you are doing.
Declared In
CCAction.hstop
Stops the action Called after the action has finished. Will assign the internal target reference to nil. Note: You should never call this method directly. In stead use: [target stopAction:action]
停止一个action，action结束后被调用。会让内部的target置为nil。
你永远不应该直接调用这个方法。用[target stopAction:action]代替。
- (void)stopDeclared In
CCAction.hupdate:
Updates the action with normalized value.
用规范化的值更新动作。
- (void)update:(CCTime)timeParameters
- time
-
Normalized action progress.
Discussion
For example: A value of 0.5 indicates that the action is 50% complete.
Declared In
CCAction.hCCActionInterval Class Reference
| Inherits from | CCActionFiniteTime : CCAction : NSObject |
| Conforms to | NSCopying |
| Declared in | CCActionInterval.h |
Overview
Abstract base class for interval actions. An interval action is an action that performs its task over a certain period of time.
关于间隔动作的抽象基本类。一个间隔动作是指一个动作在一段时间内完成整个过程。
Most CCActionInterval actions can be reversed or have their speed altered via the CCActionSpeed action.
大部分的CCActionInterval动作可以被逆转或者改变速率，通过CCActionSpeed动作。
Moving, Rotating, Scaling a Node
- Moving a node along a straight line or curve:
- Rotating a node:
- Scaling a node:
Animating a Node’s Visual Properties
- Periodically toggle visible property on/off:
- Fading a node in/out/to:
- Colorizing a node:
- Skewing a node:
- Animate the sprite frames of a CCSprite with CCAnimation:
- Animating a CCProgressNode:
Repeating and Reversing Actions
- Repeating an action a specific number of times:
- Reversing an action (if supported by the action):
Creating Sequences of Actions
- Creating a linear sequence of actions:
- CCActionSequence
- Wait for a given time in a CCActionSequence:
- Spawning parallel running actions in a CCActionSequence and continue the sequence when all spawned actions have ended:
Easing the Duration of an Action
- Easing duration of a CCActionInterval:
- CCActionEase
- CCActionEaseBackIn, CCActionEaseBackInOut, CCActionEaseBackOut
- CCActionEaseBounce, CCActionEaseBounceIn, CCActionEaseBounceInOut, CCActionEaseBounceOut
- CCActionEaseElastic, CCActionEaseElasticIn, CCActionEaseElasticInOut, CCActionEaseElasticOut
- CCActionEaseRate, CCActionEaseIn, CCActionEaseInOut, CCActionEaseOut
- CCActionEaseSineIn, CCActionEaseSineInOut, CCActionEaseSineOut
Animating custom float/double Properties
- Tweening any node property (of type float or double):
Tasks
Other Methods
elapsedproperty
Creating a Interval Action
Reversing an Action
Methods implemented by Subclasses
Instance Methods
initWithDuration:
Initializes and returns an action interval object.
- (id)initWithDuration:(CCTime)dParameters
- d
-
Action interval.
Return Value
An initialized CCActionInterval Object.
Declared In
CCActionInterval.hisDone
Returns YES if the action has finished.
- (BOOL)isDoneReturn Value
Action finished status.
Declared In
CCActionInterval.hreverse
Returns a reversed action.
- (CCActionInterval *)reverseReturn Value
Created reversed action.
Declared In
CCActionInterval.hCCActionMoveTo Class Reference
| Inherits from | CCActionMoveBy : CCActionInterval : CCActionFiniteTime : CCAction : NSObject |
| Declared in | CCActionInterval.h |
Overview
This action moves the target to the position specified, these are absolute coordinates. Several CCMoveTo actions can be concurrently called, and the resulting movement will be the sum of individual movements.
Warning: Move actions shouldn’t be used to move nodes with a dynamic CCPhysicsBody as both the physics body and the action will alter the node’s position property, overriding each other’s changes. This leads to unpredictable behavior.
