cocos2d-x：死磕"HelloWorld"(3)——游戏运行主函数run()

最新推荐文章于 2022-10-24 23:22:03 发布

斗趣

最新推荐文章于 2022-10-24 23:22:03 发布

阅读量1.1k

点赞数

分类专栏： cocos2d-x

本文链接：https://blog.csdn.net/u014078216/article/details/36977373

版权

cocos2d-x 专栏收录该内容

23 篇文章 0 订阅

订阅专栏

在该篇中，我们将分析游戏运行主函数run()，看看它都干了些啥。并且会重点分析其中调用的两个函数：即应用初始化函数applicationDidFinishLaunching()和渲染主循环函数mainLoop()。但是这两个函数所调用的更为细节的函数将放在后续篇章中分析。一次分析两层函数应该是可以接受的，多了就晕了。现在我们就来一顿run()函数的庐山真面：

CCApplication.cpp

int CCApplication::run()
{
    PVRFrameEnableControlWindow(false);//设置和获取注册表信息.

    // Main message loop:
    MSG msg;//创建消息对象
    LARGE_INTEGER nFreq;
    LARGE_INTEGER nLast;
    LARGE_INTEGER nNow;
    //创建三个大整数对象（大整数定义详解请移步博主另一博文[1]）。这三大整数用于记录程序运行过程中两个事件的时间间隔。下面两个函数便是它们的赋值函数。

    QueryPerformanceFrequency(&nFreq);//把windows高精度定时器的时钟频率传递给nFreq对象。
    QueryPerformanceCounter(&nLast);//把定时器当前计数传递给 nLast。后面还会再次调用该函数，把定时器计数传递给nNow。这样一来，我们便分别获得了两个事件发生时定时器的计数，这两个计数之差nNow.QuadPart-nLast.QuadPart便是这两个事件的间隔计数（即事件间隔内时钟的振荡次数），把间隔计数除以时钟频率nFreq.QuadPart便是间隔时间。这种计时方法可以达到很高的精度。

    // Initialize instance and cocos2d.
    if (!applicationDidFinishLaunching())//applicationDidFinishLaunching()用于对实例进行初始化。我们马上会详解该函数。
    {
        return 0;
    }

    CCEGLView* pMainWnd = CCEGLView::sharedOpenGLView();//创建一个视窗类对象。由于sharedOpenGLView()采用单例模式，所以该对象即为之前在applicationDidFinishLaunching()里创建的那个视窗对象(见下面对applicationDidFinishLaunching()的分析)。
    pMainWnd->centerWindow();//将该窗口居中
    ShowWindow(pMainWnd->getHWnd(), SW_SHOW);//显示窗口

    while (1)//渲染死循环
    {
        if (! PeekMessage(&msg, NULL, 0, 0, PM_REMOVE))//先调用一个API函数PeekMessage。如果无法获得当前窗口（第二个参数为被检查的窗口句柄，如果为NULL，则为当前窗口）的消息，则PeekMessage返回值为零，条件判断为真，允许执行语块内代码。
        {
            // Get current time tick.
            QueryPerformanceCounter(&nNow);//读取定时器当前计数传递给nNow。

            // If it's the time to draw next frame, draw it, else sleep a while.
            if (nNow.QuadPart - nLast.QuadPart > m_nAnimationInterval.QuadPart)//如果当前计数和上一个计数之差大于某一设定值 m_nAnimationInterval则进入mainLoop()开始渲染，并且更新定时器计数， 否则将当前线程挂起，挂起时间在该例中为0秒，相当于没挂。然后continue进入下一个渲染循环，跳过后面的两个条件语句。
            {
                nLast.QuadPart = nNow.QuadPart;
                CCDirector::sharedDirector()->mainLoop();
            }
            else
            {
                Sleep(0);
            }
            continue;
        }

        if (WM_QUIT == msg.message)//如果消息结构体中的message成员等于退出编码，则退出循环。在这里我们可以大胆猜测按下HelloWorld窗口中的关闭按钮，会导致消息结构体中的message成员等于退出编码，从而退出循环。这一猜测可以通过在break处设置断点进行验证。至于细节我们会在本节末再次讨论。
        {
            // Quit message loop.
            break;
        }

        // Deal with windows message.
        if (! m_hAccelTable || ! TranslateAccelerator(msg.hwnd, m_hAccelTable, &msg))// 假如加速键表句柄为零，或者调用翻译加速键表函数失败，则先将虚拟键消息转换为字符消息，寄送到调用线程的消息队列里，然后将消息发给窗口程序。
        {
            TranslateMessage(&msg);
            DispatchMessage(&msg);
        }
    }

    return (int) msg.wParam;
}

