首页 > 代码库 > cocod2d-x 之 HelloWorld
cocod2d-x 之 HelloWorld
cocos2d-x 2.2创建项目
进入cocos2d-x-2.2/tools/project-creator，运行命令
python create_project.py -project MyGame -package com.MyCompany.AwesomeGame -language cpp
即可在cocos2d-x-2.2/projects下生成空白项目，进入项目中查看文件结构，主要有Class文件夹，存放源文件，Resources文件夹存放游戏中需要的图片、音频和配置等资源文件，还有为各平台生成的proj文件夹。空项目创建后即可编译运行，win平台直接使用vs从proj.win32打开项目并引入依赖，F5运行。linux平台进入proj.linux，直接bash build.sh编译，然后进入生成的bin/debug或bin/release目录下运行可执行文件。
进入Class目录查看框架生成的文件，包括HelloWorldScene和AppDelegate，AppDelegate中主要包含3个方法：项目的初始化bool applicationDidFinishLaunching(), 项目进入后台时的处理方法 void applicationDidEnterBackground(), 项目恢复到前台时的处理方法 void applicationWillEnterForeground()。项目在前后台切换时一般都是停止/恢复所有的精灵动作、背景音乐、特效音乐等。applicationDidFinishLaunching方法
bool AppDelegate::applicationDidFinishLaunching() { // initialize director //初始化游戏引擎控制器CCDirector，以便启动游戏引擎 CCDirector* pDirector = CCDirector::sharedDirector(); CCEGLView* pEGLView = CCEGLView::sharedOpenGLView(); pDirector->setOpenGLView(pEGLView); // turn on display FPS //启用FPS显示 pDirector->setDisplayStats(true); // set FPS. the default value is 1.0/60 if you don‘t call this //设置绘制间隔，默认每秒60帧 pDirector->setAnimationInterval(1.0 / 60); // create a scene. it‘s an autorelease object //创建场景 CCScene *pScene = HelloWorld::scene(); // run //运行 pDirector->runWithScene(pScene); return true;}
HelloWorldScene的初始化
CCScene* HelloWorld::scene(){ CCScene *scene = CCScene::create(); HelloWorld *layer = HelloWorld::create(); scene->addChild(layer); return scene;}// 初始化bool HelloWorld::init(){ // 1. super init first if ( !CCLayer::init() ) { return false; } CCSize visibleSize = CCDirector::sharedDirector()->getVisibleSize(); CCPoint origin = CCDirector::sharedDirector()->getVisibleOrigin(); // 添加关闭按钮，位置为屏幕左下方 CCMenuItemImage *pCloseItem = CCMenuItemImage::create( "CloseNormal.png", "CloseSelected.png", this, menu_selector(HelloWorld::menuCloseCallback)); pCloseItem->setPosition(ccp(origin.x + visibleSize.width - pCloseItem->getContentSize().width/2 , origin.y + pCloseItem->getContentSize().height/2)); CCMenu* pMenu = CCMenu::create(pCloseItem, NULL); pMenu->setPosition(CCPointZero); this->addChild(pMenu, 1); // 创建一个label CCLabelTTF* pLabel = CCLabelTTF::create("Hello World", "Arial", 24); pLabel->setPosition(ccp(origin.x + visibleSize.width/2, origin.y + visibleSize.height - pLabel->getContentSize().height)); this->addChild(pLabel, 1); CCSprite* pSprite = CCSprite::create("HelloWorld.png"); pSprite->setPosition(ccp(visibleSize.width/2 + origin.x, visibleSize.height/2 + origin.y)); this->addChild(pSprite, 0); return true;}
addChild(CCNode* child,int zOrder)中参数zOrder指的是child的z轴顺序，也就是显示的先后顺序，其值越大，表示显示的位置就越靠前。
cocos2d-x没有API文档，但是自带了很多demo，就在cocos2d-x-2.2/samples目录下。
cocos2d-x的渲染树架构
任何可见的游戏元素都派生自Cocos2d-x节点（CCNode），常见的游戏元素有场景（CCScene）、层（CCLayer）和精灵（CCSprite）等。通常游戏按照场景、层、精灵的层次顺序组织。
动作（action）作用于游戏元素，可以使游戏元素运动起来。常见的动作有移动、转动、闪烁、消失等。动作分为持续性动作与瞬时动作，持续性动作在一段时间内连续完成，瞬时动作会瞬间完成。在Cocos2d-x中，动作由CCAction类实现，由CCAction类派生出持续性动作类CCAction Interval和瞬时动作类CCActionInstant。所有的动作都派生自以上两个类之一。
动画（animation）是一种特殊的持续性动作，它只能应用于精灵上，用于实现帧动画效果。静止的图片叫做帧（frame），帧的序列代表一个动画效果。
命名空间与类名称
Cocos2d-x拥有一个包含其他所有头文件的文件"cocos2d.h"。通常，我们只需要在使用时包含这个头文件，就可以使用引擎的全部功能了。如要使用扩展类，还需要包含"cocos2d-ext.h"。可使用引擎提供的一个宏USING_NS_CC来引用cocos2d命名空间。
Cocos2d-x不使用传统的值类型，所有的对象都创建在堆上，然后通过指针引用。创建Cocos2d-x对象通常有两种方法：第一种是首先使用new操作符创造一个未初始化的对象，然后调用init系列方法来初始化；第二种是使用静态的工厂方法直接创建一个对象。
CCSprite* sprite1 = new CCSprite();sprite1->initWithFile("HelloWorld.png");CCSprite* sprite2 = CCSprite::spriteWithFile("HelloWorld.png");CCSprite* sprite3 = CCSprite::create("HelloWorld.png");
选择器
schedule_selector(SELECTOR)callfunc_selector(SELECTOR)callfuncN_selector(SELECTOR)callfuncND_selector(SELECTOR)callfunc_selector(SELECTOR)menu_selector(SELECTOR)event_selector(SELECTOR)compare_selector(SELECTOR)属性和宏
为每一个属性编写一个或两个访问器方法是一项十分枯燥的任务，为了避免重复性的工作，Cocos2d-x提供了一系列宏来帮助我们方便地创建属性，它们定义在引擎目录中的"cocos2d/platform/CCPlatformMacros.h"中。
| 宏 | 描述 |
| CC_PROPERTY | 定义一个属性及其访问器，没有实现。 |
| CC_PROPERTY_READONLY | 定义一个属性，只包含get访问器，没有实现 |
| CC_PROPERTY_PASS_BY_REF | 定义一个属性，访问器使用引用类型传 |
| CC_PROPERTY_READONLY_PASS_BY_REF | 定义一个属性，只包含get访问器， |
| CC_SYNTHESIZE | 同CC_PROPERTY，实现了访问器方法 |
| CC_SYNTHESIZE_READONLY | 同CC_PROPERTY_READONLY，实现了访问器方法 |
| CC_SYNTHESIZE_READONLY_PASS_BY_REF | 同CC_PROPERTY_READONLY_PASS_BY_REF， |
| CC_SYNTHESIZE_RETAIN | 同CC_PROPERTY，实现了访问器方法。 |
CCPlatformMacros.h中宏源码
#define CREATE_FUNC(__TYPE__) static __TYPE__* create() { __TYPE__ *pRet = new __TYPE__(); if (pRet && pRet->init()) { pRet->autorelease(); return pRet; } else { delete pRet; pRet = NULL; return NULL; } }#define NODE_FUNC(__TYPE__) \CC_DEPRECATED_ATTRIBUTE static __TYPE__* node() { __TYPE__ *pRet = new __TYPE__(); if (pRet && pRet->init()) { pRet->autorelease(); return pRet; } else { delete pRet; pRet = NULL; return NULL; } }#define CC_PROPERTY_READONLY(varType, varName, funName)protected: varType varName;public: virtual varType get##funName(void);#define CC_PROPERTY_READONLY_PASS_BY_REF(varType, varName, funName)protected: varType varName;public: virtual const varType& get##funName(void);#define CC_PROPERTY(varType, varName, funName)protected: varType varName;public: virtual varType get##funName(void);public: virtual void set##funName(varType var);#define CC_PROPERTY_PASS_BY_REF(varType, varName, funName)protected: varType varName;public: virtual const varType& get##funName(void);public: virtual void set##funName(const varType& var);#define CC_SYNTHESIZE_READONLY(varType, varName, funName)protected: varType varName;public: virtual varType get##funName(void) const { return varName; }#define CC_SYNTHESIZE_READONLY_PASS_BY_REF(varType, varName, funName)protected: varType varName;public: virtual const varType& get##funName(void) const { return varName; }#define CC_SYNTHESIZE(varType, varName, funName)protected: varType varName;public: virtual varType get##funName(void) const { return varName; }public: virtual void set##funName(varType var){ varName = var; }#define CC_SYNTHESIZE_PASS_BY_REF(varType, varName, funName)protected: varType varName;public: virtual const varType& get##funName(void) const { return varName; }public: virtual void set##funName(const varType& var){ varName = var; }#define CC_SYNTHESIZE_RETAIN(varType, varName, funName) private: varType varName; public: virtual varType get##funName(void) const { return varName; } public: virtual void set##funName(varType var) { if (varName != var) { CC_SAFE_RETAIN(var); CC_SAFE_RELEASE(varName); varName = var; } } #define CC_SAFE_DELETE(p) do { if(p) { delete (p); (p) = 0; } } while(0)#define CC_SAFE_DELETE_ARRAY(p) do { if(p) { delete[] (p); (p) = 0; } } while(0)#define CC_SAFE_FREE(p) do { if(p) { free(p); (p) = 0; } } while(0)#define CC_SAFE_RELEASE(p) do { if(p) { (p)->release(); } } while(0)#define CC_SAFE_RELEASE_NULL(p) do { if(p) { (p)->release(); (p) = 0; } } while(0)#define CC_SAFE_RETAIN(p) do { if(p) { (p)->retain(); } } while(0)#define CC_BREAK_IF(cond) if(cond) break#define __CCLOGWITHFUNCTION(s, ...) \ CCLog("%s : %s",__FUNCTION__, CCString::createWithFormat(s, ##__VA_ARGS__)->getCString())// cocos2d debug#if !defined(COCOS2D_DEBUG) || COCOS2D_DEBUG == 0#define CCLOG(...) do {} while (0)#define CCLOGINFO(...) do {} while (0)#define CCLOGERROR(...) do {} while (0)#define CCLOGWARN(...) do {} while (0)#elif COCOS2D_DEBUG == 1#define CCLOG(format, ...) cocos2d::CCLog(format, ##__VA_ARGS__)#define CCLOGERROR(format,...) cocos2d::CCLog(format, ##__VA_ARGS__)#define CCLOGINFO(format,...) do {} while (0)#define CCLOGWARN(...) __CCLOGWITHFUNCTION(__VA_ARGS__)#elif COCOS2D_DEBUG > 1#define CCLOG(format, ...) cocos2d::CCLog(format, ##__VA_ARGS__)#define CCLOGERROR(format,...) cocos2d::CCLog(format, ##__VA_ARGS__)#define CCLOGINFO(format,...) cocos2d::CCLog(format, ##__VA_ARGS__)#define CCLOGWARN(...) __CCLOGWITHFUNCTION(__VA_ARGS__)#endif // COCOS2D_DEBUG