免责申明(必读!):本博客提供的所有教程的翻译原稿均来自于互联网,仅供学习交流之用,切勿进行商业传播。同时,转载时不要移除本申明。如产生任何纠纷,均与本博客所有人、发表该翻译稿之人无任何关系。谢谢合作!
原文链接地址:http://www.raywenderlich.com/606/how-to-use-box2d-for-just-collision-detection-with-cocos2d-iphone
程序截图:
当你使用cocos2d来制作一个游戏的时候,有时,你可能想使用cocos2d的action来移动游戏中的对象,而不是直接使用Box2d物理引擎来做。然而,这并不是说你不能使用box2d提供的强大的碰撞检测功能!
这个教程的目的,就是一步一步地向你展示如何仅使用box2d来做碰撞检测---没有物理效果。我们将创建一个简单的demo,里面有一辆车在屏幕上奔驰,当它撞到一只猫后就会放声大笑。是的,我明白,这样做太残忍了。
在这篇教程中,我们会引入一些新的、有趣的概念,比如使用sprite sheets,利用Zwoptex工具来制作它。还会涉及box2d的debug drawing和VertexHelper这个工具。
这个简单假设你已经阅读过前面的一系列的cocos2d和box2d的教程了(如果没有,最好把前面的教程先看一遍),或者你有相关经验也可以。
还有,在我忘记之前--特别要感谢Kim在评论中建议我写一篇这样的教程。
Sprites and Sprite Sheets
在我们开始之前,需要简单地介绍一下sprites和spritesheets。
目前为止,当我们使用cocos2d的时候,我们都是直接使用CCSprite类,然后传递一个精灵图片给它。但是,根据cocos2d最佳实践,如果使用spritesheet来做的话,那样会极大地提高效率。
上图就是一个spritesheet的样例,这个图在cocos2d的样例代码中可以找到。简言之,spritesheet就是一张大的图片,它能够被裁成许多小的子图片。为了指定spritesheet中的每个子图片的位置,你需要为每个图片指定一个坐标,通常是一个矩形。比如,下面的代码展示了,如何把spritesheet中前四张图片抠出来:
spriteSheetWithFile: @" grossini_dance_atlas.jpg " capacity: 1 ];
CCSprite * sprite1 = [CCSprite spriteWithTexture:sheet.texture rect:
CGRectMake( 85 * 0 , 121 * 1 , 85 , 121 )];
CCSprite * sprite2 = [CCSprite spriteWithTexture:sheet.texture rect:
CGRectMake( 85 * 1 , 121 * 1 , 85 , 121 )];
CCSprite * sprite3 = [CCSprite spriteWithTexture:sheet.texture rect:
CGRectMake( 85 * 2 , 121 * 1 , 85 , 121 )];
CCSprite * sprite4 = [CCSprite spriteWithTexture:sheet.texture rect:
CGRectMake( 85 * 3 , 121 * 1 , 85 , 121 )];
你可以会说,写一大堆硬编码的坐标太麻烦了,太烦人了!幸运的是,Robert Payne已经写好了一个非常方便地web工具,叫做Zwoptex,它可以创建精灵表单(spritesheet),同时会导出每个子图片的坐标,这样你在cocos2d里面使用这些子图片就会非常方便了。
制作精灵表单
在我们开始之前,你需要一张图片。你可以下载我老婆制作的车和猫的图片,或者使用你自己的。接下来,打开浏览器,加载Zwoptex主页。你将会看到下面的屏幕:
一旦加载完毕后,点击Zwoptex的File菜单,然后点Import Images。选择你刚刚下载的车和猫的图片,然后点click,这时,你的图片应该出现会互相重叠在一起。拖动其中一张,这样会看得更清楚一些。
注意,这些图片已经被自动地把图片周围的空白部分给去掉了。这并不是我们想要的(后面你会知道为什么),因此,用鼠标把这两张图片都框住,然后选择菜单Modify\Untrim Selected Images。
现在,我们的图片看起来非常好了。点击Arrange\Complex by Height(no spacing),然后它们会排列地更加整齐。
最后,让我们把画布(canvas)的大小调整为合适的大小。点击Modify\Canvas Width,并把它设置为128px。同样的,点击Modify\Canvas Height,然后把它设置为64px。你的屏幕最后看起来应该是下面这个样子。
最后,是时候导出sprite sheet和相应的坐标了!点击File\Export Texture,然后保存sprite sheet为“sprites.jpg”。然后点击File\Export Coordinates“并且保存为”sprites.plist“。注意,这里必须把spritesheet和坐标文件的名字取成相同的,因为,spritesheet为假设它的坐标文件为相应名字的plist文件。
接下来,打开sprites.plist。你会看到Zwopte已经自动地帮你把原图中每一个子图片的坐标计算出来了,并且存储成了一个plist文件。我们接下来就可以使用这些坐标,而不用手工去输入它们了!
从Sprite sheet中添加我们的精灵
好,是时候写一些代码了!
打开Xcode并创建一个新的工程,选择 cocos2d-0.99.1 Box2d Application template,取名为Box2DCollision。然后把自带的样例代码全部删除,你可能从弹球的教程中找到具体的做法。
当然,我们要在HelloWorldScene.mm的顶部加入下面一行代码:
如果你不明白我在这里讲的是些什么,你可能需要看看弹球的教程来获取更多的信息。
接下来,让我们把sprite sheet和坐标plist文件都加入到工程中去。把sprites.jpg和sprites.plist文件都拖到Resouces文件夹中,同时确保 “Copy items into destination group’s folder (if needed)”被复选中。
然后,在HelloWorldScene.h文件的HelloWorld类中,添加下面的成员变量:
现在,让我们修改HelloWorldScene.mm中的init方法来加载我们的spritesheet和plist文件。具体修改如下:
if ((self = [super init])) {
// Create our sprite sheet and frame cache
_spriteSheet = [[CCSpriteSheet spriteSheetWithFile: @" sprites.jpg "
capacity: 2 ] retain];
[[CCSpriteFrameCache sharedSpriteFrameCache]
addSpriteFramesWithFile: @" sprites.plist " ];
[self addChild:_spriteSheet];
[self spawnCar];
[self schedule:@selector(secondUpdate:) interval: 1.0 ];
}
return self;
}
第一件事情就是创建一个spritesheet对象,它是一个可以用来高效地绘制它的所有的CCSprite结点的对象。很明显,这些CCSprite必须共享相同的纹理(texture)。当我们把车子和猫加入到场景中的时候,我们需要将它们当作spritesheet的孩子加进去。
然后,我们使用CCSpriteFrameCache类来加载坐标属性列表文件。这个函数会自动地查找一个与之同名的图片(即sprites.jpg).这也就是前面说的,为什么要把”sprites.jpg“和"sprites.plist”取成相同名字的原因。
在这之后,我们调用一个函数在场景中显示一辆车。同时,还设置一个计时器,每隔一秒调用一次secondUpdate函数。
接下来,让我们实现spawnCar方法。我们的做法是让车子永远地在屏幕中间做路径为三角形的运动。在init函数的上面添加下面函数代码:
CCSprite * car = [CCSprite spriteWithSpriteFrameName: @" car.jpg " ];
car.position = ccp( 100 , 100 );
car.tag = 2 ;
[car runAction:[CCRepeatForever actionWithAction:
[CCSequence actions:
[CCMoveTo actionWithDuration: 1.0 position:ccp( 300 , 100 )],
[CCMoveTo actionWithDuration: 1.0 position:ccp( 200 , 200 )],
[CCMoveTo actionWithDuration: 1.0 position:ccp( 100 , 100 )],
nil]]];
[_spriteSheet addChild:car];
}
注意,这里创建sprite的时候,不是使用spriteWithFile,而是使用spriteWithSpriteFrameName。这里指的是使用spritesheet纹理中代表Car的图片来创建精灵。
还有一点需要注意,我们不是把Car作为HelloWorld层的函数添加进去,而是把Car作为Spritesheet的孙子添加进去的。
这个函数的后面部分你应该比较熟悉了。因此,让我们添加一些猫吧!在上面的spawnCar方法后面添加下面的方法:
CGSize winSize = [CCDirector sharedDirector].winSize;
CCSprite * cat = [CCSprite spriteWithSpriteFrameName: @" cat.jpg " ];
int minY = cat.contentSize.height / 2 ;
int maxY = winSize.height - (cat.contentSize.height / 2 );
int rangeY = maxY - minY;
int actualY = arc4random() % rangeY;
int startX = winSize.width + (cat.contentSize.width / 2 );
int endX = - (cat.contentSize.width / 2 );
CGPoint startPos = ccp(startX, actualY);
CGPoint endPos = ccp(endX, actualY);
cat.position = startPos;
cat.tag = 1 ;
[cat runAction:[CCSequence actions:
[CCMoveTo actionWithDuration: 1.0 position:endPos],
[CCCallFuncN actionWithTarget:self
selector:@selector(spriteDone:)],
nil]];
[_spriteSheet addChild:cat];
}
- ( void )spriteDone:( id )sender {
CCSprite * sprite = (CCSprite * )sender;
[_spriteSheet removeChild:sprite cleanup:YES];
}
- ( void )secondUpdate:(ccTime)dt {
[self spawnCat];
}
你应该对上面的代码线路熟悉了,如果不熟悉,建议看相关的教程后再继续。编译并运行代码,如果一切ok,你将会看到一辆车在屏幕上来回动,同时有一只猫从右至左穿过屏幕。接下来,我们将添加一些碰撞检测的代码。
为这些精灵创建Box2d的body
接下来的一步就是为每个精灵创建一个body,这样box2d就能知道它们的位置了,这样的话,当碰撞发生的时候,我们就可以被告知了。下面所做的事情和之前的教程做法差不多。
然后,这一次,我们不是更新box2d的body,然后再更新sprite。这里,我们是先更新sprite(使用action或者别的),然后再更新box2d的body。
因此,让我们首先创建world。打开HelloWorldScene.h,并在文件顶部添加下面的代码:
然后在HelloWorld类中添加下面的成员变量:
然后在HeloWorldScene.mm的init方法中加入下列代码:
bool doSleep = false ;
_world = new b2World(gravity, doSleep);
注意,这里有两件事情非常重要!首先,我们把重力向量设置成(0,0)。因为我们并不想让这些对象自动运动,而是人为控制其运动。其次,我们告诉box2d不能让这些对象sleep。这一点非常重要,因为我们是人为地移动对象,所以必须设置。
然后,在spawnCat方法上面添加下列代码:
b2BodyDef spriteBodyDef;
spriteBodyDef.type = b2_dynamicBody;
spriteBodyDef.position.Set(sprite.position.x / PTM_RATIO,
sprite.position.y / PTM_RATIO);
spriteBodyDef.userData = sprite;
b2Body * spriteBody = _world -> CreateBody( & spriteBodyDef);
b2PolygonShape spriteShape;
spriteShape.SetAsBox(sprite.contentSize.width / PTM_RATIO / 2 ,
sprite.contentSize.height / PTM_RATIO / 2 );
b2FixtureDef spriteShapeDef;
spriteShapeDef.shape = & spriteShape;
spriteShapeDef.density = 10.0 ;
spriteShapeDef.isSensor = true ;
spriteBody -> CreateFixture( & spriteShapeDef);
}
这段代码对你来说应该比较熟悉了---它和我们在breakout教程中是一样的。然后,这里有一点区别,我们把shape定义的isSensor成员设置成了true。
根据Box参考手册,如果你想让对象之间有碰撞检测但是又不想让它们有碰撞反应,那么你就需要把isSensor设置成true。这正是我们想要的效果!
接下来,在spawnCat的最后一行addChild之前添加下列代码:
同样的,你需要在spawnCar的相应位置添加下列代码:
当我们的sprites被销毁的时候,我们需要销毁Box2d的body。因此,把你的spriteDone方法改写成下面的形式:
CCSprite * sprite = (CCSprite * )sender;
b2Body * spriteBody = NULL;
for (b2Body * b = _world -> GetBodyList(); b; b = b -> GetNext()) {
if (b -> GetUserData() != NULL) {
CCSprite * curSprite = (CCSprite * )b -> GetUserData();
if (sprite == curSprite) {
spriteBody = b;
break ;
}
}
}
if (spriteBody != NULL) {
_world -> DestroyBody(spriteBody);
}
[_spriteSheet removeChild:sprite cleanup:YES];
}
现在,最重要的一部分,我们需要根据sprite的位置改变来更新box2d的body。因此,在init方法里面添加下面一行代码:
然后,把tick方法写成下面的形式:
_world -> Step(dt, 10 , 10 );
for (b2Body * b = _world -> GetBodyList(); b; b = b -> GetNext()) {
if (b -> GetUserData() != NULL) {
CCSprite * sprite = (CCSprite * )b -> GetUserData();
b2Vec2 b2Position = b2Vec2(sprite.position.x / PTM_RATIO,
sprite.position.y / PTM_RATIO);
float32 b2Angle = - 1 * CC_DEGREES_TO_RADIANS(sprite.rotation);
b -> SetTransform(b2Position, b2Angle);
}
}
}
这个方法和我们之前在breakout中写的tick方法差不多,唯一的差别就是,我们现在是基于cocos2d的精灵位置来更新box2d的body位置。
编译并运行工程,可能看起来和之前并没有什么差别。你可能会想,到底我们刚刚写了这么多代码有用没啊!好,接下来我就会展示给你看---激活debug drawing!
激活 Box2D 的Debug Drawing
因为,你是使用box2d的模板建的项目,所以里面已经包含了一个GLES-Render.h和GLES-Render.mm文件,如果想要激活debug drawing,有这两个文件就足够了!
接下来,让我们在HelloWorldScene.h的顶部包含下面的头文件:
然后,在HelloWorld类中添加以下成员变量:
接下来,在init方法中添加下面的代码:
_debugDraw = new GLESDebugDraw( PTM_RATIO );
_world -> SetDebugDraw(_debugDraw);
uint32 flags = 0 ;
flags += b2DebugDraw::e_shapeBit;
_debugDraw -> SetFlags(flags);
这段代码是创建一个GLESDebug类,并且把它注册到world对象里面。我们传递一个flag来指定我们需要显示的仿真细节---这里我们只想显示box2d的shape。对于你可以设置的所有的flag标志,可以参考b2WorldCallbacks.h文件。
接下来,我们需要添加一个draw方法。在init方法后面添加draw方法:
{
glDisable(GL_TEXTURE_2D);
glDisableClientState(GL_COLOR_ARRAY);
glDisableClientState(GL_TEXTURE_COORD_ARRAY);
_world -> DrawDebugData();
glEnable(GL_TEXTURE_2D);
glEnableClientState(GL_COLOR_ARRAY);
glEnableClientState(GL_TEXTURE_COORD_ARRAY);
}
老实说,我现在仍然对opengl陌生,因此,我并不是很清楚这里的opengl代码做了些什么事。然后,这是激活debug draw的标准代码,它可以工作!:)
最后需要注意的一点,在dealloc函数中添加清理代码:
delete _world;
delete _debugDraw;
[super dealloc];
}
现在,编译并运行工程,你将会看到所有的box2d shape周围都有一个粉红色的矩形区域。如果一切ok的话,你会看到这些粉红色的shape会跟着sprite运动。
碰撞检测
现在,是时候压死几只猫了!
像之前的breakout游戏一样,我们将往world对象里面注册一个contact listener对象。你可以下载我为这个教程制作的contact listener代码,然后把 MyContactListener.h 和 MyContactListener.mm两个文件添加到工程中去:
同时,你还可以下载我为本教程制作的美妙的音效。
回到代码。在HelloWorldScene.h中添加下面的代码:
#import " SimpleAudioEngine.h "
然后,在HelloWord类中添加下面成员变量:
然后,在init方法中加入下面的代码:
_contactListener = new MyContactListener();
_world -> SetContactListener(_contactListener);
// Preload effect
[[SimpleAudioEngine sharedEngine] preloadEffect: @" hahaha.caf " ];
最后,在tick方法的底部加入下面的代码:
std::vector < MyContact > ::iterator pos;
for (pos = _contactListener -> _contacts.begin();
pos != _contactListener -> _contacts.end(); ++ pos) {
MyContact contact = * pos;
b2Body * bodyA = contact.fixtureA -> GetBody();
b2Body * bodyB = contact.fixtureB -> GetBody();
if (bodyA -> GetUserData() != NULL && bodyB -> GetUserData() != NULL) {
CCSprite * spriteA = (CCSprite * ) bodyA -> GetUserData();
CCSprite * spriteB = (CCSprite * ) bodyB -> GetUserData();
if (spriteA.tag == 1 && spriteB.tag == 2 ) {
toDestroy.push_back(bodyA);
} else if (spriteA.tag == 2 && spriteB.tag == 1 ) {
toDestroy.push_back(bodyB);
}
}
}
std::vector < b2Body *> ::iterator pos2;
for (pos2 = toDestroy.begin(); pos2 != toDestroy.end(); ++ pos2) {
b2Body * body = * pos2;
if (body -> GetUserData() != NULL) {
CCSprite * sprite = (CCSprite * ) body -> GetUserData();
[_spriteSheet removeChild:sprite cleanup:YES];
}
_world -> DestroyBody(body);
}
if (toDestroy.size() > 0 ) {
[[SimpleAudioEngine sharedEngine] playEffect: @" hahaha.caf " ];
}
这段代码和我们之前的breakout教程中的代码基本上差不多,因此你应该比较熟悉了。
还有一件事别忘了,往dealloc方法里面加入清理代码!这个灰常重要!
[_spriteSheet release];
再运行一下工程看看!
调整shape的边界
你可能已经注意到了,我们的box2d shape的边界并不是和sprite的边界完全吻合。对于有些碰撞检测要求不是特别精确的游戏,这也许够了,但是,有些游戏确不行!我们需要严格地定义shape的边界和精灵的边界重合在一起。
在Box2d里面,你可以通过指定shape的顶点来指定shape的形状。然后,硬编码这些顶点数据会很耗时,而且容易出错。幸运的是, Johannes Fahrenkrug已经开发出了一个非常方便的工具,叫做 VertexHelper,它可以用来非常方便地定义顶点,而且可以导出box2d所需要的格式的数据。
好了,先去下载VertexHelper吧。他是一个Mac应用程序,同时包含了源代码,因此,你只需要打开 VertexHelper.xcodeproj,然后编译并运行就可以了。当运行工程的时候,你会看到下面的屏幕输出:(为了方便起见,你可以把编译好的工程放到Application文件夹下面,以后就直接打开就可以了)
继续,把sprites.jpg拖到VertexHelper中,拖的时候,放置在 “Drop Sprite Image here”标签上面。在Rows/Cols部分,把相应的数字设置成1和2.VertexHelper会自动地把图片划分成两个部分。
接下来,把”Edit Mode"复选框打上勾,紧接着,你需要按照逆时针方向在精灵的四周定义一些顶点。注意,box2d将自动地把最后一个顶点与第一个顶点连接起来,因此,我们不需要连接它们。
另外一件非常重要的事情是,当你定义顶点的时候,你需要确保定义的多边形是凸多边形。这意味着多边形的内部没有一个角大于180度。或者说是,多边形内任何两个顶点的连线都在多边形的内部。如果你对这个定义不是很清楚的话,建议百度一下凸多边形和凹多边形。当然,也可以看看下面这个js制作的demo。
最后,注意box2d定义了b2_maxPolygonVertices,它限制了每一个shape最多可以定义的顶点的个数,默认值是8.当然,你可以在b2Settings.h中把这个值改掉。但是,这个教程中,我们只需要8个顶点就够了。
(这个过程最好用一个视频来演示一下,不过翻不了墙,也看不了了。不过自己多摸索一下,这个工具还是很容易使用的)
一旦你做完之后,在下拉列表中选择Box2d,Style选择“Initialization”。然后把右边生成的代码copy下来并粘贴到工程中去。
好,让我们把工程中的shape定义换一下。打开HelloWorldScene.mm,然后修改 addBoxBodyForSprite方法。首先注释掉一些代码,如下图所示:
sprite.contentSize.height/PTM_RATIO/2); */
if (sprite.tag == 1 ) {
// Uncomment this and replace the number with the number of vertices
// for the cat that you defined in VertexHelper
// int num = 6;
// b2Vec2 verts[] = {b2Vec2(4.5f / PTM_RATIO, -17.7f / PTM_RATIO),
// b2Vec2(20.5f / PTM_RATIO, 7.2f / PTM_RATIO),
// b2Vec2(22.8f / PTM_RATIO, 29.5f / PTM_RATIO),
// b2Vec2(-24.7f / PTM_RATIO, 31.0f / PTM_RATIO),
// b2Vec2(-20.2f / PTM_RATIO, 4.7f / PTM_RATIO),
// b2Vec2(-11.7f / PTM_RATIO, -17.5f / PTM_RATIO)};
// Then add this
// spriteShape.Set(verts, num);
} else {
// Do the same thing as the above, but use the car data this time
}
再多啰嗦一句:在选择Style的时候一定要选择“Initialization”,因为b2PolygonShape:Set方法对于“Initialization”会自动计算shape的法向量和质心。
一旦做完之后,编译并运行工程。这时,你会看到shape的边界基本上和sprite的边界吻合在一起了,当然碰撞检测就会更加真实了!
恩,你已经看到了使用box2d来做碰撞检测的强大了!
发挥想象,去做更多好玩的物理效果游戏吧!
总结!
这里有本教程的完整源代码。
注意,这里用来做碰撞检测的代码,仅仅是box2d里面实现碰撞检测的一种方式。Lam在cocos2d论坛里面提出了另外一种方法,使用b2CollidePolygons来做碰撞检测,详情请参考这里。如果你只想做碰撞检测,你可能想看看lam的实现。
对于其它开发者全体在他们的项目里面使用cocos2d和box2d,我非常之感兴趣!你在你的项目中使用box2d吗?或者仅仅用它来做碰撞检测,或者根本不使用它?或者如果你使用box2d来做碰撞检测,你是怎么做的呢?
欢迎大家踊跃发言,分享自己的经验和看法,谢谢!