iOS_31_cocos2d_CCNode
<喎?/kf/ware/vc/" target="_blank" class="keylink">vcD4KPHA+Q0NOb2Rl1eK49sDgILzMs9DX1CBDQ1Jlc3BvbmRlciCyotfxytjQrdLpPApDQ1NjaGVkdWxlclRhcmdldCA+PC9wPgo8cD48L3A+CjxwIGNsYXNzPQ=="p1">而CCResponder : NSObject
因此,CCNode是所有cocos2d裡所有類的基類(除了CCResponder)，
比如常用的CCScene（場景）、CCLayer（圖層）、CCSprite（精靈）等，
它是一個不能夠可視化的抽象類，它只是用來定義所有節點的公共屬性和方法的。
首先來看看CCNode的繼承結構圖，只列舉了常用的類
@interface CCNode : CCResponder < CCSchedulerTarget > {
// 旋轉角度
float _rotationalSkewX, _rotationalSkewY;
// 比例因子
float _scaleX, _scaleY;
// OpenGL 實際的 Z vertex.
float _vertexZ;
// node的位置
CGPoint _position;
// Skew 扭曲、傾斜的角度.
float _skewX, _skewY;
// 錨點.（in Points）
CGPoint _anchorPointInPoints;
// 錨點 normalized (not in points).
CGPoint _anchorPoint;
// node 正常狀態下的尺寸.
CGSize _contentSize;
// 形變.
CGAffineTransform _transform, _inverse;
BOOL _isTransformDirty;
BOOL _isInverseDirty;
// Z-order value.
NSInteger _zOrder;
// 數組
NSMutableArray *_children;
// 其父類的 弱引用
__weak CCNode *_parent;
// 名字 作為tag使用,區別於其他的node
NSString* _name;
// 用戶數據域 特殊情況下用到
id _userObject;
// Used to preserve sequence while sorting children with the same zOrder.
NSUInteger _orderOfArrival;
// 是否可見
BOOL _visible;
// True to ensure reorder.
BOOL _isReorderChildDirty;
// DisplayColor and Color are kept separate to allow for cascading color and alpha changes through node children.
// Alphas tend to be multiplied together so you can fade groups of objects that are colored differently.
ccColor4F _displayColor, _color;
// Opacity/Color propagates into children that conform to if cascadeOpacity/cascadeColor is enabled.
BOOL _cascadeColorEnabled, _cascadeOpacityEnabled;
CCNode常用方法
1.創建一個新的節點
CCNode *node = [CCNode node];
2.添加子節點
// 先創建子節點 CCNode *childNode = [CCNode node]; // 方法1：直接添加 [node addChild:childNode]; // 方法2：z決定了節點的繪制順序，按照z值從小到大的順序來繪制節點，即先繪制z值小的節點，再繪制z值大的節點 // 如果多個節點擁有相同的z值，就按照添加它們的先後順序進行繪制 [node addChild:childNode z:0]; // 方法3:字符串name,作用相當於tag,給節點設置一個標記，父節點可以根據設置的name標記找到對應的子節點 [node addChild:childNode z:0 name:@"nana"];
// 如果多個節點擁有相同的name值，如果YES,則按深度優先,遞歸其子孫Node,返回最先匹配name值的節點;否則 只查找直接子Node [node getChildByName:@"nana" recursively:YES];
// 方法1：將子節點childNode從父節點node中移除 // "cleanup"設置為YES代表停止子節點運行的所有動作(actions)和消息調度(callbacks) [node removeChild:childNode cleanup:YES]; // 方法2：根據tag值將對應的子節點從父節點node中移除 [node removeChildByName:@"nana" cleanup:YES]; // 方法3：移除node中的所有子節點 [node removeAllChildrenWithCleanup:YES]; // 方法4：將childNode從它的父節點中移除 [childNode removeFromParentAndCleanup:YES];
5.停止節點運行的所有動作和消息調度
[node stopAllActions];
常用屬性和方法
1.添加節點時設置的z值，決定了節點的繪制順序
@property(nonatomic,readonly) NSInteger zOrder;
@property(nonatomic,readwrite,assign) float rotation;
繞著anchorPoint進行旋轉
@property(nonatomic,readwrite,assign) float scale;
繞著anchorPoint進行縮放
@property(nonatomic,readwrite,assign) float scaleX;
5.節點Y方向(即高度)的縮放比例。
@property(nonatomic,readwrite,assign) float scaleY;
6.節點的大小(不管scale和rotation如何,對於Node而言,contentSize始終保持一樣)
@property (nonatomic,readwrite) CGSize contentSize
7.節點在父節點中的位置(cocos2d用的是數學中笛卡爾坐標系,以父節點左下角為(0, 0))
@property(nonatomic,readwrite,assign) CGPoint position;
cocos2d的坐標系：(0,0)在屏幕的左下角，x值向右正向延伸，y值向上正向延伸.
這個position是指Node的AnchorPoint在其父Node中的位置
8.anchorPoint錨點，它可以直接影響節點position、節點繞著哪個點進行縮放或旋轉，
anchorPoint的x、y取值范圍都是0到1
@property(nonatomic,readwrite) CGPoint anchorPoint;
默認情況下，CCSprite、CClayer、CCScene的anchorPoint都為(0.5, 0.5)，即默認情況下它們的定位點都是自己的中心點。
1> anchorPoint對position的影響
anchorPoint要對position造成影響
* 如果anchorPoint = (0, 0)，那麼節點的左下角就會在position屬性指定的位置上
* 如果anchorPoint = (0.5, 0.5)，那麼節點的中心點就會在position屬性指定的位置上
* 如果anchorPoint = (1, 1)，那麼節點的右上角就會在position屬性指定的位置上
下面畫圖解釋一下
// 紅色方塊 是 藍色方塊 的子節點，根據cocos2d坐標系為數學裡笛卡爾坐標系:
/ / 藍色的左下角位置為坐標原點(0, 0)。假設藍色的大小是100x100，紅色的大小是50x50
/ / red.position = CGPointMake(50, 50);
/ / 結果顯示：紅色方塊 是在 藍色方塊的正中心
特殊情況下的錨點 及其 位置，列舉如下
2> anchorPoint對縮放的影響
* 如果anchorPoint = (0, 0)，那麼節點就會繞著自己的左下角進行縮放
* 如果anchorPoint = (0.5, 0.5)，那麼節點就會繞著自己的中點進行縮放
* 如果anchorPoint = (1, 1)，那麼節點就會繞著自己的右上角進行縮放
node.scale = 0.5f; // 寬高變為原來的1/2藍色代表縮放前，紅色代表縮放後
3> anchorPoint對旋轉的影響
* 如果anchorPoint = (0, 0)，那麼節點就會繞著自己的左下角進行旋轉
* 如果anchorPoint = (0.5, 0.5)，那麼節點就會繞著自己的中點進行旋轉
* 如果anchorPoint = (1, 1)，那麼節點就會繞著自己的右上角進行旋轉
下面畫圖解釋一下
node.rotation = 45; // 順時針旋轉45°
藍色代表旋轉前，紅色代表旋轉後
9.父節點
@property(nonatomic,readwrite,assign) CCNode* parent;
@property(nonatomic,readonly) NSArray *children;
12.是否可見(默認YES)
@property(nonatomic,readwrite,assign) BOOL visible;
13.添加節點時設置的標記
@property(nonatomic,readwrite,copy) NSString *name;
- (CGRect) boundingBox;
動作的處理
動作是指在特定時間內完成移動、縮放、旋轉等操作的行為。CCNode可以運行動作實現一些動畫效果。
1.運行動作
-(CCAction*) runAction: (CCAction*) action;
// 初始化一個平移動作，這是向左邊移動100的距離 CCAction *action = [CCMoveBy actionWithDuration:2 position:CGPointMake(-100, 0)]; // 可以給動作設置一個標記 action.tag = 100; // 運行動作 [node runAction:action];
當動作執行完畢後，會自動從節點上刪除
2.停止動作
停止節點上的所有動作
-(void) stopAllActions;停止某個特定的動作
-(void) stopAction: (CCAction*) action;根據tag停止對應的動作
-(void) stopActionByTag:(NSInteger) tag;
3.根據tag獲取對應的動作
-(CCAction*) getActionByTag:(NSInteger) tag;
4.節點上當前包含的動作總數
-(NSUInteger) numberOfRunningActions;
消息調度
CCNode可以進行消息調度，也就是指系統會每隔一段時間調用一次節點的某個方法。CCNode的消息調度是很常用的，比如一個子彈射出去了，需要隔一段時間就調用子彈的某個方法來改變的子彈的位置
為了說明消息調度的用法，定義一個子彈類，因為子彈是看得見的，所以應該繼承CCSprite，而不是繼承CCNode
// Bullet.h #import "CCSprite.h" @interface Bullet : CCSprite @end
1.最簡單的做法是直接調用節點的schedule:interval:方法，就可以開始消息調度
#import "Bullet.h"
@implementation Bullet
- (id)init {
if (self = [super init]) {
// 在節點初始化的時候開始消息調度
[self schedule:@selector(update:) interval:0.0f];
}
return self;
}
- (void)update:(CCTime)delta {
// 在這裡改變子彈的位置
// ....
}
@end
當調用了[self schedule:@selector(update:) interval:0];
系統會以每幀的頻率調用一次update:方法(方法名和參數都是固定的)，意思是每次刷幀都會調用一次。
參數delta代表上次調用方法到現在所經過的時間,即兩次調用的時間差
- (id)init {
if (self = [super init]) {
// 開始消息調度
[self schedule:@selector(changePosition:) interval:0.2f]; // 每隔0.2秒就調用changePosition:方法
}
return self;
}
- (void)changePosition:(CCTime)delta {
// do something here
}
4.取消消息調度
-(void) unschedule: (SEL) s;取消調用所有的方法(包括update:)
-(void) unscheduleAllSelectors;
CCNode 類引用
繼承自
CCResponder : NSObject
遵守協議
CCSchedulerTarget
類聲明
CCNode.h
Overview
CCNode is the base class for all objects displayed by Cocos2d. The nodes are hierachically organized in a tree, normally with a CCScene as its root node. Example of CCNode:s are CCSprite, CCScene and CCButton. The CCNode handles transformations, can have a content size and provides a coordinate system to its children. Any CCNode or subclass can handle user interaction, such as touches and mouse events, see the CCResponder for more information on this.
Coordinate System and Positioning
Coordinates in the CCNode coordinate system are by default set in points by the position property. The point measurement provides a way to handle different screen densities. For instance, on a retina display one point corresponds to two pixels, but on non-retina devices one point corresponds directly to one pixel.
By using the positionType property you can specify how a node’s position is interpreted. For instance, if you set the type to CCPositionTypeNormalized a position value of (0.5, 0.5) will place the node in the center of its parent’s container. The container is specified by the parent’s contentSize. It’s also possible to set positions relative to the different corners of the parent’s container. The CCPositionType has three components, xUnit, yUnit and corner. The corner can be any reference corner of the parent’s container and the xUnit and yUnit can be any of the following:
- CCPositionUnitPoints - This is the default, the position value will be in points.
- CCPositionUnitScaled - The position is scaled by the UIScaleFactor as defined by CCDirector. This is very useful for scaling up game play without changing the game logic. E.g. if you want to support both phones and tablets in native resolutions.
- CCPositionUnitNormalized - Using the normalized type allows you to
position object in relative to the parents container. E.g. it can be used to center nodes on the screen regardless of the device type your game is running on.
Similarily to how you set a node’s position and positionType you can also set it’s contentSize and contentSizeType. However, some classes doesn’t allow you to set these directly. For instance, the CCSprite sets its contentSize depending on the size of its texture and for descendants of CCControl you should set the preferredSize and preferredSizeType rather than changing their contentSize directly. The CCSizeType has two components widthUnit and heightUnit which can be any of the following:
- CCSizeUnitPoints - This is the default, the size will be in points
- CCSizeUnitScaled - The size is scaled by the UIScaleFactor.
- CCSizeUnitNormalized - The content size will be set as a normalized value of the parent’s container.
- CCSizeUnitInset - The content size will be the size of it’s parent container, but inset by a number of points.
- CCSizeUnitInsetScaled - The content size will be the size of it’s
parent container, but inset by a number of points multiplied by the UIScaleFactor.
Even if the positions and content sizes are not set in points you can use actions to animate the nodes. See the examples and tests for more information on how to set positions and content sizes, or use SpriteBuilder to easily play around with the settings. There are also more positioning options available by using CCLayout and CCLayoutBox.
Subclassing Notes
A common user pattern in building a Cocos2d game is to subclass CCNode, add it to a CCScene and override the methods for handling user input.
Debugging extensions of CCNode. They are available when the DEBUG macro is defined at compile time.
Tasks
Creating Nodes
- + node
- – init
Pausing and Hiding
- paused property
- visible property
Tagging and Setting User Object
- name property
- userObject property
Position and Size
- position property
- positionInPoints property
- positionType property
- rotation property
- rotationalSkewX property
- rotationalSkewY property
- scale property
- scaleX property
- scaleY property
- scaleInPoints property
- scaleXInPoints property
- scaleYInPoints property
- scaleType property
- skewX property
- skewY property
- contentSize property
- contentSizeInPoints property
- contentSizeType property
- anchorPoint property
- anchorPointInPoints property
- – viewDidResizeTo:
- – boundingBox
Adding, Removing and Sorting Children
- – addChild:
- – addChild:z:
- – addChild:z:name:
- – removeFromParent
- – removeFromParentAndCleanup:
- – removeChild:
- – removeChild:cleanup:
- – removeChildByName:
- – removeChildByName:cleanup:
- – removeAllChildren
- – removeAllChildrenWithCleanup:
- parent property
- children property
- – getChildByName:recursively:
- zOrder property
Hit tests
- – hitTestWithWorldPos:
- hitAreaExpansion property
Scene Management
- – onEnter
- – onEnterTransitionDidFinish
- – onExit
- – onExitTransitionDidStart
- scene property
- runningInActiveScene property
Physics
- physicsBody property
Actions
- – runAction:
- – stopAllActions
- – stopAction:
- – stopActionByTag:
- – getActionByTag:
- – numberOfRunningActions
Scheduling Repeating Callbacks
- – scheduleBlock:delay:
- – schedule:interval:
- – schedule:interval:repeat:delay:
- – scheduleOnce:delay:
- – unschedule:
- – unscheduleAllSelectors
- animationManager property
Accessing Transformations and Matrices
- – transform:
- – nodeToParentTransform
- – parentToNodeTransform
- – nodeToWorldTransform
- – worldToNodeTransform
- – convertToNodeSpace:
- – convertToWorldSpace:
- – convertToNodeSpaceAR:
- – convertToWorldSpaceAR:
Rendering (Used by Subclasses)
- – draw:transform:
- – visit
- – visit:parentTransform:
- color property
- colorRGBA property
- displayedColor property
- cascadeColorEnabled property
- – updateDisplayedColor:
- opacity property
- displayedOpacity property
- cascadeOpacityEnabled property
- – updateDisplayedOpacity:
- – setOpacityModifyRGB:
- – doesOpacityModifyRGB
Debug Methods
- – walkSceneGraph:
CCPhysics Methods
- – physicsNode
Properties
anchorPoint
The anchorPoint is the point around which all transformations and positioning manipulations take place. It’s like a pin in the node where it is “attached” to its parent. The anchorPoint is normalized, like a percentage. (0,0) means the bottom-left corner and (1,1) means the top-right corner. But you can use values higher than (1,1) and lower than (0,0) too. The default anchorPoint is (0,0). It starts in the bottom-left corner. CCSprite and other subclasses have a different default anchorPoint.
@property (nonatomic, readwrite) CGPoint anchorPoint
anchorPointInPoints
The anchorPoint in absolute pixels. Since v0.8 you can only read it. If you wish to modify it, use anchorPoint instead.
@property (nonatomic, readonly) CGPoint anchorPointInPoints
animationManager
Returns the CCB Animation Manager of this node, or that of its parent.
@property (nonatomic, readonly) CCAnimationManager *animationManager
cascadeColorEnabled
CascadeColorEnabled causes changes to this node’s color to cascade down to it’s children. The new color is multiplied in with the color of each child, so it doesn’t bash the current color of those nodes. Opacity is unaffected by this property, see cascadeOpacityEnabled to change the alpha of nodes.
@property (nonatomic, getter=isCascadeColorEnabled) BOOL cascadeColorEnabled
cascadeOpacityEnabled
CascadeOpacity causes changes to this node’s opacity to cascade down to it’s children. The new opacity is multiplied in with the opacity of each child, so it doesn’t bash the current opacity of those nodes. Color is unaffected by this property, see cascadeColorEnabled for color tint changes.
@property (nonatomic, getter=isCascadeOpacityEnabled) BOOL cascadeOpacityEnabled
children
Array of child nodes.
@property (nonatomic, readonly) NSArray *children
color
Sets and returns the color (tint), alpha is ignored when setting.
@property (nonatomic, strong) CCColor *color
colorRGBA
Sets and returns the color (tint) with alpha.
@property (nonatomic, strong) CCColor *colorRGBA
contentSize
The untransformed size of the node in the unit specified by contentSizeType property. The contentSize remains the same no matter the node is scaled or rotated. contentSize is relative to the node.
@property (nonatomic, readwrite, assign) CGSize contentSize
contentSizeInPoints
The untransformed size of the node in Points. The contentSize remains the same no matter the node is scaled or rotated. contentSizeInPoints is affected by the contentSizeType and will be scaled by the [CCDirector sharedDirector].UIScaleFactor if the type is CCSizeUnitUIPoints.
@property (nonatomic, readwrite, assign) CGSize contentSizeInPoints
contentSizeType
Defines the contentSize type used for the widht and height component of the contentSize property.
@property (nonatomic, readwrite, assign) CCSizeType contentSizeType
displayedColor
Returns the displayed color.
@property (nonatomic, readonly) CCColor *displayedColor
displayedOpacity
Returns the displayed opacity.
@property (nonatomic, readonly) CGFloat displayedOpacity
hitAreaExpansion
Expands ( or contracts ) the hit area of the node. The expansion is calculated as a margin around the sprite, in points.
@property (nonatomic, assign) float hitAreaExpansion
name
A name tag used to help identify the node easily.
@property (nonatomic, strong) NSString *name
opacity
Sets and returns the opacity.
@property (nonatomic) CGFloat opacity
Discussion
Warning: If the the texture has premultiplied alpha then, the R, G and B channels will be modified. Values goes from 0 to 1, where 1 means fully opaque.
parent
A weak reference to the parent.
@property (nonatomic, readwrite, unsafe_unretained) CCNode *parent
paused
If paused, no callbacks will be called, and no actions will be run.
@property (nonatomic, assign) BOOL paused
physicsBody
The physics body (if any) that this node is attached to.
@property (nonatomic, strong) CCPhysicsBody *physicsBody
position
Position (x,y) of the node in the unit specified by the positionType property. The distance is measured from one of the corners of the node’s parent container, which corner is specified by the positionType property. Default setting is referencing the bottom left corner in points.
@property (nonatomic, readwrite, assign) CGPoint position
positionInPoints
Position (x,y) of the node in points from the bottom left corner.
@property (nonatomic, readwrite, assign) CGPoint positionInPoints
positionType
Defines the position type used for the position property. Changing the position type affects the meaning of the position, and allows you to change the referenceCorner, relative to the parent container. It allso allows changing from points to UIPoints. UIPoints are scaled by [CCDirector sharedDirector].UIScaleFactor. See “Coordinate System and Positioning” for more information.
@property (nonatomic, readwrite, assign) CCPositionType positionType
rotation
The rotation (angle) of the node in degrees. 0 is the default rotation angle. Positive values rotate node CW.
@property (nonatomic, readwrite, assign) float rotation
rotationalSkewX
The rotation (angle) of the node in degrees. 0 is the default rotation angle. Positive values rotate node CW. It only modifies the X rotation performing a horizontal rotational skew.
@property (nonatomic, readwrite, assign) float rotationalSkewX
rotationalSkewY
The rotation (angle) of the node in degrees. 0 is the default rotation angle. Positive values rotate node CW. It only modifies the Y rotation performing a vertical rotational skew.
@property (nonatomic, readwrite, assign) float rotationalSkewY
runningInActiveScene
Returns YES if the node is added to an active scene and neither it nor any of it’s ancestors is paused.
@property (nonatomic, readonly, getter=isRunningInActiveScene) BOOL runningInActiveScene
scale
The scale factor of the node. 1.0 is the default scale factor. It modifies the X and Y scale at the same time.
@property (nonatomic, readwrite, assign) float scale
scaleInPoints
The scaleInPoints is the scale factor of the node in both X and Y, measured in points. The scaleType indicates if the scaleInPoints will be scaled byt the UIScaleFactor or not. See “Coordinate System and Positioning” for more information.
@property (nonatomic, readonly) float scaleInPoints
scaleType
The scaleType defines scale behavior for this node. CCScaleTypeScaled indicates that the node will be scaled by [CCDirector sharedDirector].UIScaleFactor. This property is analagous to positionType. ScaleType affects the scaleInPoints of a CCNode. See “Coordinate System and Positioning” for more information.
@property (nonatomic, assign) CCScaleType scaleType
scaleX
The scale factor of the node. 1.0 is the default scale factor. It only modifies the X scale factor.
@property (nonatomic, readwrite, assign) float scaleX
scaleXInPoints
The scaleInPoints is the scale factor of the node in X, measured in points.
@property (nonatomic, readonly) float scaleXInPoints
scaleY
The scale factor of the node. 1.0 is the default scale factor. It only modifies the Y scale factor.
@property (nonatomic, readwrite, assign) float scaleY
scaleYInPoints
The scaleInPoints is the scale factor of the node in Y, measured in points.
@property (nonatomic, readonly) float scaleYInPoints
scene
The scene this node is added to, or nil if it’s not part of a scene.
@property (nonatomic, readonly) CCScene *scene
skewX
The X skew angle of the node in degrees. This angle describes the shear distortion in the X direction. Thus, it is the angle between the Y axis and the left edge of the shape The default skewX angle is 0. Positive values distort the node in a CW direction.
@property (nonatomic, readwrite, assign) float skewX
skewY
The Y skew angle of the node in degrees. This angle describes the shear distortion in the Y direction. Thus, it is the angle between the X axis and the bottom edge of the shape The default skewY angle is 0. Positive values distort the node in a CCW direction.
@property (nonatomic, readwrite, assign) float skewY
userObject
Similar to userData, but instead of holding a void* it holds an id.
@property (nonatomic, readwrite, strong) id userObject
visible
Whether of not the node is visible. Default is YES.
@property (nonatomic, readwrite, assign) BOOL visible
zOrder
The z order of the node relative to its “siblings”: children of the same parent.
@property (nonatomic, assign) NSInteger zOrder
Class Methods
node
Allocates and initializes a node. The node will be created as “autorelease”.
+ (id)node
Instance Methods
addChild:
Adds a child to the container with z-order as 0. If the child is added to a ‘running’ node, then ‘onEnter’ and ‘onEnterTransitionDidFinish’ will be called immediately.
- (void)addChild:(CCNode *)node
參數列表：
node
CCNode to add as a child.
addChild:z:
Adds a child to the container with a z-order. If the child is added to a ‘running’ node, then ‘onEnter’ and ‘onEnterTransitionDidFinish’ will be called immediately.
- (void)addChild:(CCNode *)node z:(NSInteger)z
參數列表：
node
CCNode to add as a child.
z
Z depth of node.
addChild:z:name:
Adds a child to the container with z order and tag. If the child is added to a ‘running’ node, then ‘onEnter’ and ‘onEnterTransitionDidFinish’ will be called immediately.
- (void)addChild:(CCNode *)node z:(NSInteger)z name:(NSString *)name
參數列表：
node
CCNode to add as a child.
z
Z depth of node.
name
name tag.
boundingBox
Returns a “local” axis aligned bounding box of the node in points. The returned box is relative only to its parent. The returned box is in Points.
- (CGRect)boundingBox
convertToNodeSpace:
Converts a Point to node (local) space coordinates. The result is in Points.
- (CGPoint)convertToNodeSpace:(CGPoint)worldPoint
參數列表：
worldPoint
World position in points.
返回值：
Local position in points.
convertToNodeSpaceAR:
Converts a Point to node (local) space coordinates. The result is in Points. Treats the returned/received node point as anchor relative.
- (CGPoint)convertToNodeSpaceAR:(CGPoint)worldPoint
參數列表：
worldPoint
World position in points.
返回值：
Local position in points.
convertToWorldSpace:
Converts a Point to world space coordinates. The result is in Points.
- (CGPoint)convertToWorldSpace:(CGPoint)nodePoint
參數列表：
nodePoint
Local position in points.
返回值：
World position in points.
convertToWorldSpaceAR:
Converts a local Point to world space coordinates.The result is in Points. Treats the returned/received node point as anchor relative.
- (CGPoint)convertToWorldSpaceAR:(CGPoint)nodePoint
參數列表：
nodePoint
Local position in points.
返回值：
World position in points.
doesOpacityModifyRGB
Returns whether or not the opacity will be applied using glColor(R,G,B,opacity) or glColor(opacity, opacity, opacity, opacity).
- (BOOL)doesOpacityModifyRGB
draw:transform:
Override this method to draw your own node. You should use cocos2d’s GL API to enable/disable the GL state / shaders. For further info, please see ccGLstate.h. You shall NOT call [super draw];
- (void)draw:(CCRenderer *)renderer transform:(const GLKMatrix4 *)transform
getActionByTag:
Gets an action from the running action list given its tag.
- (CCAction *)getActionByTag:(NSInteger)tag
參數列表：
tag
Tag to retrieve.
返回值：
the Action the with the given tag.
getChildByName:recursively:
Search through the children of the container for one matching the name tag. If recursive, it returns the first matching node, via a depth first search. Otherwise, only immediate children are checked.
- (CCNode *)getChildByName:(NSString *)name recursively:(bool)isRecursive
參數列表：
name
Name tag.
isRecursive
Search recursively through children of children.
返回值：
Returns a CCNode, or nil if no marching nodes are found.
hitTestWithWorldPos:
Check if a touch is inside the node. To allow for custom detection, override this method.
- (BOOL)hitTestWithWorldPos:(CGPoint)pos
參數列表：
pos
World position.
返回值：
Returns true, if the position is inside the node.
init
Initializes the node.
- (id)init
nodeToParentTransform
Returns the matrix that transform the node’s (local) space coordinates into the parent’s space coordinates. The matrix is in Pixels.
- (CGAffineTransform)nodeToParentTransform
nodeToWorldTransform
Returns the world affine transform matrix. The matrix is in Pixels.
- (CGAffineTransform)nodeToWorldTransform
numberOfRunningActions
Returns the numbers of actions that are running plus the ones that are schedule to run (actions in actionsToAdd and actions arrays). 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.
- (NSUInteger)numberOfRunningActions
onEnter
Event that is called every time the CCNode enters the ‘stage’. If the CCNode enters the ‘stage’ with a transition, this event is called when the transition starts. During onEnter you can’t access a sibling node. If you override onEnter, you shall call [super onEnter].
- (void)onEnter
onEnterTransitionDidFinish
Event that is called when the CCNode enters in the ‘stage’. If the CCNode enters the ‘stage’ with a transition, this event is called when the transition finishes. If you override onEnterTransitionDidFinish, you shall call [super onEnterTransitionDidFinish].
- (void)onEnterTransitionDidFinish
onExit
Event that is called every time the CCNode leaves the ‘stage’. If the CCNode leaves the ‘stage’ with a transition, this event is called when the transition finishes. During onExit you can’t access a sibling node. If you override onExit, you shall call [super onExit].
- (void)onExit
onExitTransitionDidStart
Callback that is called every time the CCNode leaves the ‘stage’. If the CCNode leaves the ‘stage’ with a transition, this callback is called when the transition starts.
- (void)onExitTransitionDidStart
parentToNodeTransform
Returns the matrix that transform parent’s space coordinates to the node’s (local) space coordinates. The matrix is in Pixels.
- (CGAffineTransform)parentToNodeTransform
physicsNode
Nearest CCPhysicsNode ancestor of this node, or nil if none. Unlike CCPhysicsBody.physicsNode, this will return a value before onEnter is called on the node.
- (CCPhysicsNode *)physicsNode
Declared In
CCPhysicsNode.h
removeAllChildren
Removes all children from the container forcing a cleanup.
- (void)removeAllChildren
removeAllChildrenWithCleanup:
Removes all children from the container and do a cleanup all running actions depending on the cleanup parameter.
- (void)removeAllChildrenWithCleanup:(BOOL)cleanup
參數列表：
cleanup
Stops all scheduled events and actions.
removeChild:
Removes a child from the container forcing a cleanup. This method checks to ensure the parameter node is actually a child of this node.
- (void)removeChild:(CCNode *)child
參數列表：
child
The child node to remove.
removeChild:cleanup:
Removes a child from the container. It will also cleanup all running and scheduled actions depending on the cleanup parameter. This method checks to ensure the parameter node is actually a child of this node.
- (void)removeChild:(CCNode *)node cleanup:(BOOL)cleanup
參數列表：
node
The child node to remove.
cleanup
Stops all scheduled events and actions.
removeChildByName:
Removes a child from the container by name value forcing a cleanup.
- (void)removeChildByName:(NSString *)name
參數列表：
name
Name of node to be removed.
removeChildByName:cleanup:
Removes a child from the container by name value. It will also cleanup all running actions depending on the cleanup parameter
- (void)removeChildByName:(NSString *)name cleanup:(BOOL)cleanup
參數列表：
name
Name of node to be removed.
cleanup
Stops all scheduled events and actions.
removeFromParent
Remove itself from its parent node forcing a cleanup. If the node orphan, then nothing happens.
- (void)removeFromParent
removeFromParentAndCleanup:
Remove itself from its parent node. If cleanup is YES, then also remove all actions and callbacks. If the node orphan, then nothing happens.
- (void)removeFromParentAndCleanup:(BOOL)cleanup
參數列表：
cleanup
Stops all scheduled events and actions.
runAction:
Executes an action, and returns the action that is executed. The node becomes the action’s target.
- (CCAction *)runAction:(CCAction *)action
參數列表：
action
Action to run.
返回值：
An Action pointer
schedule:interval:
Schedules a custom selector with an interval time in seconds. If time is 0 it will be ticked every frame. In that case, it is recommended to override update: in stead. If the selector is already scheduled, then the interval parameter will be updated without scheduling it again.
- (CCTimer *)schedule:(SEL)s interval:(CCTime)seconds
參數列表：
s
Selector to execute.
seconds
Interval between execution in seconds.
返回值：
A newly initialized CCTimer object.
schedule:interval:repeat:delay:
Schedules a custom selector with an interval time in seconds.
- (CCTimer *)schedule:(SEL)selector interval:(CCTime)interval repeat:(NSUInteger)repeat delay:(CCTime)delay
參數列表：
selector
Selector to execute.
interval
Interval between execution in seconds.
repeat
Number of times to repeat.
delay
Initial delay in seconds.
返回值：
A newly initialized CCTimer object.
scheduleBlock:delay:
Schedules a block to run once, after a certain delay.
- (CCTimer *)scheduleBlock:(CCTimerBlock)block delay:(CCTime)delay
參數列表：
block
Block to execute.
delay
Delay in seconds.
返回值：
A newly initialized CCTimer object.
scheduleOnce:delay:
Schedules a selector that runs only once, with a delay of 0 or larger.
- (CCTimer *)scheduleOnce:(SEL)selector delay:(CCTime)delay
參數列表：
selector
Selector to execute.
delay
Initial delay in seconds.
返回值：
A newly initialized CCTimer object.
setOpacityModifyRGB:
Sets the premultipliedAlphaOpacity property.
- (void)setOpacityModifyRGB:(BOOL)boolean
參數列表：
boolean
Enables or disables setting of opacity with color.
Discussion
If set to NO then opacity will be applied as: glColor(R,G,B,opacity);
If set to YES then opacity will be applied as: glColor(opacity, opacity, opacity, opacity );
Textures with premultiplied alpha will have this property by default on YES. Otherwise the default value is NO.
stopAction:
Removes an action from the running action list.
- (void)stopAction:(CCAction *)action
參數列表：
action
Action to remove.
stopActionByTag:
Removes an action from the running action list given its tag.
- (void)stopActionByTag:(NSInteger)tag
參數列表：
tag
Tag to remove.
stopAllActions
Removes all actions from the running action list
- (void)stopAllActions
transform:
Returns the 4x4 drawing transformation for this node. Really only useful when overriding visit:parentTransform:
- (GLKMatrix4)transform:(const GLKMatrix4 *)parentTransform
unschedule:
Unschedule a scheduled selector.
- (void)unschedule:(SEL)selector
參數列表：
selector
Selector to unschedule.
unscheduleAllSelectors
Unschedule all scheduled selectors.
- (void)unscheduleAllSelectors
updateDisplayedColor:
Recursive method that updates display color.
- (void)updateDisplayedColor:(ccColor4F)color
參數列表：
color
Color used for update.
updateDisplayedOpacity:
Recursive method that updates the displayed opacity.
- (void)updateDisplayedOpacity:(CGFloat)opacity
參數列表：
opacity
Opacity to use for update.
viewDidResizeTo:
Invoked automatically when the OS view has been resized.
- (void)viewDidResizeTo:(CGSize)newViewSize
Discussion
This implementation simply propagates the same method to the children. Subclasses may override to actually do something when the view resizes.
visit
Calls visit:parentTransform using the current renderer and projection.
- (void)visit
visit:parentTransform:
Recursive method that visit its children and draw them.
- (void)visit:(CCRenderer *)renderer parentTransform:(const GLKMatrix4 *)parentTransform
walkSceneGraph:
Prints on the debug console the scene graph
- (void)walkSceneGraph:(NSUInteger)level
參數列表：
level
Level of debug information.
Declared In
CCNode+Debug.h
worldToNodeTransform
Returns the inverse world affine transform matrix. The matrix is in Pixels.
- (CGAffineTransform)worldToNodeTransform
- – physicsNode
- – walkSceneGraph:
- physicsBody property
