HelloCpp是Cocos2d-x自带的一个工程，它演示了Cocos2d-x最基本的使用方法和流程。先看一下它的基本构成
win32目录中包含了对应平台的代码，而Classes目录中包含了我们自己的实现代码。编译运行的结果如下图
main函数变形记
看到main命名的文件就会想到著名的main函数一定在这个文件里面，那么就让我们先看看这个文件吧。main.h里面主要是include了各种各样的头文件，main.cpp是我们真正需要关注的
1 int APIENTRY _tWinMain(HINSTANCE hInstance, 2 HINSTANCE hPrevInstance,128); line-height:1.5!important"> 3 LPTSTR lpCmdLine,128); line-height:1.5!important"> 4 int nCmdShow) 5 { 6 UNREFERENCED_PARAMETER(hPrevInstance); 7 UNREFERENCED_PARAMETER(lpCmdLine); 8 9 // create the application instance 10 AppDelegate app; 11 CCEGLView* eglView = CCEGLView::sharedOpenGLView(); 12 eglView->setFrameSize(960,640 ); 13 return CCApplication::sharedApplication()->run(); 14 }
1.1 APIENTRY
首先出现的不明物体是APIENTRY。我们先看看它的定义
1 #define APIENTRY WINAPI
APIENTRY是WINAPI的一个替身，而WINAPI是微软定义的宏，实际就是__stdcall
#define WINAPI __stdcall
众所周知，__stdcall声明了函数从右至左将参数压栈并由被调用者清理堆栈的调用约定。
1.2 _tWinMain
如果我说_tWinMain是程序的入口函数，你会不会发飙：我去，入口函数不应该是main吗？是的！对于常规的C/C++程序而言main是入口函数的归宿，但在Windows程序中WinMain才是入口函数。
好吧！但为什么这里对的入口函数是_tWinMain而不是WinMain呢？我们先来看看_tWinMain的真正定义
1 #ifdef _UNICODE 2 3 #define _tWinMain wWinMain 4 5 #else 6 7 #define _tWinMain WinMain 8 9 #endif
为了支持UNICODE，C运行库对WinMain区分了UNICODE版和ANSI版。对UNICODE版的程序，C运行库将调用wWinMain；而对于ANSI版的应用，则调用WinMain。至于WinMain更深入的知识请阅读
《Windows程序设计》，这里只需要知道它是Windows程序的入口函数即可。
1.3 UNREFERENCED_PARAMETER
进入_tWinMain函数后就是两句很神奇的语句
1 UNREFERENCED_PARAMETER(hPrevInstance);
2 UNREFERENCED_PARAMETER(lpCmdLine);
要理解这句话首先是要搞清楚UNREFERENCED_PARAMETER是神马玩意儿。如果我告诉你它神马都不是，你信吗？
#define UNREFERENCED_PARAMETER(P) (P)
承认吧骚年，它真的神马都不是啊~（你逗我玩儿呐？）
AppDelegate的前世今生
_tWinMain函数的真正主体是从AppDelegate app开始的，所以我们就首先从AppDelegate说起。我们先看看AppDelegate的宗族关系
要把AppDelegate弄清楚搞明白，我们还得从源头开始。
2.1 CCApplicationProtocol
作为Cocos2d-x Application的源头，CCApplicationProtocal定义如下
class CC_DLL CCApplicationProtocol
2 {
3 public:
4
5 virtual ~CCApplicationProtocol() {}
6
7 /**
8 @brief Implement CCDirector and CCScene init code here.
9 @return true Initialize success,app continue.
10 @return false Initialize Failed,app terminate.
11 */
12 virtual bool applicationDidFinishLaunching() = 0;
13
14 15 @brief The function be called when the application enter background
16 @param the pointer of the application
17 18 void applicationDidEnterBackground() = 19
20 21 @brief The function be called when the application enter foreground
22 23 24 void applicationWillEnterForeground() = 25
26 27 @brief Callback by CCDirector for limit FPS.
28 @interval The time,expressed in seconds,between current frame and next.
29 30 void setAnimationInterval(double interval) = 31
32 33 @brief Get current language config
34 @return Current language config
35 36 virtual ccLanguageType getCurrentLanguage() = 37
38 39 @brief Get target platform
40 41 virtual TargetPlatform getTargetPlatform() = 42 };
可以看到，CCApplicationProtocol是一个抽象类，它定义并导出作为DLL的接口。这其中有一个陌生CC_DLL，它定义了在DLL中的符号是导出还是导入
#if defined(_USRDLL)
2 #define CC_DLL __declspec(dllexport)
3 #else /* use a DLL library */
4 #define CC_DLL __declspec(dllimport)
#endif
整个CCApplicationProtocol除了析构函数以外的其他所有函数都是纯虚函数，这也就是它为什么叫Protocol的原因。每个函数的含义和作用在注释里有简要的说明，但具体的实现何其作用需要进一步才能理解。
2.2 CCApplication
作为对Cocos2d-x Application的抽象，CCApplication所扮演的角色是非常重要的。它的定义如下
class CC_DLL CCApplication : public CCApplicationProtocol
4 CCApplication();
virtual ~CCApplication();
@brief Run the message loop.
10 int run();
11
13 @brief Get current applicaiton instance.
14 @return Current application instance pointer.
15 16 static CCApplication* sharedApplication();
17
override functions 19 double interval);
virtual ccLanguageType getCurrentLanguage();
21
22 23 24 25 virtual TargetPlatform getTargetPlatform();
26
27 set the Resource root path 28 void setResourceRootPath(const std::string& rootResDir);
29
get the Resource root path 31 string& getResourceRootPath(void)
32 {
33 return m_resourceRootPath;
34 }
35
void setStartupScriptFilename(string& startupScriptFile);
37
string& getStartupScriptFilename(39 {
40 return m_startupScriptFilename;
41 }
42
43 protected:
44 HINSTANCE m_hInstance;
45 HACCEL m_hAccelTable;
46 LARGE_INTEGER m_nAnimationInterval;
47 std::string m_resourceRootPath;
48 std::string m_startupScriptFilename;
49
50 static CCApplication * sm_pSharedApplication;
51 };
虽然CCApplication提供了public的构造函数，但我们却不能直接实例化CCApplication的，因为它没有实现CCApplicationProtocol定义的所有接口函数（它还是一个抽象类）。
2.2.1 构造函数
CCApplication的构造函数所完成的工作就是对成员变量的初始化
1 CCApplication::CCApplication()
2 : m_hInstance(NULL)
3 ,m_hAccelTable(NULL)
4 {
5 m_hInstance = GetModuleHandle(NULL);
6 m_nAnimationInterval.QuadPart = 7 CC_ASSERT(! sm_pSharedApplication);
8 sm_pSharedApplication = this;
9 }
m_hInstance保存了当前模块的句柄，而sm_pSharedApplicaton则保存了当前对象的指针。值得注意的是，sm_pSharedApplication是一个static的CCApplication对象指针。
2.2.2 Application是唯一的
我们再把_tWinMain函数请出来仔细看看（这里去掉了几句无用的代码）
int nCmdShow)
{
create the application instance
AppDelegate app;
CCEGLView* eglView = CCEGLView::sharedOpenGLView();
eglView->setFrameSize(640 );
return CCApplication::sharedApplication()->run();
}
是否对AppDelegate app这句感到疑惑：在定义了app以后却从未使用过它。那么我们是不是可以理解为这句是多余的呢？好吧！我们把它注释掉，结果程序崩溃了！崩溃了！！溃了！！！
这是由sm_pSharedApplication引发的断言异常。sm_pSharedApplication是CCApplication类的一个protected的static成员，虽然在构造函数中将它赋值为this，但它的初始化却是0（空指针）
sharedApplication pointer
2 CCApplication * CCApplication::sm_pSharedApplication = 0;
同时CCApplication提供一个public的static函数来访问它
1 CCApplication* CCApplication::sharedApplication()
2 {
3 CC_ASSERT(sm_pSharedApplication);
return sm_pSharedApplication;
5 }
若果你熟悉设计模式就能一眼看出来这个实现实际上是单例模式，它保证了CCApplication只有一个实例。
看到这里，你可能会惊呼：一定是_tWinMain函数的最后一句return CCApplication::sharedApplication()->run() 引入了错误。哎，事实总是残酷的！实际上异常早在这之前就发生了。我们在CCApplication::sharedApplication函数中下断点，F5运行程序，从CallStack可以看到异常在CCEGLView::WindowProc函数中就发生了
进入CCEGLView::WindowProc函数，很快我们就能发现引发异常的代码段
case WM_SIZE:
2 switch (wParam)
3 {
4 case SIZE_RESTORED:
5 CCApplication::sharedApplication()->applicationWillEnterForeground();
6 break;
7 case SIZE_MINIMIZED:
8 CCApplication::sharedApplication()->applicationDidEnterBackground();
9 10 }
11 break;
WM_SIZE是Windows消息机制中的一个重要消息，每当窗口的大小改变时它就会进入到程序的消息队列中。这段代码就是处理WM_SIZE消息的。当程序启动时，窗口的大小就会发生变化，此时就会调用CCApplication::sharedApplication函数获取CCApplication::sm_pSharedApplication指针。然而，因为我们注释掉了“AppDelegate app”这句代码导致CCApplication的构造函数没有被调用，使得CCApplication::sm_pSharedApplication始终为初始值0，导致调用CCApplication::sharedApplication函数时引发了其内部实现的断言。
是不是被绕晕了？我也有点晕！没关系，我们把CCEGLView插入到这里来分析一下cocos2d-x是如何构成完整Windows程序框架的。熬过这话题就不会晕了。
2.2.3 构建Windows程序框架
从经典教科书《Windows程序设计》中可以看到，典型的Windows程序的框架大体如下
int WINAPI WinMain(HINSTANCE hInstance,128); line-height:1.5!important">2 HINSTANCE hPreInstance,128); line-height:1.5!important">3 PSTR szCmdLine,128); line-height:1.5!important">4 int iCmdShow)
5 {
6 1）注册窗口类，并注册消息处理函数WindowProc
7 2）创建并显示窗口
8 3）循环获取消息
消息处理函数的结构如下
1 LRESULT CALLBACK WindowProc(HWND hwnd,128); line-height:1.5!important"> 2 UINT uMsg,128); line-height:1.5!important"> 3 WPARAM wParam,128); line-height:1.5!important"> 4 LPARAM lParam)
6 switch (uMsg)
7 {
8 处理各种消息
9 }
10 }
对比一下HelloWorld的_tWinMain函数
以下代码对应Windows程序设计的一般框架
13 CCEGLView* eglView = CCEGLView::sharedOpenGLView();
14 eglView->setFrameSize(16 }
首先，我们看一下CCEGLView::sharedOpenGLView函数的实现细节
1 CCEGLView* CCEGLView::sharedOpenGLView()
static CCEGLView* s_pEglView = NULL;
if (s_pEglView == NULL)
5 {
6 s_pEglView = new CCEGLView();
7 }
8 return s_pEglView;
这是单例模式的一种变形，通过CCEGLView::sharedOpenGLView函数始终获取同一个CCEGLView对象的指针。同时它也通过new操作符调用CCEGLView的构造函数实例化了一个CCEGLView对象，而CCEGLView的构造函数只不过是完成了成员变量的初始化。可见，“注册窗口类并同时注册消息处理函数”并非通过CCEGLView::sharedOpenGLView函数完成的。
接下来，我们分析CCEGLView::setFrameSize函数。其实现如下
void CCEGLView::setFrameSize(float width,float height)
3 Create((LPCTSTR)m_szViewName,(int)width,255); line-height:1.5!important">int)height);
4 CCEGLViewProtocol::setFrameSize(width,height);
5
6 resize(width,height); adjust window size for menubar
7 centerWindow();
8 }
哈哈，居然有一个CCEGLView::Create函数
bool CCEGLView::Create(LPCTSTR pTitle,255); line-height:1.5!important">int w,255); line-height:1.5!important">int h)
3 bool bRet = false;
4 do
5 {
6 CC_BREAK_IF(m_hWnd);
7 // 创建窗口类
8 HINSTANCE hInstance = GetModuleHandle( NULL );
9 WNDCLASS wc; Windows Class Structure
10
Redraw On Size,And Own DC For Window.
12 wc.style = CS_HREDRAW | CS_VREDRAW | CS_OWNDC;
13 wc.lpfnWndProc = _WindowProc; WndProc Handles Messages
14 wc.cbClsExtra = 0; No Extra Window Data
15 wc.cbWndExtra = 16 wc.hInstance = hInstance; Set The Instance
17 wc.hIcon = LoadIcon( NULL,IDI_WINlogo ); Load The Default Icon
18 wc.hCursor = LoadCursor( NULL,IDC_ARROW ); Load The Arrow Pointer
19 wc.hbrBackground = NULL; No Background required For GL
20 wc.lpszMenuName = m_menu; //
21 wc.lpszClassName = kWindowClassName; Set The Class Name
22 // 注册窗口类
23 CC_BREAK_IF(! RegisterClass(&wc) && 1410 != GetLastError());
24
25 center window position
26 RECT rcDesktop;
27 GetWindowRect(GetDesktopWindow(),&rcDesktop);
28
29 WCHAR wszBuf[50] = {0};
30 MultiByteToWideChar(CP_UTF8,128); line-height:1.5!important">0,m_szViewName,-1,wszBuf,255); line-height:1.5!important">sizeof(wszBuf));
32 创建窗口(create window)
33 m_hWnd = CreateWindowEx(
34 WS_EX_APPWINDOW | WS_EX_WINDOWEDGE,0); line-height:1.5!important"> Extended Style For The Window
35 kWindowClassName,0); line-height:1.5!important"> Class Name
36 wszBuf,0); line-height:1.5!important"> Window Title
37 WS_CAPTION | WS_POPUPWINDOW | WS_MINIMIZEBox,0); line-height:1.5!important"> Defined Window Style
38 Window Position
39 Window Width
40 Window Height
41 NULL,0); line-height:1.5!important"> No Parent Window
42 NULL,0); line-height:1.5!important"> No Menu
43 hInstance,0); line-height:1.5!important"> Instance
44 NULL );
45
46 CC_BREAK_IF(! m_hWnd);
47
48 resize(w,h);
50 bRet = initGL();
51 CC_BREAK_IF(!bRet);
52
53 s_pMainWindow = 54 bRet = true;
55 } while (0);
56
57 return bRet;
58 }
在CCEGLView::Create函数中完成了注册窗口类和注册消息处理函数_WindowProc，并且完成了窗口的创建。作为Windows程序的核心函数，我们有必要看看_WindowProc看看
static CCEGLView* s_pMainWindow = NULL;
2
static LRESULT CALLBACK _WindowProc(HWND hWnd,UINT uMsg,WPARAM wParam,LPARAM lParam)
4 {
if (s_pMainWindow && s_pMainWindow->getHWnd() == hWnd)
6 {
return s_pMainWindow->WindowProc(uMsg,wParam,lParam);
8 }
else
10 {
return DefWindowProc(hWnd,uMsg,128); line-height:1.5!important">12 }
13 }
_WindowProc函数是一个全局函数，当满足一定条件时就将消息转给s_pMainWindow->WindowProc函数处理。s_pMainWindow是一个全局变量，在CCEGLView::Create中赋值为this指针。那么，我们就得进入CCEGLView::WindowProc看看
1 LRESULT CCEGLView::WindowProc(UINT message,128); line-height:1.5!important"> 2 {
3 BOOL bProcessed = FALSE;
4
5 switch (message)
6 {
7 case WM_LBUTTONDOWN:
8 if (m_pDelegate && MK_LBUTTON == wParam)
9 {
10 POINT point = {(short)LOWORD(lParam),255); line-height:1.5!important">short)HIWORD(lParam)};
11 CCPoint pt(point.x/CC_CONTENT_SCALE_FACTOR(),point.y/CC_CONTENT_SCALE_FACTOR());
12 CCPoint tmp = ccp(pt.x,m_obScreenSize.height - pt.y);
13 if (m_obViewPortRect.equals(CCRectZero) || m_obViewPortRect.containsPoint(tmp))
14 {
15 m_bCaptured = 16 SetCapture(m_hWnd);
17 int id = 18 pt.x *= m_windowTouchScaleX;
19 pt.y *= m_windowTouchScaleY;
20 handleTouchesBegin(pt.y);
21 }
22 }
23 24
25 case WM_MOUSEMOVE:
26 if (MK_LBUTTON == wParam && m_bCaptured)
27 {
28 POINT point = {( 29 CCPoint pt(point.x/CC_CONTENT_SCALE_FACTOR(),128); line-height:1.5!important"> 30 31 pt.x *= m_windowTouchScaleX;
32 pt.y *= m_windowTouchScaleY;
33 handleTouchesMove( 34 }
35 36
37 case WM_LBUTTONUP:
38 if (m_bCaptured)
39 {
40 POINT point = {( 41 CCPoint pt(point.x/CC_CONTENT_SCALE_FACTOR(),128); line-height:1.5!important"> 42 43 pt.x *= m_windowTouchScaleX;
44 pt.y *= m_windowTouchScaleY;
45 handleTouchesEnd( 46
47 ReleaseCapture();
48 m_bCaptured = 49 }
50 51 52 53 {
54 55 CCApplication::sharedApplication()->applicationWillEnterForeground();
56 57 58 CCApplication::sharedApplication()->applicationDidEnterBackground();
59 60 }
61 62 case WM_KEYDOWN:
63 if (wParam == VK_F1 || wParam == VK_F2)
64 {
65 CCDirector* pDirector = CCDirector::sharedDirector();
66 if (GetKeyState(VK_LSHIFT) < 0 || GetKeyState(VK_RSHIFT) < 0 || GetKeyState(VK_SHIFT) < 0)
67 pDirector->getKeypadDispatcher()->dispatchKeypadMSG(wParam == VK_F1 ? kTypeBackClicked : kTypeMenuClicked);
68 }
69 if ( m_lpfnAccelerometerKeyHook!=NULL )
70 {
71 (*m_lpfnAccelerometerKeyHook)( message,lParam );
72 }
73 74 case WM_KEYUP:
75 76 {
77 (*m_lpfnAccelerometerKeyHook)( message,128); line-height:1.5!important"> 78 }
79 80 case WM_CHAR:
81 {
82 if (wParam < 0x20)
83 {
84 if (VK_BACK == wParam)
85 {
86 CCIMEDispatcher::sharedDispatcher()->dispatchDeleteBackward();
87 }
88 else if (VK_RETURN == wParam)
89 {
90 CCIMEDispatcher::sharedDispatcher()->dispatchInsertText("\n",128); line-height:1.5!important">1);
91 }
92 if (VK_TAB == wParam)
93 {
94 tab input
95 }
96 if (VK_ESCAPE == wParam)
97 {
98 ESC input
99 CCDirector::sharedDirector()->end();
100 }
101 }
102 128)
103 {
104 ascii char
105 CCIMEDispatcher::sharedDispatcher()->dispatchInsertText((const char *)&wParam,128); line-height:1.5!important">106 }
107 108 {
109 char szUtf8[8] = {110 int nLen = WideCharToMultiByte(CP_UTF8,(LPCWSTR)&wParam,szUtf8,255); line-height:1.5!important">sizeof(szUtf8),NULL,NULL);
111 CCIMEDispatcher::sharedDispatcher()->dispatchInsertText(szUtf8,nLen);
112 }
113 114 {
115 (*m_lpfnAccelerometerKeyHook)( message,128); line-height:1.5!important">116 }
117 }
118 119 case WM_PAINT:
120 PAINTSTRUCT ps;
121 BeginPaint(m_hWnd,&ps);
122 EndPaint(m_hWnd,128); line-height:1.5!important">123 124
125 case WM_CLOSE:
126 CCDirector::sharedDirector()->end();
127 128
129 case WM_DESTROY:
130 destroyGL();
131 PostQuitMessage(132 133
134 default:
135 if (m_wndproc)
136 {
137
138 m_wndproc(message,lParam,&bProcessed);
139 if (bProcessed) 140 }
141 return DefWindowProc(m_hWnd,message,128); line-height:1.5!important">142 }
143
144 if (m_wndproc && !bProcessed)
145 {
146 m_wndproc(message,128); line-height:1.5!important">147 }
148 return 149 }
如果我们抛开具体的消息及其处理过程，CCEGLView::WindowProc函数可以简化为
1 LRESULT CCEGLView::WindowProc(UINT message,128); line-height:1.5!important"> 4 {
5 处理各种消息
6 }
调用自定义的处理函数
8 9 {
10 m_wndproc(message,128); line-height:1.5!important">11 }
12
当然，如果不满足指定的条件就会使用Windows默认的DefWindowProc方法处理消息。
最后，就剩下“循环获取消息”这部分了。这个时候你不是想起了_tWinMain函数的最后一句代码了吗？让我们再看他一眼
return CCApplication::sharedApplication()->run();
锁定目标，我们进入CCApplication::run函数探究一番，毕竟这个函数也是我们之前列出的重要函数之一。
2.2.4 run出来的消息
CCApplication::run函数的实现如下
int CCApplication::run()
3 PVRFrameEnableControlWindow(false);
Main message loop:
6 MSG msg;
7 LARGE_INTEGER nFreq;
8 LARGE_INTEGER nLast;
9 LARGE_INTEGER nNow;
11 QueryPerformanceFrequency(&nFreq);
12 QueryPerformanceCounter(&nLast);
Initialize instance and cocos2d.
if (!applicationDidFinishLaunching())
16 {
17 18 }
20 CCEGLView* pMainWnd = CCEGLView::sharedOpenGLView();
21 pMainWnd->centerWindow();
22 ShowWindow(pMainWnd->getHWnd(),SW_SHOW);
23
1)
25 {
26 if (! PeekMessage(&msg,128); line-height:1.5!important">0,PM_REMOVE))
27 {
28 Get current time tick.
29 QueryPerformanceCounter(&nNow);
30
31 If it's the time to draw next frame,draw it,else sleep a while.
32 if (nNow.QuadPart - nLast.QuadPart > m_nAnimationInterval.QuadPart)
33 {
34 nLast.QuadPart = nNow.QuadPart;
35 CCDirector::sharedDirector()->mainLoop();
36 }
37 38 {
39 Sleep(40 }
41 continue;
42 }
43
44 if (WM_QUIT == msg.message)
45 {
46 Quit message loop.
47 48 }
50 Deal with windows message.
51 if (! m_hAccelTable || ! TranslateAccelerator(msg.hwnd,m_hAccelTable,&msg))
52 {
53 TranslateMessage(&msg);
54 DispatchMessage(&msg);
55 }
56 }
57
58 return (int) msg.wParam;
59 }
注意了，这里面居然有一个循环！而且是条件为“真”的循环！我们先把函数简化后再来分析
显示窗口
4 CCEGLView* pMainWnd = CCEGLView::sharedOpenGLView();
5 pMainWnd->centerWindow();
6 ShowWindow(pMainWnd->getHWnd(),128); line-height:1.5!important"> 7
10 11 {
12 处理一些数据
13 14 }
15
16 17 {
18 退出消息循环(Quit message loop)
19 20 }
21
22 处理快捷键
23 }
26 }
