
CCNode 繼承自 CCResponder 並遵守 CCSchedulerTarget 協議,而 CCResponder 又繼承自 NSObject。因此除了 CCResponder 之外,CCNode 幾乎是 cocos2d-x 中所有類的基類——常用的 CCScene(場景)、CCLayer(圖層)、CCSprite(精靈)全都出自這裡。
它是一個不可視化的抽象類,本身不負責畫出任何具體內容,職責是定義所有節點的公共屬性與方法。理解了 CCNode,也就理解了 cocos2d-x 的整個坐標與渲染體系。
先看看 CCNode 的成員定義,只保留關鍵字段:
@interface CCNode : CCResponder <CCSchedulerTarget>
{
// 旋轉角度
float _rotationalSkewX, _rotationalSkewY;
// 縮放比例
float _scaleX, _scaleY;
// OpenGL 實際的 Z vertex
float _vertexZ;
// 節點位置
CGPoint _position;
// 傾斜(Skew)角度
float _skewX, _skewY;
// 錨點,單位為 point
CGPoint _anchorPointInPoints;
// 錨點,歸一化數值
CGPoint _anchorPoint;
// 節點正常狀態下的尺寸
CGSize _contentSize;
// 形變矩陣
CGAffineTransform _transform, _inverse;
BOOL _isTransformDirty;
BOOL _isInverseDirty;
// Z 軸排序值
NSInteger _zOrder;
// 子節點數組
NSMutableArray *_children;
// 父節點的弱引用
__weak CCNode *_parent;
// 名字,作為 tag 使用
NSString *_name;
// 用戶數據域
id _userObject;
// 用於在 zOrder 相同時保持添加順序
NSUInteger _orderOfArrival;
// 是否可見
BOOL _visible;
BOOL _isReorderChildDirty;
// 顯示色與顏色分開保存,以便顏色和透明度能級聯傳遞給子節點
ccColor4F _displayColor, _color;
// 是否啟用顏色/透明度級聯
BOOL _cascadeColorEnabled, _cascadeOpacityEnabled;
}
CCNode *node = [CCNode node];
CCNode *childNode = [CCNode node]; // 方法一:直接添加 [node addChild:childNode]; // 方法二:z 決定繪製順序,按 z 值從小到大依次繪製; // 若多個節點 z 值相同,則按添加的先後順序繪製 [node addChild:childNode z:0]; // 方法三:name 作用相當於 tag,父節點可據此找到對應子節點 [node addChild:childNode z:0 name:@"nana"];

// recursively 為 YES 時按深度優先遞歸子孫節點,返回最先匹配者; // 為 NO 時只查找直接子節點 [node getChildByName:@"nana" recursively:YES];

// 方法一:從父節點中移除指定子節點 // cleanup 為 YES 表示停止子節點運行的所有動作與消息調度 [node removeChild:childNode cleanup:YES]; // 方法二:根據 name 移除 [node removeChildByName:@"nana" cleanup:YES]; // 方法三:移除所有子節點 [node removeAllChildrenWithCleanup:YES]; // 方法四:讓節點自己從父節點中脫離 [childNode removeFromParentAndCleanup:YES];

[node stopAllActions];

@property(nonatomic, readonly) NSInteger zOrder;

@property(nonatomic, readwrite, assign) float rotation;
默認 0,大於 0 為順時針(CW, clockwise),小於 0 為逆時針。旋轉是繞著 anchorPoint 進行的。

@property(nonatomic, readwrite, assign) float scale; // 同時影響寬高 @property(nonatomic, readwrite, assign) float scaleX; // 只影響寬度 @property(nonatomic, readwrite, assign) float scaleY; // 只影響高度
默認值均為 1.0,同樣是繞著 anchorPoint 縮放。

@property (nonatomic, readwrite) CGSize contentSize;
不管 scale 和 rotation 如何變化,對 Node 而言 contentSize 始終保持不變。


@property(nonatomic, readwrite, assign) CGPoint position;
cocos2d-x 採用數學中的笛卡爾坐標系,以父節點的左下角為原點 (0, 0):x 值向右遞增,y 值向上遞增。

要注意的是,position 描述的是「Node 的 anchorPoint 在其父 Node 中的位置」,這一句是理解 cocos2d-x 定位的關鍵。


@property(nonatomic, readwrite) CGPoint anchorPoint;
錨點直接影響三件事:節點的 position 落在哪裡、縮放時繞哪個點、旋轉時繞哪個點。它的 x、y 取值範圍都是 0 到 1(也可以超出這個範圍,但很少這麼用)。
默認情況下,CCSprite、CCLayer、CCScene 的 anchorPoint 都是 (0.5, 0.5),也就是定位點在自身中心。

舉個例子:紅色方塊是藍色方塊的子節點。以藍色左下角為原點 (0, 0),假設藍色 100×100、紅色 50×50,那麼:
// red.position = CGPointMake(50, 50); // 結果:紅色方塊正好位於藍色方塊的正中心
特殊錨點及其對應的位置關係可以參照下圖:

node.scale = 0.5f; // 寬高變為原來的一半
下圖中藍色代表縮放前,紅色代表縮放後:

node.rotation = 45; // 順時針旋轉 45 度
藍色代表旋轉前,紅色代表旋轉後:

// 父節點 @property(nonatomic, readwrite, assign) CCNode* parent; // 所有子節點 @property(nonatomic, readonly) NSArray *children; // 是否可見,默認 YES @property(nonatomic, readwrite, assign) BOOL visible; // 添加節點時設置的標記 @property(nonatomic, readwrite, copy) NSString *name;



還有一個實用方法,返回節點的邊界框(相當於 frame,包含 position 與尺寸):
- (CGRect)boundingBox;


動作是指在特定時間內完成移動、縮放、旋轉等操作的行為。CCNode 通過 runAction 來運行動作,从而实现各種動畫效果。
- (CCAction*) runAction:(CCAction*) action;
// 初始化一個平移動作:向左移動 100 的距離 CCAction *action = [CCMoveBy actionWithDuration:2 position:CGPointMake(-100, 0)]; // 可以給動作設置 tag action.tag = 100; // 運行動作 [node runAction:action];
動作執行完畢後會自動從節點上移除。

// 停止節點上的所有動作 - (void) stopAllActions; // 停止某個特定的動作 - (void) stopAction:(CCAction*) action; // 根據 tag 停止對應動作 - (void) stopActionByTag:(NSInteger) tag; // 根據 tag 獲取動作 - (CCAction*) getActionByTag:(NSInteger) tag; // 當前正在運行的動作總數 - (NSUInteger) numberOfRunningActions;

消息調度指的是系統每隔一段時間自動調用一次節點的某個方法。這在遊戲開發中極其常用:比如一顆子彈射出後,需要週期性地改變它的位置。
為了演示,先定義一個子彈類。子彈是看得見的,所以應該繼承 CCSprite 而不是 CCNode:
// Bullet.h #import "CCSprite.h" @interface Bullet : CCSprite @end
最簡單的做法是在節點初始化時直接調用 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 代表距上次調用以來經過的時間,即兩次調用的時間差。
如果希望按固定間隔調用,只要把 interval 改為具體秒數:
- (id)init {
if (self = [super init]) {
// 每隔 0.2 秒調用一次 changePosition:
[self schedule:@selector(changePosition:) interval:0.2f];
}
return self;
}
- (void)changePosition:(CCTime)delta {
// do something here
}
取消調度:
// 取消指定的選中方法 - (void) unschedule:(SEL) s; // 取消所有調度(包括 update:) - (void) unscheduleAllSelectors;

CCNode 是 Cocos2d 中所有可顯示對象的基類,節點以樹狀層次組織,通常根節點是一個 CCScene。CCNode 負責變換、可以持有 contentSize,並為其子節點提供坐標系。
坐標單位:position 默認以 point 為單位。使用 point 的好處是能屏蔽不同屏幕密度的差異——在 Retina 屏上 1 point 對應 2 像素,非 Retina 設備上 1 point 就是 1 像素。通過 positionType 可以改變解釋方式,例如設為 CCPositionTypeNormalized 後,(0.5, 0.5) 就會把節點放在父容器正中央。
單位類型:
即使 position 和 contentSize 不是以 point 設置的,仍然可以用動作來做動畫。此外還有 CCLayout 與 CCLayoutBox 提供更進階的佈局能力。
關於子類化:cocos2d 遊戲開發中常見的做法是子類化 CCNode、把它加入 CCScene,然後復寫處理用戶輸入的方法。CCNode 的調試擴展在編譯期定義了 DEBUG 宏時可用。
創建:+ node、- init
位置與尺寸:position、positionInPoints、positionType、rotation、rotationalSkewX/Y、scale、scaleX、scaleY、scaleInPoints、scaleType、skewX、skewY、contentSize、contentSizeInPoints、contentSizeType、anchorPoint、anchorPointInPoints、boundingBox
子節點管理:addChild:、addChild:z:、addChild:z:name:、removeChild:、removeChild:cleanup:、removeChildByName:、removeAllChildren、removeFromParent、parent、children、getChildByName:recursively:、zOrder
場景管理:onEnter、onEnterTransitionDidFinish、onExit、onExitTransitionDidStart、scene、runningInActiveScene
動作:runAction:、stopAllActions、stopAction:、stopActionByTag:、getActionByTag:、numberOfRunningActions
調度:schedule:interval:、schedule:interval:repeat:delay:、scheduleOnce:delay:、scheduleBlock:delay:、unschedule:、unscheduleAllSelectors
坐標變換:nodeToParentTransform、parentToNodeTransform、nodeToWorldTransform、worldToNodeTransform、convertToNodeSpace:、convertToWorldSpace:、convertToNodeSpaceAR:、convertToWorldSpaceAR:
渲染(供子類使用):draw:transform:、visit、visit:parentTransform:、color、opacity、displayedColor、displayedOpacity、cascadeColorEnabled、cascadeOpacityEnabled
anchorPoint 默認值在 CCNode 上是 (0, 0),但 CCSprite 等子類是 (0.5, 0.5)。同一段代碼換個節點類型,位置表現可能完全不同。contentSize 不受 scale 和 rotation 影響,做碰撞檢測時要自己換算。parent 是弱引用,不要指望它幫你保住內存。onEnter 與 onEnterTransitionDidFinish 會被立即調用;復寫這兩個方法時記得調 super。把 CCNode 這一套屬性體系吃透,後面的 CCSprite、CCLabel、CCLayer 基本就是換皮而已——差異只在於它們各自畫什麼,而「在哪畫、怎麼變換、何時更新」這些問題,答案都在 CCNode 這裡。