cocos2d-x-3.2 cpp-empty-test代码注释

cocos2d-x-3.2 cpp-empty-test代码注释

AppDelegate.cpp

#include "AppDelegate.h"

#include <vector>
#include <string>

#include "HelloWorldScene.h"
#include "AppMacros.h"

USING_NS_CC;
using namespace std;

AppDelegate::AppDelegate() {

}

AppDelegate::~AppDelegate() 
{
}
// 程序初始化函数 
bool AppDelegate::applicationDidFinishLaunching() {
    // initialize director
    auto director = Director::getInstance();    // 取得设备  
    auto glview = director->getOpenGLView();    // 取得OpenGL窗口  
    if(!glview) {
        // 如果为空，则创建以" Cpp Empty Test"为窗口标题的窗口。 
        glview = GLView::create("Cpp Empty Test");
        // 设置设备使用的窗口，此句可以去掉。 
        director->setOpenGLView(glview);
    }
    // 设置设备使用的窗口。 
    director->setOpenGLView(glview);

    // Set the design resolution
    // 如果是WP8平台，设置分辩率
#if (CC_TARGET_PLATFORM == CC_PLATFORM_WP8)
    // a bug in DirectX 11 level9-x on the device prevents ResolutionPolicy::NO_BORDER from working correctly
    // 在WP8上跑DX11，使用ResolutionPolicy::NO_BORDER模式设置分辩率会有一个BUG，这里改为ResolutionPolicy::SHOW_ALL模式。  
    glview->setDesignResolutionSize(designResolutionSize.width, designResolutionSize.height, ResolutionPolicy::SHOW_ALL);
#else
    glview->setDesignResolutionSize(designResolutionSize.width, designResolutionSize.height, ResolutionPolicy::NO_BORDER);
#endif

    // 取得了视窗的大小  
    Size frameSize = glview->getFrameSize();
    
    vector<string> searchPath;



    //根据视窗大小与分辩率的大小选择相应的资源目录。  

    // In this demo, we select resource according to the frame's height.
    // If the resource size is different from design resolution size, you need to set contentScaleFactor.
    // We use the ratio of resource's height to the height of design resolution,
    // this can make sure that the resource's height could fit for the height of design resolution.

    // if the frame's height is larger than the height of medium resource size, select large resource.
    // ipadhd  
    if (frameSize.height > mediumResource.size.height)
    {
        searchPath.push_back(largeResource.directory);

        director->setContentScaleFactor(MIN(largeResource.size.height/designResolutionSize.height, largeResource.size.width/designResolutionSize.width));
    }
    // if the frame's height is larger than the height of small resource size, select medium resource.
    // ipad 
    else if (frameSize.height > smallResource.size.height)
    {
        searchPath.push_back(mediumResource.directory);
        
        director->setContentScaleFactor(MIN(mediumResource.size.height/designResolutionSize.height, mediumResource.size.width/designResolutionSize.width));
    }
    // if the frame's height is smaller than the height of medium resource size, select small resource.
    // iphone
    else
    {
        searchPath.push_back(smallResource.directory);

        director->setContentScaleFactor(MIN(smallResource.size.height/designResolutionSize.height, smallResource.size.width/designResolutionSize.width));
    }
    
    // set searching path
    // 设置资源目录  
    FileUtils::getInstance()->setSearchPaths(searchPath);
    
    // turn on display FPS
    director->setDisplayStats(true);    // 打开FPS显示 

    // set FPS. the default value is 1.0/60 if you don't call this
    director->setAnimationInterval(1.0 / 60);    // 设置每秒60帧  

    // create a scene. it's an autorelease object
    auto scene = HelloWorld::scene();    // 创建HelloWorld场景 

    // run
    director->runWithScene(scene);    // 运行场景 

    return true;
}

// This function will be called when the app is inactive. When comes a phone call,it's be invoked too
// 当收到电话时，游戏转入后台服务，响应这句 
void AppDelegate::applicationDidEnterBackground() {
    Director::getInstance()->stopAnimation();

    // if you use SimpleAudioEngine, it must be pause
    // 如果使用声音，下面可以用这句代码暂停  
    // SimpleAudioEngine::sharedEngine()->pauseBackgroundMusic();
}

// this function will be called when the app is active again
// 当电话完成，选择恢复游戏时，响应这句 
void AppDelegate::applicationWillEnterForeground() {
    Director::getInstance()->startAnimation();

    // if you use SimpleAudioEngine, it must resume here
    // 如果使用声音，下面可以用这句代码恢复  
    // SimpleAudioEngine::sharedEngine()->resumeBackgroundMusic();
}

HelloWorldScene.h

#ifndef __HELLOWORLD_SCENE_H__
#define __HELLOWORLD_SCENE_H__

#include "cocos2d.h"

class HelloWorld : public cocos2d::Layer
{
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
    // 静态函数创建Scene  
    static cocos2d::Scene* scene();
    
    // a selector callback
    // 响应按钮退出程序
    void menuCloseCallback(Ref* sender);
    
    // implement the "static node()" method manually
    // 增加一个静态的create函数来创建实例。
    CREATE_FUNC(HelloWorld);
};

#endif // __HELLOWORLD_SCENE_H__

HelloWorldScene.cpp

#include "HelloWorldScene.h"
#include "AppMacros.h"

// 使用Cocos2d-x命名空间  
USING_NS_CC;

// 静态函数创建场景  
Scene* HelloWorld::scene()
{
    // 'scene' is an autorelease object
    // 创建一个Scene，即宇宙
    auto scene = Scene::create();
    
    // 'layer' is an autorelease object
    // 创建一个Layer，即地球  
    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
// 初始化  
bool HelloWorld::init()
{
    //////////////////////////////
    // 1. super init first
    // 先进行初始化  
    if ( !Layer::init() )
    {
        return false;
    }
    // 取得分辩率的大小及原点坐标 
    auto visibleSize = Director::getInstance()->getVisibleSize();
    auto origin = Director::getInstance()->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
    // 创建一个菜单项，它由两张图片来表现普通状态和按下状态，设置按下时调用menuCloseCallback函数响应关闭  
    auto closeItem = MenuItemImage::create(
                                        "CloseNormal.png",
                                        "CloseSelected.png",
                                        CC_CALLBACK_1(HelloWorld::menuCloseCallback,this));
    
    closeItem->setPosition(origin + Vec2(visibleSize) - Vec2(closeItem->getContentSize() / 2));

    // create menu, it's an autorelease object
    // 由菜单项创建菜单.
    auto menu = Menu::create(closeItem, NULL);
    menu->setPosition(Vec2::ZERO);
    this->addChild(menu, 1);
    
    /////////////////////////////
    // 3. add your codes below...

    // add a label shows "Hello World"
    // create and initialize a label
    // 创建一个文字标签  
    auto label = LabelTTF::create("Hello World", "Arial", TITLE_FONT_SIZE);
    
    // position the label on the center of the screen
    // 设置居中显示
    label->setPosition(Vec2(origin.x + visibleSize.width/2,
                            origin.y + visibleSize.height - label->getContentSize().height));

    // add the label as a child to this layer
    // 将文字标签放到当前Layer中。 
    this->addChild(label, 1);

    // add "HelloWorld" splash screen"
    // 增加一个图片精灵 
    auto sprite = Sprite::create("HelloWorld.png");

    // position the sprite on the center of the screen
    // 设置居中显示  
    sprite->setPosition(Vec2(visibleSize / 2) + origin);

    // add the sprite as a child to this layer
    // 将Sprite放到当前Layer中。
    this->addChild(sprite);
    
    return true;
}

// 响应菜单按下时的事件处理  
void HelloWorld::menuCloseCallback(Ref* sender)
{
    // 如果是WP8平台，弹出消息框提示一下。  
#if (CC_TARGET_PLATFORM == CC_PLATFORM_WP8) || (CC_TARGET_PLATFORM == CC_PLATFORM_WINRT)
    MessageBox("You pressed the close button. Windows Store Apps do not implement a close button.","Alert");
    return;
#endif
    // 否则，终止程序。  
    Director::getInstance()->end();

    // 退出程序  
#if (CC_TARGET_PLATFORM == CC_PLATFORM_IOS)
    exit(0);
#endif
}