您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

cocos2d-x 核心基石 CCNode:屬性、動作與消息調度全解析

編輯:iOS 開發綜合

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;
}

常用方法

1. 創建節點

CCNode *node = [CCNode node];

2. 添加子節點

CCNode *childNode = [CCNode node];

// 方法一:直接添加
[node addChild:childNode];

// 方法二:z 決定繪製順序,按 z 值從小到大依次繪製;
// 若多個節點 z 值相同,則按添加的先後順序繪製
[node addChild:childNode z:0];

// 方法三:name 作用相當於 tag,父節點可據此找到對應子節點
[node addChild:childNode z:0 name:@"nana"];

3. 根據 name 查找子節點

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

4. 刪除子節點

// 方法一:從父節點中移除指定子節點
// cleanup 為 YES 表示停止子節點運行的所有動作與消息調度
[node removeChild:childNode cleanup:YES];

// 方法二:根據 name 移除
[node removeChildByName:@"nana" cleanup:YES];

// 方法三:移除所有子節點
[node removeAllChildrenWithCleanup:YES];

// 方法四:讓節點自己從父節點中脫離
[childNode removeFromParentAndCleanup:YES];

5. 停止所有動作

[node stopAllActions];

核心屬性

zOrder:繪製順序

@property(nonatomic, readonly) NSInteger zOrder;

rotation:旋轉角度

@property(nonatomic, readwrite, assign) float rotation;

默認 0,大於 0 為順時針(CW, clockwise),小於 0 為逆時針。旋轉是繞著 anchorPoint 進行的。

scale / scaleX / scaleY:縮放比例

@property(nonatomic, readwrite, assign) float scale;    // 同時影響寬高
@property(nonatomic, readwrite, assign) float scaleX;   // 只影響寬度
@property(nonatomic, readwrite, assign) float scaleY;   // 只影響高度

默認值均為 1.0,同樣是繞著 anchorPoint 縮放。

contentSize:節點尺寸

@property (nonatomic, readwrite) CGSize contentSize;

不管 scale 和 rotation 如何變化,對 Node 而言 contentSize 始終保持不變。

position:相對於父節點的位置

@property(nonatomic, readwrite, assign) CGPoint position;

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

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

anchorPoint:最需要想清楚的屬性

@property(nonatomic, readwrite) CGPoint anchorPoint;

錨點直接影響三件事:節點的 position 落在哪裡、縮放時繞哪個點、旋轉時繞哪個點。它的 x、y 取值範圍都是 0 到 1(也可以超出這個範圍,但很少這麼用)。

默認情況下,CCSprite、CCLayer、CCScene 的 anchorPoint 都是 (0.5, 0.5),也就是定位點在自身中心。

對 position 的影響

  • anchorPoint = (0, 0),節點的左下角落在 position 指定的位置上;
  • anchorPoint = (0.5, 0.5),節點的中心點落在 position 指定的位置上;
  • anchorPoint = (1, 1),節點的右上角落在 position 指定的位置上。

舉個例子:紅色方塊是藍色方塊的子節點。以藍色左下角為原點 (0, 0),假設藍色 100×100、紅色 50×50,那麼:

// red.position = CGPointMake(50, 50);
// 結果:紅色方塊正好位於藍色方塊的正中心

特殊錨點及其對應的位置關係可以參照下圖:

對縮放的影響

  • anchorPoint = (0, 0),繞自身左下角縮放;
  • anchorPoint = (0.5, 0.5),繞自身中心縮放;
  • anchorPoint = (1, 1),繞自身右上角縮放。
node.scale = 0.5f;   // 寬高變為原來的一半

下圖中藍色代表縮放前,紅色代表縮放後:

對旋轉的影響

  • anchorPoint = (0, 0),繞自身左下角旋轉;
  • anchorPoint = (0.5, 0.5),繞自身中心旋轉;
  • anchorPoint = (1, 1),繞自身右上角旋轉。
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) 就會把節點放在父容器正中央。

單位類型:

  • Points(默認):直接使用 point 值;
  • Scaled:數值會乘以 CCDirector 的 UIScaleFactor,適合在不改動遊戲邏輯的前提下整體放大畫面,例如同時支持手機與平板;
  • Normalized:相對於父容器的比例定位,可以讓節點在任何設備上都居中;
  • Inset / InsetScaled:尺寸等於父容器尺寸再內縮指定的 point 數。

即使 position 和 contentSize 不是以 point 設置的,仍然可以用動作來做動畫。此外還有 CCLayout 與 CCLayoutBox 提供更進階的佈局能力。

關於子類化:cocos2d 遊戲開發中常見的做法是子類化 CCNode、把它加入 CCScene,然後復寫處理用戶輸入的方法。CCNode 的調試擴展在編譯期定義了 DEBUG 宏時可用。

常用 API 速查

創建:+ 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。
  • cleanup 參數為 YES 才會同時停掉動作和調度。移除節點時忘了 cleanup,容易出現「節點沒了但邏輯還在跑」的靈異現象。

把 CCNode 這一套屬性體系吃透,後面的 CCSprite、CCLabel、CCLayer 基本就是換皮而已——差異只在於它們各自畫什麼,而「在哪畫、怎麼變換、何時更新」這些問題,答案都在 CCNode 這裡。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved