重点关注函数:
initInstance
()。
- #ifndef _APP_DELEGATE_H_
- #define _APP_DELEGATE_H_
- #include "CCApplication.h"
- class AppDelegate : private cocos2d::CCApplication
- {
- public:
- //构造函数
- AppDelegate();
- //析构函数
- virtual ~AppDelegate();
- //重载初始化函数
- virtual bool initInstance();
- //重载应用程序启动后调用的处理函数
- virtual bool applicationDidFinishLaunching();
- //重载应用程序转入后台时调用的函数
- virtual void applicationDidEnterBackground();
- //重载应用程序恢复前台时调用的函数
- virtual void applicationWillEnterForeground();
- };
- #endif // _APP_DELEGATE_H_
再来看cpp文件
- #include "AppDelegate.h"
- //加入cocos2d头文件
- #include "cocos2d.h"
- #include "HelloWorldScene.h"
- //加入OpenGL窗口类
- #include "CCEGLView.h"
- //使用cocos2d命名空间
- USING_NS_CC;
- //构造函数
- AppDelegate::AppDelegate() {
- }
- //析构函数
- AppDelegate::~AppDelegate() {
- }
- //初始化函数,解答伏笔1
- bool AppDelegate::initInstance()
- {
- //定义一个bool返回值用于判断是否正常初始化
- bool bRet = false;
- do {
- //通过对宏定义的匹配来判断当前编译的代码的目标平台是什么,在这里可以知道Cocos2d-x的跨平台都支持哪些平台。我们的教程只针对WIN32平台部分做讲解,其它平台大家可以自行参考WIN32平台部分进行学习。
- //第一种平台类型,WIN32系统
- #if (CC_TARGET_PLATFORM == CC_PLATFORM_WIN32)
- // 创建并初始化OpenGL窗口管理实例对象,注意这里使用的是new来动态实例化的。当程序退出时会通过显示设备的release函数进行对窗口的释放。【伏笔3后面会有讲解】。
- CCEGLView * pMainWnd = new CCEGLView();
- //CC_BREAK_IF宏的意思是如果括号中的语句为否则中断循环。配合do_while流程使用。
- //可以看到这里的意思是,如果pMainWnd实例化失败或者pMainWnd创建窗口失败则中断循环。在这里硬性的设定了窗口的标题和窗口的宽度高度。
- CC_BREAK_IF(! pMainWnd
- || ! pMainWnd->Create(TEXT("cocos2d: Hello World"), 480, 320));
- #endif // CC_PLATFORM_WIN32
- //第二种平台类型,IOS类型
- #if (CC_TARGET_PLATFORM == CC_PLATFORM_IOS)
- #endif // CC_PLATFORM_IOS
- //第三种平台类型,ANDORID类型
- #if (CC_TARGET_PLATFORM == CC_PLATFORM_ANDROID)
- #endif // CC_PLATFORM_ANDROID
- //第四种平台,WOPHONE平台
- #if (CC_TARGET_PLATFORM == CC_PLATFORM_WOPHONE)
- #endif // CC_PLATFORM_WOPHONE
- //第五种平台,MARMALADE
- #if (CC_TARGET_PLATFORM == CC_PLATFORM_MARMALADE)
- #endif
- //第六种平台,LINUX
- #if (CC_TARGET_PLATFORM == CC_PLATFORM_LINUX)
- #endif // CC_PLATFORM_LINUX
- //第七种平台,BADA
- #if (CC_TARGET_PLATFORM == CC_PLATFORM_BADA)
- #endif // CC_PLATFORM_BADA
- //第八种平台,QNX
- #if (CC_TARGET_PLATFORM == CC_PLATFORM_QNX)
- #endif // CC_PLATFORM_QNX
- //如果没有被中断,则成功完成初始化。
- bRet = true;
- //退出循环
- } while (0);
- return bRet;
- }
- //重载应用程序启动后调用的处理函数
- bool AppDelegate::applicationDidFinishLaunching() {
- //通过CCDirector的静态函数sharedDirector来获取单件显示设备管理器指针
- CCDirector *pDirector = CCDirector::sharedDirector();
- //通过CCEGLView的静态函数sharedOpenGLView来获取单件管理实例对象并将其地址通过CCDirector的成员函数setOpenGLView传递给显示设备管理器。
- pDirector->setOpenGLView(&CCEGLView::sharedOpenGLView());
- //打开使用高清模式,这里给屏蔽了,如未来有需要可以打开。但是在设计程序时需要考虑到打开后对于位置的影响并提前制定相应的设计方案。
- //pDirector->enableRetinaDisplay(true);
- // 打开显示FPS
- pDirector->setDisplayFPS(true);
- // 设置当前屏幕的摆放方向,这里给屏蔽了。
- // pDirector->setDeviceOrientation(kCCDeviceOrientationLandscapeLeft);
- // 设置FPS的帧间隔时间差为60分之一秒,从而期望FPS为60帧。
- pDirector->setAnimationInterval(1.0 / 60);
- //通过HelloWorld的静态函数scene()创建返回一个场景实例
- CCScene *pScene = HelloWorld::scene();
- //运行这个场景
- pDirector->runWithScene(pScene);
- return true;
- }
- //重载应用程序转入后台时调用的函数,如电话打进来
- void AppDelegate::applicationDidEnterBackground() {
- //暂停显示设备的渲染处理
- CCDirector::sharedDirector()->pause();
- // 如果使用了声音引擎,这里进行暂停设置。否则会影响到通话,因为暂时没用到,所以屏蔽
- // SimpleAudioEngine::sharedEngine()->pauseBackgroundMusic();
- }
- //重载应用程序恢复前台时调用的函数
- void AppDelegate::applicationWillEnterForeground() {
- //恢复显示设备的渲染处理
- CCDirector::sharedDirector()->resume();
- //如果使用了声音引擎,这里进行恢复设置
- // SimpleAudioEngine::sharedEngine()->resumeBackgroundMusic();
- }
在InitInstance函数中,我们看到Cocos2d-x将Windows窗口的创建与控制都封装到了CCEGLView类中。它已经暴露出一个Create函数,做为一个求知者,我们应该迫不及待的想要看到它在哪里创建窗口。继续追进去吧!GoGoGo!
我们进入了CCEGLView_win32.h,通过文件名可以知道CCEGLView类应该有多个平台的版本。我们暂不理它。看一下Create函数。
//
- bool CCEGLView::Create(LPCTSTR pTitle, int w, int h)
- {
- //定义一个bool型返回值
- bool bRet = false;
- do
- {
- //检测窗口句柄是否已经存在。确保只创建一个窗口
- CC_BREAK_IF(m_hWnd);
- //进入到这里,我们应该很高兴了。没错,终于找到了创建窗口的代码。
- HINSTANCE hInstance = GetModuleHandle( NULL );
- WNDCLASS wc;// 窗口类
- // 设置相关参数
- wc.style = CS_HREDRAW | CS_VREDRAW | CS_OWNDC;
- wc.lpfnWndProc = _WindowProc;// 本窗口使用的WINDOWS消息处理函数
- wc.cbClsExtra = 0;
- wc.cbWndExtra = 0;
- wc.hInstance = hInstance;
- wc.hIcon = LoadIcon( NULL, IDI_WINLOGO );
- wc.hCursor = LoadCursor( NULL, IDC_ARROW );
- wc.hbrBackground = NULL;
- wc.lpszMenuName = NULL;
- wc.lpszClassName = kWindowClassName;
- //注册窗口类,如果失败则判断失败原因是否是此类别已存在(错误码1410),如果是因为此类存在而导致失败,则仍然可以继续。
- CC_BREAK_IF(! RegisterClass(&wc) && 1410 != GetLastError());
- // 取得窗口的窗体矩形
- RECT rcDesktop;
- GetWindowRect(GetDesktopWindow(), &rcDesktop);
- // 调用创建口函数
- m_hWnd = CreateWindowEx(
- WS_EX_APPWINDOW | WS_EX_WINDOWEDGE,
- kWindowClassName,// 之前注册的窗口类
- pTitle,// 窗口标题
- WS_CAPTION | WS_POPUPWINDOW | WS_MINIMIZEBOX,// 窗体样式
- 0, 0, // 窗体位置
- 0, // 窗体宽度
- 0, // 窗体高度
- NULL,// 无父窗口
- NULL,// 无菜单
- hInstance,// 程序句柄
- NULL );
- //判断窗口是否创建成功
- CC_BREAK_IF(! m_hWnd);
- //取得显示设备的摆放方向
- m_eInitOrientation = CCDirector::sharedDirector()->getDeviceOrientation();
- //通过对摆放方向的判断得出水平还是垂直
- m_bOrientationInitVertical = (CCDeviceOrientationPortrait == m_eInitOrientation
- || kCCDeviceOrientationPortraitUpsideDown == m_eInitOrientation) ? true : false;
- m_tSizeInPoints.cx = w;
- m_tSizeInPoints.cy = h;
- //设置窗口大小
- resize(w, h);
- // 使用此窗口进行OpenGL的设置
- m_pEGL = CCEGL::create(this);
- // 如果OpenGL创建失败,销毁窗体并中断
- if (! m_pEGL)
- {
- DestroyWindow(m_hWnd);
- m_hWnd = NULL;
- break;
- }
- //将静态指针设置为当前实例对象。
- s_pMainWindow = this;
- bRet = true;
- } while (0);
- return bRet;
- }
在注册类时,设定了窗口的消息处理回调函数为_WinDowProc,我们继续追入看一下程序退出时在哪里释放了Opengl窗口实例对象。呵呵,还记得前面我们埋下的伏笔3,它是用new创建出来的。而new出来的内存必须释放。程序退出会销毁窗体,消息处理函数会先后收到WM_CLOSE和WM_DESTROY。我们找一下。
- static LRESULT CALLBACK _WindowProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
- {
- //如果OpenGL窗体初始化完成,则由OpenGL窗体进行消息处理,否则由WINDOWS系统进行默认处理
- if (s_pMainWindow && s_pMainWindow->getHWnd() == hWnd)
- {
- return s_pMainWindow->WindowProc(uMsg, wParam, lParam);
- }
- else
- {
- return DefWindowProc(hWnd, uMsg, wParam, lParam);
- }
- }
继续。
- LRESULT CCEGLView::WindowProc(UINT message, WPARAM wParam, LPARAM lParam)
- {
- PAINTSTRUCT ps;
- switch (message)
- {…//其它消息暂不理,可自行分析
- case WM_PAINT:
- //这里是刷新屏幕,因为使用了OpenGL来进行绘制,所以这里不作任何处理。
- BeginPaint(m_hWnd, &ps);
- EndPaint(m_hWnd, &ps);
- break;
- case WM_CLOSE:
- //调用单件显示设备管理器的end函数关闭窗口
- CCDirector::sharedDirector()->end();
- break;
- case WM_DESTROY:
- //向消息循环发送WM_QUIT消息退出程序
- PostQuitMessage(0);
- break;
- default:
- return DefWindowProc(m_hWnd, message, wParam, lParam);
- }
- return 0;
- }
进入显示设备管理器CCDirector的end函数。
- void CCDirector::end()
- {
- m_bPurgeDirecotorInNextLoop = true;
- }
倒!这里只是设置成员变量m_bPurgeDirecotorInNextLoop为true,没有什么delete。怎么回事呢?
好吧,继续分析,成员变量的名字意思是“是否在下一个循环时清除显示设备”。哦。也就是说这只是一个开关。在循环函数中判断它是否为true来清除显示设备。打开mainLoop函数。解答伏笔2
- void CCDisplayLinkDirector::mainLoop(void)
- {//如果清除显示设备开关为true
- if (m_bPurgeDirecotorInNextLoop)
- {
- //清楚设备
- purgeDirector();
- m_bPurgeDirecotorInNextLoop = false;
- }//否则判断显示设备是否有效
- else if (! m_bInvalid)
- {
- //如果有效,绘制场景
- drawScene();
-
- //调用内存管理器释放其管理的内存
- CCPoolManager::getInstance()->pop();
- }
- }
马上要接晓答案了
- void CCDirector::purgeDirector()
- {
- …//其它暂不理。有兴趣的朋友请自行分析
- // 调用Opengl窗口管理实例对象的release函数进行释放。
- m_pobOpenGLView->release();
- m_pobOpenGLView = NULL;
- }
进入OpenGL窗口管理类的release函数
- void CCEGLView::release()
- {//销毁窗体
- if (m_hWnd)
- {
- DestroyWindow(m_hWnd);
- m_hWnd = NULL;
- }
- s_pMainWindow = NULL;
- //注销所使用的窗口类
- UnregisterClass(kWindowClassName, GetModuleHandle(NULL));
- //释放使用到的指针
- CC_SAFE_DELETE(m_pSet);
- CC_SAFE_DELETE(m_pTouch);
- CC_SAFE_DELETE(m_pDelegate);
- CC_SAFE_DELETE(m_pEGL);
- //关键点:在最后释放了自已在AppDelegate::initInstance()中通过new创建对象而占用的内存。
- delete this;
- }
现在我们了解了Cocos2d-x是如何将WINDOWS程序基本框架封装在自已的类之中的。运行一下程序,可们可以看到弹出的窗口显示出HelloWorld的画面。而当初复杂的WINDOWS程序基本框架。在这里只化为简单的一句run()。非常简洁!
这个运行中的窗口,没有最大化系统按钮,窗体大小也被固定在480x320。我们希望能够更灵活的设置窗口的标题和大小。那我们必须要做一些改动。即然已经看懂了代码,下面就亲自实习一下吧。
打开AppDelegate的initInstance函数,增加相应的参数。
- bool AppDelegate::initInstance(LPCTSTR szTitle,UINT wWidth,UINT wHeight)
并改动下面一句
- CC_BREAK_IF(! pMainWnd
- //改成由函数参数来创建OpenGL窗体
- || ! pMainWnd->Create(szTitle, wWidth, wHeight));
- //|| ! pMainWnd->Create(TEXT("cocos2d: Hello World"), 480, 320));
然后我们打开CCApplication_win32.cpp,找到run函数。做同样的修改。
- int CCApplication::run(LPCTSTR szTitle,UINT wWidth,UINT wHeight)
并改动下面一句
- if (! initInstance(szTitle,wWidth,wHeight) || ! applicationDidFinishLaunching())
- // if (! initInstance() || ! applicationDidFinishLaunching())
之后我们将头文件所需要改动的函数声明也一一改动。保存,重新编译libcocos2d工程。再打开HelloWorld中的main.cpp修改这一句:
//我们可以在这里自已设定窗口标题和窗口大小
- return cocos2d::CCApplication::sharedApplication().run(TEXT("第一个Cocos2d-x程序"),800,600);
- //return cocos2d::CCApplication::sharedApplication().run();
编译HelloWorld。运行一下。享受一下成果!
对于这个框架我写的较多,因为整个Cocos2d-x的所有例子都是基于这个框架,我们必须理解清楚它是怎么一回事。