cocos2d-x 2.1.4学习笔记之HelloWorld分析

下面截图是HelloWorld项目下的文件夹结构

这是用python命令生成的项目，在创建过程中默认生成多个平台的程序文件。

1.“resource”文件夹

该文件夹主要用于存放游戏中需要的图片、音频和配置等资源文件。为了方便管理，可以在其中创建子文件夹。在不同平台下，对于文件路径的定义是不一致的，但实际接口大同小异。Cocos2d-x为我们屏蔽了这些差异，其中“resource”文件夹可以默认为游戏运行时的目录。

2.proj.win32文件夹

“main.h”、“main.cpp” 用于放置游戏头文件，它们是平台相关的程序文件，为Windows专有。通常情况下，程序入口与资源文件管理在不同平台下是不同的，但是Cocos2d-x的模板已经基本为我们处理好了这些细节，不需要对它们进行修改。

3.Classes文件夹

该文件夹里面存放的是项目所有的.h和.cpp文件。自然也包含了“AppDelegate.h”和“AppDelegate.cpp”文件。这两个文件是Cocos2d-x游戏的通用入口文件，类似于一般Windows工程中主函数所在的文件。

打开“AppDelegate.cpp”，我们可以看到已经自动添加的代码，这个文件实现了AppDelegate类。AppDelegate控制着游戏的生命周期，除去构造函数和析构函数外，共有3个方法，下面逐个介绍。

AppDelegate.h

#ifndef  _APP_DELEGATE_H_
#define  _APP_DELEGATE_H_

#include "cocos2d.h"

/**
@brief    The cocos2d Application.
The reason for implement as private inheritance is to hide some interface call by CCDirector.
*/
class  AppDelegate : private cocos2d::CCApplication {
public:
    AppDelegate();
    virtual ~AppDelegate();

    /**
    @brief    Implement CCDirector and CCScene init code here.
    @return true    Initialize success, app continue.
    @return false   Initialize failed, app terminate.
    */
    virtual bool applicationDidFinishLaunching();

    /**
    @brief  The function be called when the application enter background
    @param  the pointer of the application
    */
    virtual void applicationDidEnterBackground();

    /**
    @brief  The function be called when the application enter foreground
    @param  the pointer of the application
    */
    virtual void applicationWillEnterForeground();
};

#endif // _APP_DELEGATE_H_

 

AppDelegate.cpp

   1:  #include "AppDelegate.h"

   2:  #include "HelloWorldScene.h"

   3:   

   4:  USING_NS_CC;

   5:   

   6:  AppDelegate::AppDelegate() {

   7:  }

   8:   

   9:  AppDelegate::~AppDelegate() {

  10:  }

  11:   

  12:  bool AppDelegate::applicationDidFinishLaunching() {

  13:      //初始化游戏引擎控制器CCDirector，以便启动游戏引擎;

  14:      CCDirector* pDirector = CCDirector::sharedDirector();

  15:      CCEGLView* pEGLView = CCEGLView::sharedOpenGLView();  16:   

  17:      pDirector->setOpenGLView(pEGLView);

  18:   

  19:      //启用FPS显示

  20:      pDirector->setDisplayStats(true);  21:   

  22:      // 设置绘制间隔(FPS); the default value is 1.0/60 if you don't call this

  24:      pDirector->setAnimationInterval(1.0 / 60);

  25:   

  26:      // create a scene. it's an autorelease object

  27:      CCScene *pScene = HelloWorld::scene();

  28:      // run

  29:      pDirector->runWithScene(pScene);

  30:      return true;

  31:  }

  32:   

  33:  // This function will be called when the app is inactive. When comes a phone call,it's be invoked too

  34:  //当应用程序将要进入后台时，会调用这个方法。

  35:  //具体来说，当用户把程序切换到后台，或手机接到电话或短信后程序被系统切换到后台时，会调用这个方法。

  36:  //此时，应该暂停游戏中正在播放的音乐或音效。

  37:  //动作激烈的游戏通常也应该在此时进行暂停操作，以便玩家暂时离开游戏时不会遭受重大损失。

  38:  void AppDelegate::applicationDidEnterBackground() {

  39:      CCDirector::sharedDirector()->stopAnimation();

  40:      // if you use SimpleAudioEngine, it must be pause

  41:      // SimpleAudioEngine::sharedEngine()->pauseBackgroundMusic();

  42:  }

  43:   

  44:  // this function will be called when the app is active again

  45:  //该方法与applicationDidEnterBackground()成对出现，在应用程序回到前台时被调用。相对地，我们通常在这里继续播放刚才暂停的音乐，显示游戏暂停菜单等。

  46:  void AppDelegate::applicationWillEnterForeground() {

  47:      CCDirector::sharedDirector()->startAnimation();

  48:      // if you use SimpleAudioEngine, it must resume here

  49:      // SimpleAudioEngine::sharedEngine()->resumeBackgroundMusic();

  50:  }

  51:   

  52:  //FPS即每秒帧速率，也就是屏幕每秒重绘的次数。启用了FPS显示后，当前FPS会在游戏的左下角显示。通常在游戏开发阶段，我们会启用FPS显示，这样就可以方便地确定游戏运行是否流畅。

  54:  //绘制间隔指的是两次绘制的时间间隔，因此绘制间隔的倒数就是FPS上限。

  55:  //对于移动设备来说，我们通常都会将FPS限制在一个适当的范围内。

  56:  //过低的每秒重绘次数会使动画显示出卡顿的现象，而提高每秒重绘次数会导致设备运算量大幅增加，造成更高的能耗。

  57:  //人眼的刷新频率约为60次每秒，因此把FPS限定在60是一个较为合理的设置，Cocos2d-x就把绘制间隔设置为1/60秒。

  58:  //至此，我们已经完成了引擎的初始化，接下来我们将启动引擎;

