Cocos2d-x开源、跨平台的游戏引擎

from://http://blog.linguofeng.com/pages/language/c/Cocos2dx.html

Cocos2d-x

开源、跨平台的游戏引擎

---

一、下载

http://cocos2d-x.org/projects/cocos2d-x/wiki/Download

二、安装 环境：Ubuntu 12.04.1 32bit

$ mkdir /path/to/cocos2d-x
$ mv cocos2d-2.0-rc2-x-2.0.1.zip /path/to/cocos2d-x
$ cd /path/to/cocos2d-x
$ unzip cocos2d-2.0-rc2-x-2.0.1.zip
$ subl ~/.bashrc

export COCOS2DX_ROOT=/path/to/cocos2d-x
export NDK_ROOT=/path/to/android-ndk-r8b    // 需要Android Ndk环境

三、HelloWorld 需要有Android SDK环境与Ant，点击查看

$ cd $COCOS2DX_ROOT/HelloWorld/proj.android
$ chmod u+x build_native.sh
$ ./build_native.sh                            // 编译库
$ android update project -p . -t android-10    // 生成Ant需要的build.xml文件
$ ant debug install                            // 安装到机器上

四、Cocds2d-x基础

主要类介绍

类	说明	作用	关系
CCDirector	导演(单例)	负责场景的切换以及场景的信息。如宽度，高度，旋转场景内容。	包含多个 CCScene
CCScene	场景	场景包含有布景，精灵，每场戏的不同，要切换场景。游戏中可分为主界面， 游戏， 分数榜，结束界面等。	包含多个 CCLayer
CCLayer	布景	类似是层的概念，也可来源于PS的层的概念。每一层都带有众多精灵等	包含多个 CCSprite
CCSprite	精灵	就是演员的，演员就需要加入到层里面去的。有相应的动作。	包含多个 CCAction
CCAction	动作	精灵的动作。
CCMenu	菜单

场景的转换

CCScene* scene =CCScene::node();// 创建sceneCCLayer* layer =CCLayer::node();// 创建layer
scene->addChild(layer);// 添加layer到sceneCCScene* preScene =CCDirector::ShareDirector()->getRunningScene();// 获取当前正在显示的场景if(preScene ==null){// 如果当前没有正在显示的场景CCDirecotr::ShareDirector()->runWithScene(scene);// 显示myScene场景}else{// 否则CCDirecotr::ShareDirector()->replaceScene(scene);// 替换成myScene场景}

常见宏

NS_CC_BEGIN
    // cocos2d命名空间开始
NS_CC_END
    // cocos2d命名空间结束
USING_NS_CC;// 声明cocos2d命名空间
CC_SYNTHESIZE_READONLY(varType, varName, funName)// 声明一个成员变量以及getfunName函数，没有set函数。getfunName已经实现，其实现就是返回这个值。
CC_SYNTHESIZE_READONLY_PASS_BY_REF(varType, varName, funName)// 类似CC_SYNTHESIZE_READONLY，不过getfunName返回的是引用。
CC_SYNTHESIZE(varType, varName, funName)// 声明一个成员变量以及getfunName，setfunName函数.函数声明和实现都有
CC_SYNTHESIZE_PASS_BY_REF(varType, varName, funName)// 类似CC_SYNTHESIZE，不过getfunName返回的是引用。
CC_PROPERTY_READONLY(varType, varName, funName)// 声明一个成员变量以及getfunName函数，没有set函数。getfunName函数的实现要自己做
CC_PROPERTY_READONLY_PASS_BY_REF(varType, varName, funName)// 类似CC_PROPERTY_READONLY，不过getfunName返回的是引用。getfunName函数的实现要自己做
CC_PROPERTY(varType, varName, funName)// 声明一个成员变量以及getfunName，setfunName函数.函数实现要自己做
CC_PROPERTY_PASS_BY_REF(varType, varName, funName)// 类似CC_PROPERTY，，不过getfunName返回的是引用

4.1 动作

CCAction ：动作，分为瞬时动作 CCActionInstanse ，延时动作 CCActionInterval

