MyGui笔记（1）建立第一个工程

记录下学习 MyGui的一些笔记，从建立第一个工程开始。

步骤：

1.右键MYGUI解决方案，添加→新建项目，选择“Win32 项目”，名称为：TestHello。下一步，勾选“空项目”。

2.设置工程Debug版本属性。“调试”→“工作目录”填入如下：

1

F:\MyCode\MyGUI_SVN\Build\bin\debug

“C/C++”→“常规”→“附加包含目录”填入以下：

1 2 3 4 5

F:\MyCode\MyGUI_SVN\MyGUIEngine\include F:\MyCode\MyGUI_SVN\Common F:\MyCode\MyGUI_SVN\Common\Base\OpenGL F:\MyCode\MyGUI_SVN\Platforms\OpenGL\OpenGLPlatform\include F:\MyCode\MyGUI_SVN\Common\Input\Win32

“预处理器”→“预处理器定义”填入如下：

1

WIN32;_WINDOWS;_DEBUG;_CRT_SECURE_NO_WARNINGS;MYGUI_OPENGL_PLATFORM;MYGUI_SAMPLES_INPUT_WIN32;

“链接器”→“常规”→“输出文件”填入如下

1

F:\MyCode\MyGUI_SVN\Build\bin\Debug\$(ProjectName).exe

“附加库目录”填入如下：

1 2

F:\MyCode\MyGUI_SVN\Build\lib\Debug F:\MyCode\MyGUI_SVN\Dependencies\lib\Debug

“输入”→“附加依赖项”填入如下：

1

kernel32.lib user32.lib gdi32.lib winspool.lib shell32.lib ole32.lib oleaut32.lib uuid.lib comdlg32.lib advapi32.lib gdiplus.lib glu32.lib opengl32.lib Common_d.lib MyGUI.OpenGLPlatform_d.lib MyGUIEngine_d.lib freetype2311_D.lib

3.添加C++类TestKeeper，派生自base::BaseDemoManager，在TestKeeper.h 文件添加如下头文件：

1

#include  "Base/BaseDemoManager.h"

在TestKeeper.cpp文件添加如下头文件：

1

#include  "Base/Main.h"

在最底下添加如下代码：

1

MYGUI_APP(TestKeeper)

这是一个宏，实质是Win32应用程序的入口函数，源码如下：

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

#if MYGUI_PLATFORM == MYGUI_PLATFORM_WIN32 #   ifdef MYGUI_CHECK_MEMORY_LEAKS #       define MYGUI_APP(cls) INT WINAPI WinMain( HINSTANCE hInst, HINSTANCE, LPSTR strCmdLine, INT argc) { _CrtSetDbgFlag ( _CRTDBG_ALLOC_MEM_DF | _CRTDBG_LEAK_CHECK_DF );  return startApp<cls>(); } #    else #       define MYGUI_APP(cls) INT WINAPI WinMain( HINSTANCE hInst, HINSTANCE, LPSTR strCmdLine, INT argc) {  return startApp<cls>(); } #   endif #else #   define MYGUI_APP(cls)  int main( int argc,  char **argv) {  return startApp<cls>(); } #endif template < class AppClass> int startApp() {      try     {         AppClass* app =  new AppClass();         app->prepare();          if (app->create())         {             app->run();             app->destroy();         }          delete app;         app =  ;     }      catch (MyGUI::Exception& _e)     { #if MYGUI_PLATFORM == MYGUI_PLATFORM_WIN32         MessageBoxA(  NULL, _e.getFullDescription().c_str(),  "An exception has occured", MB_OK | MB_ICONERROR | MB_TASKMODAL); #else         std::cerr <<  "An exception has occured" <<  " : " << _e.getFullDescription().c_str(); #endif          throw;     }      return  ; }

可以看到，首先调用了prepare方法进行了准备工作，这是个虚函数，没有具体实现，派生类可以实现自己需要的工作。接着调用create方法进行创建窗口，内部代码部分注释如下：

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