下面就来分析一下其中的实例初始化函数applicationDidFinishLaunching()

CCDelegate.cpp

bool AppDelegate::applicationDidFinishLaunching() {
    // initialize director
    CCDirector* pDirector = CCDirector::sharedDirector();//创建一个导演对象，并初始化。所谓初始化即对其成员数据赋值。
    CCEGLView* pEGLView = CCEGLView::sharedOpenGLView();//创建一个视窗类对象，并初始化。

    pDirector->setOpenGLView(pEGLView);//把视窗对象指针传递给导演。注意setOpenGLView(CCEGLView *pobOpenGLView)里的m_pobOpenGLView = pobOpenGLView。
	CCSize frameSize = pEGLView->getFrameSize();//获取窗口大小。

    // Set the design resolution //设置分辨率。
#if (CC_TARGET_PLATFORM == CC_PLATFORM_WINRT) || (CC_TARGET_PLATFORM == CC_PLATFORM_WP8)
    pEGLView->setDesignResolutionSize(designResolutionSize.width, designResolutionSize.height, kResolutionShowAll);
#else
    pEGLView->setDesignResolutionSize(designResolutionSize.width, designResolutionSize.height, kResolutionNoBorder);
#endif

    
    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.   
	if (frameSize.height > mediumResource.size.height)
	{
        searchPath.push_back(largeResource.directory);

        pDirector->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.
    else if (frameSize.height > smallResource.size.height)
    {
        searchPath.push_back(mediumResource.directory);
        
        pDirector->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.
	else
    {
        searchPath.push_back(smallResource.directory);

        pDirector->setContentScaleFactor(MIN(smallResource.size.height/designResolutionSize.height, smallResource.size.width/designResolutionSize.width));
    }


    // set searching path 
    CCFileUtils::sharedFileUtils()->setSearchPaths(searchPath); //设置搜索路径。
	
    // turn on display FPS 
    pDirector->setDisplayStats(true);//开启帧频显示。

    // set FPS. the default value is 1.0/60 if you don't call this 
    pDirector->setAnimationInterval(1.0 / 60);  //设置渲染间隔。该间隔先传给m_dAnimationInterval，后传给m_nAnimationInterval.

    // create a scene. it's an autorelease object
    CCScene *pScene = HelloWorld::scene(); //创建一个HelloWorld场景。对于单纯的游戏制作者而言，这是重头戏。我们将在第四篇中详解该函数。
    // run
    pDirector->runWithScene(pScene); //渲染准备函数，我们将在第五篇中详解该函数。

    return true;
}

除了窗口和路径设置之外，导演指挥一切。初始化若成功则返回值为真，否则为假。当返回值为真时，则继续run()，否则退出整个程序。

下面就来看重点之二，渲染主循环函数mainLoop()。该函数是导演类的成员函数。

CCDirector.cpp

void CCDisplayLinkDirector::mainLoop(void)
{
    if (m_bPurgeDirecotorInNextLoop)
    {
        m_bPurgeDirecotorInNextLoop = false;
        purgeDirector();
    }
    else if (! m_bInvalid)
     {
         drawScene();
     
         // release the objects
         CCPoolManager::sharedPoolManager()->pop();        
     }
}

假如导演类数据成员m_bPurgeDirecotorInNextLoop为真，则将其设为假，并且调用purgeDirector()，停止并关闭渲染窗口。如果m_bPurgeDirecotorInNextLoop为假，并且m_bInvalid也为假（从CCDisplayLinkDirector构造中看出其初始值为假）时，调用渲染场景函数drawScene()进行渲染，渲染完调用sharedPoolManager()->pop()释放内存。

至此，我们对run()的内容也有了个了解。它主要就是利用applicationDidFinishLaunching()创建了一个导演，一个窗口和一个HelloWorld场景，然后利用一个死循环和mainLoop对该场景进行渲染。

还有个遗留问题是关闭键如何关闭程序。它调用了一个HelloWold类里的回调函数menuCloseCallback(CCObject* pSender)。该回调函数又调用了导演类的end()函数。该end()函数的功能很简单就是把导演类的成员数据m_bPurgeDirecotorInNextLoop设为真，因此当渲染循环再次进入到mainLoop()里时，便会调用purgeDirector()，停止并关闭渲染窗口。当程序进入下一渲染循环时，PeekMessage的返回值为真，条件判断为假，因此直接进入第二个条件判断语句。此时消息符合退出编码，因此执行break，退出渲染循环。

引文：

[1] http://blog.csdn.net/u014078216/article/details/24401421