动作	说明	构造 CCActionInterval	参数说明
CCMoveTo	移动到目标位置	CCMoveTo::actionWithDuration(2, ccp(100, 100))	时间，位置
CCMoveBy	从目标位置移动	CCMoveBy::actionWithDuration(2, ccp(100, 100))	时间，位置
CCScaleTo	缩放至多少倍	CCScaleTo::actionWithDuration(2, 0.5f)	时间，倍数（x、Y柚同时缩放）
CCScaleBy	放大至多少倍	CCScaleBy::actionWithDuration(2, 2f, 3f)	时间，x柚放大倍数，Y柚放大倍数
CCRotateTo	旋转多少角度	CCRotateTo::actionWithDuration(2, 45f)	时间，角度（正数顺时间，负数逆时针）
CCRotateBy	旋转多少角度	CCRotateBy::actionWithDuration(2, 360f)	时间，角度（正数顺时间，负数逆时针）
CCSkewTo	倾斜	CCSkewTo::actionWithDuration(2, 37.2f, -37.2f)	时间，X柚倾斜角度，Y柚倾斜角度
CCSkewBy	倾斜	CCSkewBy::actionWithDuration(2, 37.2f, -37.2f)	时间，X柚倾斜角度，Y柚倾斜角度
CCJumpTo	跳跃	CCJumpTo::actionWithDuration(2, ccp(300,300), 50, 4)	时间，目标坐标，跳的高度，跳的次数
CCJumpBy	跳跃	CCJumpBy::actionWithDuration(2, ccp(300,300), 50, 4)	时间，目标坐标，跳的高度，跳的次数
CCBezierTo	贝塞尔曲线运行	CCBezierTo::actionWithDuration(3, bezier)	时间，ccBezierConfig注结构体
CCBezierBy	贝塞尔曲线运行	CCBezierBy::actionWithDuration(3, bezier)	时间，ccBezierConfig结构体
CCBlink	闪	CCBlink::actionWithDuration(2, 10)	时间，次数
CCFadeIn	淡入	CCFadeIn::actionWithDuration(1.0f)	时间
CCFadeOut	淡出	CCFadeOut::actionWithDuration(1.0f)	时间
CCTintTo	颜色变化	CCTintTo::actionWithDuration(2, 255, 0, 255)	时间，红，绿，蓝
CCTintBy	颜色变化	CCTintBy::actionWithDuration(2, 255, 0, 255)	时间，红，绿，蓝
CCAnimate	动画	CCAnimate::actionWithDuration(3, animation, false)	时间，CCAnimation注，是否恢复原始帧

动作组合方式	说明	构造 CCAction	参数
CCSequence	动作序列，有序地一个一个执行动作	CCSequence::actions(actionTo, actionToBack, NULL)	动作1、运作2、…、后面必须加NULL表示没有了
CCRepeatForever	重复执行动作	CCRepeatForever::actionWithAction(actionTo)	动作
CCSpawn	同时执行动作	CCSpawn::actions(actionTo, actionToBack, NULL)	动作1、运作2、…、后面必须加NULL表示没有了

动作回调	说明	构造	参数
CCCallFunc	不带参数的回调	CCCallFunc::actionWithTarget(this, callfunc_selector(Class::callback1))	当前动作，回调函数注
CCCallFuncN	不带参数但带调用本身	CCCallFuncN::actionWithTarget(this, callfuncN_selector(Class::callback2))	当前动作，回调函数注
CCCallFuncND	带参数的回调	CCCallFuncND::actionWithTarget(this, callfuncND_selector(Class::callback3), (void*)0xbebabeba)	当前动作，回调函数注

CCSize size =CCDirector::sharedDirector()->getWinSize();// 获取屏幕大小CCSprite* pSprite =CCSprite::spriteWithFile("HelloWorld.png");// 创建精灵CCActionInterval* actionTo =CCMoveTo::actionWithDuration(2,CCPointMake(size.width-40, size.height-40));
pSprite->runAction(actionTo);// 运行动作

4.2 菜单

CCMenu ：菜单，参考： http://www.cocos2d-x.org/reference/native-cpp/d1/da0/classcocos2d_1_1_c_c_menu.html