HelloWorldScene.h

#ifndef __HELLOWORLD_SCENE_H__
#define __HELLOWORLD_SCENE_H__

#include "cocos2d.h"

class HelloWorld : public cocos2d::CCLayer {
public:
    // Here's a difference. Method 'init' in cocos2d-x returns bool, instead of returning 'id' in cocos2d-iphone
    virtual bool init();

    // there's no 'id' in cpp, so we recommend returning the class instance pointer
    //在Cocos2d中，在层下设置一个创建场景的静态函数是一个常见的技巧
    static cocos2d::CCScene* scene();

    // a selector callback
    void menuCloseCallback(CCObject* pSender);

    // implement the "static node()" method manually
    CREATE_FUNC(HelloWorld);
};

#endif // __HELLOWORLD_SCENE_H__

HelloWorldScene.cpp

#include "HelloWorldScene.h"

USING_NS_CC;

CCScene* HelloWorld::scene() {
    // 'scene' is an autorelease object
    CCScene *scene = CCScene::create();
    // 'layer' is an autorelease object
    HelloWorld *layer = HelloWorld::create();
    // add layer as a child to scene
    scene->addChild(layer);
    // return the scene
    return scene;
}

// on "init" you need to initialize your instance
//为什么我们要在一个实例方法中初始化类，而不在构造函数中初始化呢？在C++中，一般习惯在构造函数中初始化类，然而由于Cocos2d-x的来源特殊，所以才没有采用C++的编程风格
//对父类进行初始化
bool HelloWorld::init() {
    //////////////////////////////
    // 1. super init first
    if ( !CCLayer::init() ) {
        return false;
    }

    CCSize visibleSize = CCDirector::sharedDirector()->getVisibleSize();
    CCPoint origin = CCDirector::sharedDirector()->getVisibleOrigin();

    /////////////////////////////
    // 2. add a menu item with "X" image, which is clicked to quit the program
    //    you may modify it.

    // add a "close" icon to exit the progress. it's an autorelease object
    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));

    // create menu, it's an autorelease object
    CCMenu* pMenu = CCMenu::create(pCloseItem, NULL);
    pMenu->setPosition(CCPointZero);
    this->addChild(pMenu, 1);
    //addChild(CCNode* child,int zOrder)，参数zOrder指的是child的z轴顺序，也就是显示的先后顺序，其值越大，表示显示的位置就越靠前

    ///////////////////////////
     //3. add your codes below...
     //add a label shows "Hello World"
     //create and initialize a label
   CCLabelTTF* plabel = CCLabelTTF::create("hello world", "Arial", 24);
    //position the label on the center of the screen
   plabel->setPosition(ccp(origin.x + visibleSize.width/2,origin.y + visibleSize.height - plabel->getContentSize().height));
    //add the label as a child to this layer
   this->addChild(plabel, 1);

    //add "helloworld" splash screen"
   CCSprite* psprite = CCSprite::create("helloworld.png");
    //position the sprite on the center of the screen
   psprite->setPosition(ccp(visibleSize.width/2 + origin.x, visibleSize.height/2 + origin.y));
    //add the sprite as a child to this layer
   this->addChild(psprite, 0);
    return true;
}


void HelloWorld::menuCloseCallback(CCObject* pSender) {
    CCDirector::sharedDirector()->end();
    #if (CC_TARGET_PLATFORM == CC_PLATFORM_IOS)
         exit(0);
    #endif
}