玩 Cocos2D 一段時間後,最容易被絆倒的往往不是 API,而是座標。本文把 Cocos2D 裡的幾組座標關係一次講清楚:地圖座標、節點座標、anchorPoint 的意義,以及螢幕觸摸點如何轉換到場景節點。
先看一段初始化程式碼,後續都以此為基礎:
- (id)init {
if ((self = [super init])) {
CCTMXTiledMap *gameWorld = [CCTMXTiledMap tiledMapWithTMXFile:@"PositionText.tmx"];
[self addChild:gameWorld];
CGSize winSize = [[CCDirector sharedDirector] winSize];
CCLOG(@"mapSize: %.2f x %.2f", gameWorld.mapSize.width, gameWorld.mapSize.height);
CCLOG(@"tileSize: %.2f x %.2f", gameWorld.tileSize.width, gameWorld.tileSize.height);
CCLOG(@"winSize: %.2f x %.2f", winSize.width, winSize.height);
CCSprite *pointSprite = [CCSprite spriteWithFile:@"point.png"];
[gameWorld addChild:pointSprite z:2 tag:1];
pointSprite.position = ccp(20, 20);
pointSprite.anchorPoint = ccp(0.5, 0.5);
CCSprite *rectSprite = [CCSprite spriteWithFile:@"myrect.png"];
[gameWorld addChild:rectSprite z:1 tag:1];
rectSprite.position = ccp(20, 20);
rectSprite.anchorPoint = ccp(0.5, 0.5);
}
return self;
}
gameWorld.mapSize // 地圖總共幾格,例如 (10, 10) gameWorld.tileSize // 單格像素尺寸,例如 (20, 20) gameWorld.mapSize * gameWorld.tileSize // 整個地圖的像素尺寸
上面最後一行以格子數乘以單格尺寸,得到地圖的實際大小。示範中格子是正方形,長方形也同理。
做個對照實驗:放一張 1×1 的紅色點圖與一張 20×20 的藍色方形圖,兩者 position 都設為 (20, 20),anchorPoint 都設為 (0.5, 0.5)。執行後你會看到方形圖的「中心」正好落在點圖上。
接著換不同的 anchorPoint 觀察:
ccp(0.5, 0.5)(預設值):以精靈中心為錨點。ccp(0, 0):方形圖的左下角與點圖重合。ccp(1, 1):方形圖的右上角與點圖重合。ccp(0.5, 1)、ccp(1, 0.5) 等中間值,同理可推。歸納起來就是:anchorPoint 描述的是「精靈自身座標系中的哪一點,會被對齊到 position」。數值範圍是 0~1 的比例,超出這個範圍也完全合法,例如 ccp(2, 2) 代表錨點落在精靈右上方一倍寬高的位置。
Cocos2D 底層使用 OpenGL 座標系:原點在螢幕左下角,X 軸向右,Y 軸向上。而 iOS 原生的 UIKit/Quartz 座標系是原點在左上角,Y 軸向下。
正因為 Cocos2D 的原點在左下角,精靈自身的內部座標原點也在左下角,這才解釋了為何 (0, 0) 是左下角、(1, 1) 是右上角、(0.5, 0.5) 剛好是中心。理解這點之後,負值或大於 1 的錨點位置也能自行推算出來。
由於兩套座標系方向不同,處理觸摸事件時必須逐層轉換:
- (BOOL)ccTouchBegan:(UITouch *)touch withEvent:(UIEvent *)event {
// ① UIKit 螢幕座標
CGPoint point = [touch locationInView:[touch view]];
CCLOG(@"Screen coord: %.2f, %.2f", point.x, point.y);
// ② 轉為 OpenGL 座標
point = [[CCDirector sharedDirector] convertToGL:point];
CCLOG(@"OpenGL coord: %.2f, %.2f", point.x, point.y);
// ③ 再轉為當前節點的座標系
point = [self convertToNodeSpace:point];
CCLOG(@"CCNode1 coord: %.2f, %.2f", point.x, point.y);
// 上述 ①②③ 三步,Cocos2D 已封裝成一個方法
point = [self convertTouchToNodeSpace:touch];
CCLOG(@"CCNode2 coord: %.2f, %.2f", point.x, point.y);
// 反向:轉回 UIKit 座標
point = [[CCDirector sharedDirector] convertToUI:point];
CCLOG(@"UIView coord: %.2f, %.2f", point.x, point.y);
// 轉為相對於 rectSprite 的座標(AR 代表 anchor-relative)
point = [rectSprite convertTouchToNodeSpaceAR:touch];
CCLOG(@"TouchAR coord: %.2f, %.2f", point.x, point.y);
return YES;
}
Node1 與 Node2 印出的值完全相同,因為 convertTouchToNodeSpace: 本質上就是 ①②③ 的組合。它的原始實作如下:
- (CGPoint)convertTouchToNodeSpace:(UITouch *)touch {
CGPoint point = [touch locationInView:[touch view]];
point = [[CCDirector sharedDirector] convertToGL:point];
return [self convertToNodeSpace:point];
}
需要留意的是,convertTouchToNodeSpace: 與 convertTouchToNodeSpaceAR: 並不等價。前者回傳相對於節點「原點」的座標,後者回傳相對於節點「錨點」的座標。當 anchorPoint 不是 (0, 0) 時,兩者會差一個偏移量,做碰撞判斷時選錯就會出現邊界錯位。
取得精靈的 textureRect 當作碰撞矩形,再用 CGRectContainsPoint 判斷即可:
CGRect rect = [rectSprite textureRect];
rect = CGRectMake(0, 0, rect.size.width, rect.size.height);
CGPoint point = [rectSprite convertTouchToNodeSpaceAR:touch];
CCLOG(@"TouchAR coord: %.2f, %.2f", point.x, point.y);
if (CGRectContainsPoint(rect, point)) {
CCLOG(@"You touched in the rectSprite");
}
點擊位置要對應回地圖格子,需要把像素座標換算成格子索引。注意 Y 軸要用地圖高度減去,因為 Cocos2D 原點在下,而 TMX 的格子索引從上往下算:
- (CGPoint)tilePosition:(CGPoint)pos {
CCTMXLayer *ly = [gameWorld layerNamed:@"Layer 0"];
if (ly == nil) { CCLOG(@"Error: Layer not found!"); return ccp(-1, -1); }
CGSize layerSize = [ly layerSize];
CGSize tileSize = [gameWorld tileSize];
int x = pos.x / tileSize.width;
int y = layerSize.height - pos.y / tileSize.height;
if (x < 0 || x >= layerSize.width || y < 0 || y >= layerSize.height) {
return ccp(-1, -1); // 超出地圖範圍,以 (-1, -1) 表示無效
}
CCLOG(@"tile: %d, %d", x, y);
return ccp(x, y);
}
- (BOOL)ccTouchBegan:(UITouch *)touch withEvent:(UIEvent *)event {
CGPoint point = [self convertTouchToNodeSpace:touch];
CGPoint tilePos = [self tilePosition:point];
if (tilePos.x == -1 || tilePos.y == -1) return NO;
CCTMXLayer *ly = [gameWorld layerNamed:@"Layer 0"];
if ([ly tileGIDAt:tilePos] != 3) {
[ly setTileGID:0 at:tilePos]; // 把該格的圖磚編號改掉
}
return YES;
}
整套流程串起來就是:取得觸摸點 → 轉成場景節點座標 → 換算成格子索引 → 對圖層做讀寫。這也是絕大多數 2D 網格遊戲處理點擊的基本套路,之後要擴充成角色移動、方塊消除或地圖編輯器,都只是在這條鏈路上加判斷而已。