// 创建菜单ItemCCMenuItem* m1 =CCMenuItemFont::itemFromString("新游戏",this, menu_selector(MainLayer::onNewGame));// menu_selector为全局常量CCLabelBMFont* label =CCLabelBMFont::labelWithString("Enable AtlasItem","fonts/bitmapFontTest3.fnt");CCMenuItem* m2 =CCMenuItemLabel::itemWithLabel(label,this, menu_selector(MainLayer::onNewGame));// 通过Label创建ItemCCMenuItem* m3 =CCMenuItemAtlasFont// 通过CCSprite*spriteNormal   =CCSprite::spriteWithFile("image.png",CCRectMake(0,23*2,115,23));CCSprite*spriteSelected =CCSprite::spriteWithFile("image.png",CCRectMake(0,23*1,115,23));CCSprite*spriteDisabled =CCSprite::spriteWithFile("image.png",CCRectMake(0,23*0,115,23));CCMenuItem* m4 =CCMenuItemSprite::itemFromNormalSprite(spriteNormal, spriteSelected, spriteDisabled,this,
                                                        menu_selector(MainLayer::onNewGame));CCMenuItem* m5 =CCMenuItemImage::itemFromNormalImage("image.png","imagep.png",this, menu_selector(MainLayer::onNewGame));CCMenuItem* m6 =CCMenuItemToggle::itemWithTarget(this, menu_selector(MainLayer::onNewGame),CCMenuItemFont::itemFromString("High"),CCMenuItemFont::itemFromString("Low"),...,
                                                        NULL);
m6->getSubItems()->addObject(CCMenuItemFont::itemFromString("33%"));
m6->setSelectedIndex(2);// 添加菜单Item到菜单中CCMenu* menu =CCMenu::menuWithItems(m1, m2, m3, m4, m5, m6, NULL);// 最后必须加NULLvoidMainLayer::onNewGame(CCObject* pSender){// 回调}

4.3 多层

CCLayerMultiplex :多个层，参考： http://www.cocos2d-x.org/reference/native-cpp/d3/d7e/classcocos2d_1_1_c_c_layer_multiplex.html

CCLayer* pLayer1 =newMenuLayer1();CCLayer* pLayer2 =newMenuLayer2();CCLayer* pLayer3 =newMenuLayer3();CCLayer* pLayer4 =newMenuLayer4();CCLayerMultiplex* layer =CCLayerMultiplex::layerWithLayers(pLayer1, pLayer2, pLayer3, pLayer4, NULL);
addChild(layer,0); 

pLayer1->release();
pLayer2->release();
pLayer3->release();
pLayer4->release();CCDirector::sharedDirector()->replaceScene(this);// 切换((CCLayerMultiplex*)m_pParent)->switchTo(0);

4.4 进度条

CCProgressTimer ：进度条

type	说明
kCCProgressTimerTypeRadialCCW	径向逆时针旋转
kCCProgressTimerTypeRadialCW	径向顺时针旋转
kCCProgressTimerTypeHorizontalBarLR	水平从左往右
kCCProgressTimerTypeHorizontalBarRL	水平从右往左
kCCProgressTimerTypeVerticalBarBT	垂直从下往上
kCCProgressTimerTypeVerticalBarTB	垂直从上往下

CCProgressTimer* pt =CCProgressTimer::progressWithFile("image.png");
pt->setType(kCCProgressTimerTypeRadialCCW);
pt->setType(kCCProgressTimerTypeRadialCW);
pt->setType(kCCProgressTimerTypeHorizontalBarLR);
pt->setType(kCCProgressTimerTypeHorizontalBarRL);
pt->setType(kCCProgressTimerTypeVerticalBarBT);
pt->setType(kCCProgressTimerTypeVerticalBarTB);CCProgressTo* to =CCProgressTo::actionWithDuration(2,100);// 时间，百分比
pt->runAction(CCRepeatForever::actionWithAction(to));

4.5 场景转换

CCTransitionScene ：场景转换效果

