Cocos2d-x学习入门之HelloWorld程序

时间:2021-09-11 08:28:54

一、前言:

Cocos2d-x是目前非常流行的开源移动2D游戏框架。本文HelloWorld示例程序中使用的Cocos2d-x版本是2.0,主要实现一个简单的入门程序。

二、HelloWorld程序:

HelloWorld程序是很多编程语言的入门程序,对于程序员来说非常重要。
打开本文项目后可以看到AppDelegate.h/.cpp和HelloWorldScene.h/.cpp四个文件,比一般初学编程看到的HelloWorld要稍显复杂。

具体代码如下:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
#include "AppDelegate.h"
#include "HelloWorldScene.h"
USING_NS_CC;
AppDelegate::AppDelegate() {
}
AppDelegate::~AppDelegate() 
{
}
bool AppDelegate::applicationDidFinishLaunching() {
  // 初始化CCDirector对象
  CCDirector* pDirector = CCDirector::sharedDirector();
  // 初始化CCEGLView对象,CCEGLView是显示窗口,负责窗口级别的功能管理和实现,包括坐标和缩放管理、画图工具、按键事件
  CCEGLView* pEGLView = CCEGLView::sharedOpenGLView();
  // 将pEGLView传递给pDirector
  pDirector->setOpenGLView(pEGLView);
  // 打开状态显示,包括FPS等
  pDirector->setDisplayStats(true);
  // 设置FPS,每秒刷新多少帧画面,默认是1秒60帧,帧数越高画面越流畅,但也越耗电
  pDirector->setAnimationInterval(1.0 / 60);
  // 创建一个HelloWorld场景,能够自动释放
  CCScene *pScene = HelloWorld::scene();
  // 运行HelloWorld场景
  pDirector->runWithScene(pScene);
  return true;
}
// 来电或者应用进入手机后台将调用此方法
void AppDelegate::applicationDidEnterBackground() {
  // 停止所有动画
  CCDirector::sharedDirector()->stopAnimation();
  // 如果使用了SimpleAudioEngine(控制背景音乐等),在此处调用暂停
  // SimpleAudioEngine::sharedEngine()->pauseBackgroundMusic();
}
// 当应用从后台恢复至前台将调用此方法
void AppDelegate::applicationWillEnterForeground() {
  // 恢复所有动画
  CCDirector::sharedDirector()->startAnimation();
  // 在此处调用SimpleAudioEngine的恢复
  // SimpleAudioEngine::sharedEngine()->resumeBackgroundMusic();
}

AppDelegate对Cocos2d-x引擎进行了初始化,并对进行一些全局性的设置。
但是在这个里面并没有看到具体的界面实现,因为界面实现都在HelloWorldScene中。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
#include "HelloWorldScene.h"
USING_NS_CC;
CCScene* HelloWorld::scene()
{
  // 创建一个Scene
  CCScene *scene = CCScene::create();
   
  // 创建一个HelloWorld的图层(HelloWorld继承自CCLayer)
  HelloWorld *layer = HelloWorld::create();
 
  // 将创建的HelloWorld图层添加至之前创建的场景中
  scene->addChild(layer);
 
  // 返回创建的场景
  return scene;
}
 
// on "init" you need to initialize your instance
bool HelloWorld::init()
{
  /////////////////////////////
  // 1. 调用父类的初始化,如果初始化失败,则不会继续往下执行
  if ( !CCLayer::init() )
  {
    // 返回false表示初始化失败
    return false;
  }
  //获取可显示区域大小
  CCSize visibleSize = CCDirector::sharedDirector()->getVisibleSize();
  //获取可显示区域坐标起点
  CCPoint origin = CCDirector::sharedDirector()->getVisibleOrigin();
  /////////////////////////////
  // 2. 添加一个可点击的菜单按钮,点击后关闭程序
  // 创建一个图片菜单选项
  CCMenuItemImage *pCloseItem = CCMenuItemImage::create(// 调用创建方法
                    "CloseNormal.png",// 设置未点击时菜单图片
                    "CloseSelected.png",// 设置点击时候菜单图片
                    this,// ?这个参数是什么
                    menu_selector(HelloWorld::menuCloseCallback));// 设置菜单点击时间的回调监听
  // 设置菜单的位置坐标,pCloseItem->getContentSize()用来获取菜单选项大小
  pCloseItem->setPosition(ccp(origin.x + visibleSize.width - pCloseItem->getContentSize().width/2 ,
                origin.y + pCloseItem->getContentSize().height/2));
  // 创建菜单(菜单选项需要添加到菜单里才能使用),create函数中可以添加多个菜单选项,以NULL结束添加
  CCMenu* pMenu = CCMenu::create(pCloseItem, NULL);
  // 设置菜单的坐标(CCPointZero是坐标(0,0))
  pMenu->setPosition(CCPointZero);
  // 将菜单添加至HelloWorld图层中,1是菜单在HelloWorld图层中Z轴位置,数值越大,显示的层级越高,不易被遮挡
  this->addChild(pMenu, 1);
  /////////////////////////////
  // 3. 添加文字控件和背景图片
  // 创建一个文件控件,create函数中参数分别是“控件需要显示的文字”,“控件文字字体”,“控件文字字号”
  CCLabelTTF* pLabel = CCLabelTTF::create("Hello World", "Arial", 24);
  // 设置文件控件位置(此公式计算的位置为屏幕*)
  pLabel->setPosition(ccp(origin.x + visibleSize.width/2,
              origin.y + visibleSize.height - pLabel->getContentSize().height));
  // 将文字控件添加至HelloWorld图层中
  this->addChild(pLabel, 1);
  // 创建一个精灵(后续将介绍精灵的具体用处,这里精灵是背景图片的载体)
  CCSprite* pSprite = CCSprite::create("HelloWorld.png");
 
  // 设置背景图片位置(此公式计算的位置为屏幕*)
  pSprite->setPosition(ccp(visibleSize.width/2 + origin.x, visibleSize.height/2 + origin.y));
  // 将背景图片添加至HelloWorld图层中,并设置Z轴为0,置于菜单和文字之下
  this->addChild(pSprite, 0);
  // 返回true表示初始化成功
  return true;
}
// 关闭按钮的回调函数,pSender传递的是调用了该函数的对象
void HelloWorld::menuCloseCallback(CCObject* pSender)
{
// 宏定义,判断是否是WinRT或者WP8设备
#if (CC_TARGET_PLATFORM == CC_PLATFORM_WINRT) || (CC_TARGET_PLATFORM == CC_PLATFORM_WP8)
  // 弹出对话框,提示文字信息
  CCMessageBox("You pressed the close button. Windows Store Apps do not implement a close button.","Alert");
#else
  // 调用CCDirector的end()函数,结束游戏
  CCDirector::sharedDirector()->end();
// 宏定义,判断是否是IOS设备
#if (CC_TARGET_PLATFORM == CC_PLATFORM_IOS)
  // 直接调用exit(0)结束游戏
  exit(0);
#endif
#endif
}

HelloWorldScene文件是整个HelloWorld工程的核心,从代码中我们不难发现,在Cocos2d-x的坐标系计算中,默认将屏幕左下角设置为坐标原点,向上方和右方递增Y轴X轴。而设置控件位置的时候,是以控件的中心为锚点,当然,锚点是可以通过代码改变的,这里我们需要调用setAnchorPoint()函数。

希望本文所述实例对于大家学习Cocos2d-x能起到一定的帮助作用。