bool BaseManager::create( int _width,  int _height) {      //中间省略     hWnd = CreateWindow(wc.lpszClassName, TEXT( "OpenGL Render Window"), WS_POPUP,          ,  ,  ,  , GetDesktopWindow(),  NULL, wc.hInstance,  this);      //中间省略           //创建渲染  根据所选的渲染系统，创建渲染显示      if (!createRender(width, height, windowed))     {          return  false;     }      //创建Gui  包含加载资源setupResources     createGui();      //创建输入管理器  调用的是基类的InputManager::createInput     createInput((size_t)hWnd);      //创建指针管理器  调用的是基类的PointerManager::createPointerManager     createPointerManager((size_t)hWnd);      //创建场景  没有实现，具体由派生类来实现     createScene();      //内部函数  窗口变化大小时，会触发来重新设置渲染窗口大小     _windowResized(); return  true; }

之后就是调用run方法来进行消息的处理了，代码如下：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22

void BaseManager::run() {     MSG msg;      while ( true)     {          while (PeekMessage(&msg,  NULL,  ,  , PM_REMOVE))         {             TranslateMessage(&msg);             DispatchMessage(&msg);         }          if (mExit)              break;          else  if (msg.message == WM_QUIT)              break; captureInput();  //捕获输入  由派生类来实现         drawOneFrame();  //绘制一帧  调用相应的渲染方法 if (GetActiveWindow() != hWnd)             ::Sleep( );     } }

当收到退出的消息，就会退出循环，调用destroy方法，相应地将create创建出来的东西倒序销毁掉，代码如下：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

void BaseManager::destroy() {     destroyScene(); destroyPointerManager(); destroyInput(); destroyGui(); destroyRender(); if (hWnd)     {         DestroyWindow(hWnd);         hWnd =  ;     } UnregisterClass(WND_CLASS_NAME, hInstance); }

此时，编译运行程序的话，将会看到一个黑色的窗口。

4.简单地显示一个对话框和按钮。重载createScene方法，代码如下：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22

void TestKeeper::createScene() {     base::BaseDemoManager::createScene(); //创建一个主对话框     MyGUI::Window* window = MyGUI::Gui::getInstance().createWidget<MyGUI::Window>(          "WindowCS",                          //皮肤         MyGUI::IntCoord( ,  ,  ,  ),   //坐标、宽高         MyGUI::Align::Default,               //对齐方式          "Main"                               //创建于哪个层上，定义在MyGUI_Layers.xml         );     window->setCaption( "Frame");             //标题名称     window->setMinSize( ,  );              //最小的大小 //创建位于对话框里的按钮     MyGUI::Button* button = window->createWidget<MyGUI::Button>(          "Button",         MyGUI::IntCoord( ,  ,  ,  ),          MyGUI::Align::Default         );     button->setCaption( "Button"); }

createScene方法是用来初始化时创建场景的，在这里可以进行添加控件。编译运行，可看到如下结果：

5.分析资源的载入和控件的创建。资源的载入从createGui方法开始，代码如下：

1 2 3 4 5 6 7 8 9 10

void BaseManager::createGui() {     mPlatform =  new MyGUI::OpenGLPlatform();     mPlatform->initialise( this); setupResources(); mGUI =  new MyGUI::Gui();     mGUI->initialise(mResourceFileName); }

createGui方法内部调用了setupResources方法，setupResources方法用来设定资源的路径，默认读取应用程序同目录下的resources.xml配置，配置内容如下：

1 2 3 4 5 6

<?xml version= "1.0"  encoding= "UTF-8" ?> <Paths>    <Path root= "true" >F: /MyCode /MyGUI_SVN /Media </Path>    <Path>F: /MyCode /MyGUI_SVN /Media /MyGUI_Media </Path> </Paths>

标签Path代表一个路径，带有root="true"属性的，表示这是个根资源路径，底下包含着多个子资源目录，默认不指定递归，每当需要对某个子资源目录添加为程序的资源加载路径时，使用类似如下代码：

1

addResourceLocation(getRootMedia() +  "/Common/Base");

设定资源路径之后，创建Gui，并以资源文件名进行初始化，资源文件名默认为MyGUI_Core.xml，这时会从设定的资源路径去寻找这个文件，在F:\MyCode\MyGUI_SVN\Media\MyGUI_Media路径下找到它，内容如下：

1 2 3 4 5 6 7 8 9 10 11

<?xml version= "1.0"  encoding= "UTF-8" ?> <MyGUI type= "List" >      <List file= "MyGUI_GeneratedFonts.xml" />      <List file= "MyGUI_Fonts.xml" />      <List file= "MyGUI_CommonSkins.xml" />      <List file= "MyGUI_BlueWhiteTheme.xml" />      <List file= "MyGUI_PointerImages.xml" />      <List file= "MyGUI_Pointers.xml" />      <List file= "MyGUI_Layers.xml" />      <List file= "MyGUI_Settings.xml" /> </MyGUI>

列表里的XML文件都保存各自不同的信息，具体这些配置是做什么用的，等之后有涉及到再说明。ResourceManager资源管理器加载这些XML配置。下面分析下控件创建的过程，根控件以MyGUI::Gui::getInstance().createWidget来创建，这是个模板方法，代码如下：

1 2 3 4 5

template < typename T> T* createWidget( const std::string& _skin,  const IntCoord& _coord, Align _align,  const std::string& _layer,  const std::string& _name =  "") {      return  static_cast<T*>(createWidgetT(T::getClassTypeName(), _skin, _coord, _align, _layer, _name)); }

实质是调用createWidgetT方法，但不同的是这个方法返回的是相应的控件指针。每个参数的意思如下：

• _type 控件类型（可在WidgetManager::initialise()查看所有的控件类型）
• _skin 控件皮肤（先查找MyGUI_BlueWhiteTemplates.xml，没有的话再查找MyGUI_BlueWhiteSkins.xml文件）
• _coord 控件坐标 （左、上、宽、高）
• _align 控件对齐方式 （定义在Align，包括居左、居右、水平拉伸等等）
• _layer 控件将被创建到哪一层（所有的层定义在MyGUI_Layers.xml文件）
• _name 控件名称（可以通过这个名称来寻找控件）

每个控件类都含有MYGUI_RTTI_DERIVED(DerivedType)声明，这是一个宏，用来实现类型RTTI，其含有getClassTypeName方法用来获得类名，即控件类型DerivedType。下一篇继续……

---

更多资料：

1. MyGUI_Orge官网教程翻译 http://blog.csdn.net/adfansong/article/category/1566083
2. MyGUI 学习笔记 http://blog.csdn.net/jean7155/article/category/1333155
3. MyGUI 架构介绍 http://blog.csdn.net/geometry_/article/category/1084100
4. MyGUI wiki翻译 http://blog.csdn.net/efulao/article/category/1611683
5. MyGUI 3.2资源文件的分析 http://blog.sina.com.cn/s/blog_be4206db01018w7v.html