效果	说明	方法	参数
CCTransitionFade	以颜色淡出淡入	transitionWithDuration(时间, 场景, ccBLACK)	ccc3(255,0,0) ：三原色
CCTransitionFlipX	水平翻转屏幕	transitionWithDuration(时间, 场景, kOrientationRightOver)	kOrientationLeftOver：从左往右  kOrientationRightOver：从右往左
CCTransitionFlipY	垂直翻转屏幕	transitionWithDuration(时间, 场景, kOrientationUpOver)	kOrientationUpOver ：从上往下  kOrientationDownOver：从下往上
CCTransitionFlipAngular	角度翻转屏幕	transitionWithDuration(时间, 场景, kOrientationRightOver)	kOrientationLeftOver：从左下角往上  kOrientationRightOver：从右上角往下
CCTransitionZoomFlipX	水平翻转并缩小/放大	transitionWithDuration(时间, 场景, kOrientationRightOver)	kOrientationLeftOver：从左(放大)往右  kOrientationRightOver：从右(放大)往左
CCTransitionZoomFlipY	垂直翻转并缩小/放大	transitionWithDuration(时间, 场景, kOrientationUpOver)	kOrientationUpOver ：从上(放大)往下  kOrientationDownOver：从下(放大)往上
CCTransitionZoomFlipAngular	角度翻转并缩小/放大	transitionWithDuration(时间, 场景, kOrientationRightOver)	kOrientationLeftOver：从左下角(放大)往上  kOrientationRightOver：从右上角(放大)往下
CCTransitionShrinkGrow	收缩出放大入	transitionWithDuration(时间, 场景)
CCTransitionRotoZoom	转收缩出转放大入	transitionWithDuration(时间, 场景)
CCTransitionMoveInL	从左移动入	transitionWithDuration(时间, 场景)
CCTransitionMoveInR	从右移动入	transitionWithDuration(时间, 场景)
CCTransitionMoveInT	从上移动入	transitionWithDuration(时间, 场景)
CCTransitionMoveInB	从下移动入	transitionWithDuration(时间, 场景)
CCTransitionSlideInL	从左平滑移入	transitionWithDuration(时间, 场景)
CCTransitionSlideInR	从右平滑移入	transitionWithDuration(时间, 场景)
CCTransitionSlideInT	从上平滑移入	transitionWithDuration(时间, 场景)
CCTransitionSlideInB	从下平滑移入	transitionWithDuration(时间, 场景)
CCTransitionCrossFade	交叉淡入两个场景	transitionWithDuration(时间, 场景)
CCTransitionPageTurn	翻页	transitionWithDuration(时间, 场景, 参数)	true ：合上  false ：翻开
CCTransitionFadeTR	往右上角马赛克退出	transitionWithDuration(时间, 场景)
CCTransitionFadeBL	往左下角马赛克退出	transitionWithDuration(时间, 场景)
CCTransitionFadeUp	往上角马赛克退出	transitionWithDuration(时间, 场景)
CCTransitionFadeDown	往下角马赛克退出	transitionWithDuration(时间, 场景)
CCTransitionTurnOffTiles	随机马赛克退出	transitionWithDuration(时间, 场景)
CCTransitionSplitRows	基数行左，偶数行右退出	transitionWithDuration(时间, 场景)
CCTransitionSplitCols	基数行上，偶数行下退出	transitionWithDuration(时间, 场景)

CCTransitionFade* tfScene =CCTransitionFade::transitionWithDuration(2,newCCScene(), ccBLACK);if(tfScene){CCDirector::sharedDirector()->replaceScene(pScene);}

4.6 效果

类	说明	静态函数
CCShaky3D	摇动的3D	CCShaky3D::actionWithRange(5, true, ccg(15,10), t) // 范围 是否摇动 网格大小 时间
CCWaves3D	波浪3D	CCWaves3D::actionWithWaves(5, 40, ccg(15,10), t)
CCFlipX3D	水平翻转3D	CCFlipX3D::actionWithDuration(t)
CCFlipY3D	垂直翻转3D	CCFlipY3D::actionWithDuration(t)
CCLens3D	镜面3D	CCLens3D::actionWithPosition(CCPointMake(size.width/2,size.height/2), 240, ccg(15,10), t)
CCRipple3D	波纹3D	CCRipple3D::actionWithPosition(CCPointMake(size.width/2,size.height/2), 240, 4, 160, ccg(32,24), t)
CCLiquid	液体效果	CCLiquid::actionWithWaves(4, 20, ccg(16,12), t)
CCWaves	波浪效果	CCWaves::actionWithWaves(4, 20, true, true, ccg(16,12), t)
CCTwirl	晃动效果	CCTwirl::actionWithPosition(CCPointMake(size.width/2, size.height/2), 1, 2.5f, ccg(12,8), t)
CCShakyTiles3D	摇动马赛克	CCShakyTiles3D::actionWithRange(5, true, ccg(16,12), t)
CCShatteredTiles3D	破碎马赛克	CCShatteredTiles3D::actionWithRange(5, true, ccg(16,12), t)
CCShuffleTiles	随机马赛克	CCShuffleTiles::actionWithSeed(25, ccg(16,12), t)
CCFadeOutTRTiles	往右上角马赛克淡出	CCFadeOutTRTiles::actionWithSize(ccg(16,12), t)
CCFadeOutBLTiles	往左下角马赛克淡出	CCFadeOutBLTiles::actionWithSize(ccg(16,12), t)
CCFadeOutUpTiles	往上马赛克淡出	CCFadeOutUpTiles::actionWithSize(ccg(16,12), t)
CCFadeOutDownTiles	往下马赛克淡出	CCFadeOutDownTiles::actionWithSize(ccg(16,12), t)
CCTurnOffTiles	马赛克随机消失	CCTurnOffTiles::actionWithSeed(25, ccg(48,32) , t)
CCWavesTiles3D	波浪马赛克	CCWavesTiles3D::actionWithWaves(4, 120, ccg(15,10), t)
CCJumpTiles3D	跳动的3D马赛克	CCJumpTiles3D::actionWithJumps(2, 30, ccg(15,10), t)
CCSplitRows	基数往左，偶数往下	CCSplitRows::actionWithRows(9, t)
CCSplitCols	基数往上，偶数往下	CCSplitCols::actionWithCols(9, t)
CCPageTurn3D	3D翻页效果	CCPageTurn3D::actionWithSize(ccg(15,10), t)

4.7 节点

节点嵌套节点

CCSprite* pSprite1 =newCCSprite();// 一个精灵相当于一个节点CCSprite* pSprite2 =newCCSprite();

pSprite1->addChild(pSprite2);// 一个节点嵌套另一个节点

pSprite1->runAction(action);// 如果父节点执行动作，那此时所有子节点都会执行该动作。

节点删除与清除

prettyprint(node, false/true);          // 节点，false不清理正在运行的动作、true清理正在运行的动作

4.8 精灵

类	说明	静态函数	参数
CCSprite	精灵	CCSprite::spriteWithTexture(CCTexture2D*)	质地
		CCSprite::spriteWithTexture(CCTexture2D*, CCRect&)	质地， CCRect注 矩形
		CCSprite::spriteWithTexture(CCTexture2D*, CCRect&, CCPoint&)	质地，矩形，CCPoint注 点
		CCSprite::spriteWithSpriteFrame(CCSpriteFrame*)	CCSpriteFrame注 精灵框架
		CCSprite::spriteWithSpriteFrameName(char*)	CCSpriteFrame名称
		CCSprite::spriteWithFile(char*)	文件名
		CCSprite::spriteWithFile(char*, CCRect&)	文件名，矩形
		CCSprite::spriteWithBatchNode(CCSpriteBatchNode*, CCRect&)	CCSpriteBatchNode注批量节点，矩形
CCSpriteBatchNode	精灵批量节点	CCSpriteBatchNode->addChild(CCSprite)	添加多个精灵到节点上

4.9 定时器

schedule(schedule_selector(Class::callback),1);// 回调，时间；每隔1秒执行一次voidClass::callback(ccTime dt){}

unschedule(schedule_selector(Class::callback));// 取消定时器

4.10 内存管理 原则：每个自定义类必须继承 cocos2d::CCObject 对象

CCObject对象的内存管理相关接口

// 引用次数+1 virtualvoidCCObject::retain(void);// 引用次数-1；若引用计数器=0，则delete this； virtualvoidCCObject::release(void);// helper方法，快速判断当前对象只有唯一引用 boolCCObject::isSingleRefrence(void);// 返回引用次数 unsignedintCCObject::retainCount(void);// 自动释放（自动管理）CCObject*CCObject::autorelease(void);

手动管理内存

classMyClass:public cocos2d::CCObject{public:MyClass();~MyClass();}MyClass* obj =newMyClass();...
obj->release();// 谁生成（new、copy）谁负责release// 谁retain，谁负责release。
obj->retain();...
obj->release();// 传递赋值时，需要先retain形参，后release原指针，最后赋值。（注意，因为这里没有使用自赋值检查，所以这组顺序不能错。）voidCCNode::setGrid(CCGridBase* pGrid){
    CC_SAFE_RETAIN(pGrid);
    CC_SAFE_RELEASE(m_pGrid);
    m_pGrid = pGrid;}

自动管理内存

MyClass* obj =newMyClass();
obj->autorelease();// 每帧绘制结束，就自动release池中的对象。