对HGE游戏引擎的一次封装

 HGE游戏引擎是一个开源2D游戏引擎，基于directX。

它的渲染及逻辑是基于帧回调的框架模式，

其提供一些基本的图像操作和输入控制功能。

 

我在之前写一个2D游戏的时候对它整个框架进行了一次封装，很多地方写得比较恶心，请原谅我在变量上命名的不规范。

 

在此分享出来，主要可以参考一下大体框架吧。

 

HGE游戏引擎基于帧的回调让我很不爽，因为咱的游戏逻辑一般是连续的，跟具体帧无关，所以我把整个HGE跑在自己的一个线程之中。我的游戏逻辑部分通过发消息，通知界面更新 以及获取用户输入。

 

 

在HGE的主框架下分四个部分

1. 资源管理 2.消息管理 3.声音管理 4.UI管理

 

下面是GDE_UI_HGEFramework.h

 

/* * CopyRight 2009 - 2010 GDE工作室 * 游戏UI系统 - HGE 引擎框架类 * =================================== * 整个UI系统调用HGE游戏引擎的主框架 * * 2010/01/08 cg create */ #ifndef GDE_UI_HGE_FRAMEWORK_H_ #define GDE_UI_HGE_FRAMEWORK_H_ #include "GDE_UI_ResourceManager.h" #include "GDE_UI_UIManager.h" #include "GDE_UI_MessageManager.h" #include "GDE_UI_SoundManager.h" #pragma comment(lib,"GDE_UI/HGE/lib/hge.lib") #pragma comment(lib,"GDE_UI/HGE/lib/hgehelp.lib") #pragma comment(linker, "/NODEFAULTLIB:libc.lib") #include "GDE_UI_thread_core.h" namespace GDE { namespace GDE_UI { //HGE引擎框架 class HGE_Framework { public: //唯一实例 static HGE_Framework* Instance() { static HGE_Framework* instance_ = 0; if( !instance_ ) { instance_ = new HGE_Framework(); } return instance_; } ~HGE_Framework() { delete m_ResManager; delete m_MessageManager; delete m_SoundManager; delete m_UIManager; } //开始运行 void Run() { //获取资源指针 pHGE = m_ResManager->GetHGEPtr(); pGUI = m_ResManager->GetGuiPtr(); //初始化子类中的HGE核心指针 m_MessageManager->Ready(); m_UIManager->Ready(); //开始主循环 if(pHGE->System_Initiate() && pHGE) { pHGE->System_Start(); } else MessageBox(NULL, pHGE->System_GetErrorMessage(), "Error", MB_OK | MB_ICONERROR | MB_SYSTEMMODAL); } //HGE框架逻辑函数 static bool FrameFunc() { SMART_LOCK( 0 )//线程锁 HGE_Framework::Instance()->m_MessageManager->ProcessMessage();//处理消息 HGE_Framework::Instance()->m_UIManager->Handler();//处理用户操作 return FALSE; } //HGE框架渲染函数 static bool RenderFunc() { SMART_LOCK( 0 )//线程锁 HGE_Framework::Instance()->pHGE->Gfx_Clear(0); //清屏 HGE_Framework::Instance()->pHGE->Gfx_BeginScene(); //开始渲染 HGE_Framework::Instance()->m_UIManager->Render();//绘制 HGE_Framework::Instance()->pHGE->Gfx_EndScene(); //结束渲染 return FALSE; } //成员子管理器指针 ResourceManager* m_ResManager; MessageManager* m_MessageManager; SoundManager* m_SoundManager; UIManager* m_UIManager; //HGE系统相关资源指针 HGE* pHGE; hgeGUI* pGUI; private: //私有构造，不允许实例化 HGE_Framework() :pHGE(0) ,pGUI(0) { m_ResManager = new ResourceManager(); m_MessageManager = new MessageManager(); m_SoundManager = new SoundManager(); m_UIManager = new UIManager(); } }; } } #endif;

 

比较核心的是资源管理类，下面给出

GDE_UI_ResourceManager.h

 

/* * CopyRight 2009 - 2010 GDE工作室 * 游戏UI系统 - HGE 引擎框架类 - 资源管理器 * =================================== * HGE引擎资源管理类 * * 本类的资源主要实现对HGE资源的维护 和对HGE API封装提供工具集 * 并维护HGE的配置环境 * * 2010/01/08 cg create */ #ifndef GDE_UI_FRAMEWORK_RESOURCEMANAGER_H_ #define GDE_UI_FRAMEWORK_RESOURCEMANAGER_H_ #include "./HGE/cn/GfxFont.h" #include "./HGE/cn/GfxEdit.h" #include "./HGE/include/hge.h" #include "./HGE/include/hgegui.h" #include "./HGE/include/hgeguictrls.h" #include "./HGE/include/hgeresource.h" #include <string> namespace GDE { namespace GDE_UI { //资源管理类 class ResourceManager { public: //构造函数，加载HGE全局资源 ResourceManager(); //析构函数，释放HGE全局资源 ~ResourceManager(); //获取HGE指针 HGE* GetHGEPtr() { return pHGE; } //获取GUI指针 hgeGUI* GetGuiPtr() { return pGUI; } //读取图片 void LoadImage( std::string const& filename, hgeSprite*& p_sprite, HTEXTURE& tex ); private: HGE* pHGE; hgeGUI* pGUI; hgeResourceManager m_HgeResManager; }; } } #endif

 

GDE_UI_ResourceManager.cpp

 

#include "GDE_UI_HGEFramework.h" #include "GDE_UI_ResourceManager.h" namespace { std::string const RES_MANAGER_FILENAME = "res/res_s"; int const WIN_SCREENWIDTH = 800; int const WIN_SCREENHEIGHT = 600; std::string const WIN_TITILE = "HGE TEST WINDOW"; int const WIN_COLORMODE = 32; int const WIN_MAXFPS = 100; int const WIN_WINDOWED = true; } namespace GDE { namespace GDE_UI { //构造函数 ResourceManager::ResourceManager() : m_HgeResManager( RES_MANAGER_FILENAME.c_str() ) { //建立HGE全局实例 pHGE = hgeCreate(HGE_VERSION); //初始化配置 pHGE->System_SetState(HGE_INIFILE, "hgedemo.ini"); pHGE->System_SetState(HGE_LOGFILE, "hgedemo.log"); pHGE->System_SetState(HGE_FRAMEFUNC, &HGE_Framework::FrameFunc); pHGE->System_SetState(HGE_RENDERFUNC, &HGE_Framework::RenderFunc); pHGE->System_SetState(HGE_TITLE, WIN_TITILE.c_str()); pHGE->System_SetState(HGE_SCREENWIDTH, WIN_SCREENWIDTH); pHGE->System_SetState(HGE_SCREENHEIGHT, WIN_SCREENHEIGHT); pHGE->System_SetState(HGE_SCREENBPP, WIN_COLORMODE); pHGE->System_SetState(HGE_FPS,WIN_MAXFPS); pHGE->System_SetState(HGE_WINDOWED, WIN_WINDOWED); pHGE->System_SetState(HGE_HIDEMOUSE, false); pHGE->System_SetState(HGE_USESOUND, false); pHGE->System_SetState(HGE_DONTSUSPEND, true);//失去焦点不挂起 pHGE->System_SetState((hgeIntState)14, (int)0xFACE0FF); //禁用HGE LOGO //初始化GUI pGUI = new hgeGUI(); pGUI->SetNavMode(HGEGUI_UPDOWN | HGEGUI_CYCLED); pGUI->Enter(); } ResourceManager::~ResourceManager() { // 销毁gui delete pGUI; // 销毁资源管理器 m_HgeResManager.Purge(); // HGE结束 pHGE->System_Shutdown(); pHGE->Release(); } void ResourceManager::LoadImage( std::string const& filename, hgeSprite*& p_sprite, HTEXTURE& tex ) { if( p_sprite ) delete p_sprite; //销毁之前的图片 tex = pHGE->Texture_Load( filename.c_str() ); //装载纹理 int w = pHGE->Texture_GetWidth( tex ); int h = pHGE->Texture_GetHeight( tex ); p_sprite = new hgeSprite( tex, 0, 0, w, h ); //剪裁精灵 } } }

 

比较重要的是消息传递机制，我仿照了MFC的消息宏定义机制，下面给出消息模块的核心代码

 

//消息映射宏定义 #define BEGIN_MESSAGE_MAP()/ typedef void (MessageManager::*MessageFunction)();/ std::map<UIMessage, MessageFunction> message_functions_;/ void InitMessageMap()/ { #define ON_MESSAGE( ID, memberFuc )/ message_functions_[ID] = &MessageManager::memberFuc; #define END_MESSAGE_MAP/ } .... //这里是我游戏中具体的一些消息 //消息类型 typedef int UIMessage; UIMessage const UIMessage_UpdateBackImg = 0; //更新背景图片 UIMessage const UIMessage_AddRole = 10; //增加角色 UIMessage const UIMessage_RemoveRole = 11; //删除角色 UIMessage const UIMessage_UpdateRole = 12; //更新角色列表 UIMessage const UIMessage_AttackInfo = 13; //角色掉血显示 UIMessage const UIMessage_UpdateDialog = 20; //更新对话框 UIMessage const UIMessage_HideDialog = 21; //隐藏对话框 UIMessage const UIMessage_UpdateSmallMap = 30; //更新小地图 UIMessage const UIMessage_UpdateGameInfo = 40; //更新游戏提示信息 UIMessage const UIMessage_UpdateButton = 50; //增加按钮 UIMessage const UIMessage_RemoveButton = 51; //删除按钮 UIMessage const UIMessage_RemoveAllButtons = 52; //移除所有按钮 UIMessage const UIMessage_UpdatePopMenu = 60; //弹出菜单 UIMessage const UIMessage_HidePopMenu = 61; //隐藏弹出菜单 UIMessage const UIMessage_UpdateZoneBlock= 70; //更新地图块 UIMessage const UIMessage_HideZoneBlock = 71; //清除地图块 //消息映射实现 BEGIN_MESSAGE_MAP() ON_MESSAGE( UIMessage_UpdateBackImg, UpdateBackImage ) ON_MESSAGE( UIMessage_AddRole, AddRole ) ON_MESSAGE( UIMessage_RemoveRole, RemoveRole ) ON_MESSAGE( UIMessage_UpdateRole, UpdateRole ) ON_MESSAGE( UIMessage_AttackInfo, RoleAttackInfo ) ON_MESSAGE( UIMessage_UpdateDialog, UpdateDialog ) ON_MESSAGE( UIMessage_HideDialog, HideDialog ) ON_MESSAGE( UIMessage_UpdateSmallMap, UpdateSmallMap ) ON_MESSAGE( UIMessage_UpdateGameInfo, UpdateGameInfo ) ON_MESSAGE( UIMessage_UpdateButton, UpdateButton ) ON_MESSAGE( UIMessage_RemoveButton, RemoveButton ) ON_MESSAGE( UIMessage_RemoveAllButtons, RemoveAllButtons ) ON_MESSAGE( UIMessage_UpdatePopMenu, UpdatePopMenu ) ON_MESSAGE( UIMessage_HidePopMenu, HidePopMenu ) ON_MESSAGE( UIMessage_UpdateZoneBlock, UpdateZoneBlock ) ON_MESSAGE( UIMessage_HideZoneBlock, HideZoneBlock ) END_MESSAGE_MAP() //处理消息 void ProcessMessage() { for( int i = 0; i < m_MessageList.size(); ++i ) { ( this->*message_functions_[m_MessageList[i]] )(); } m_MessageList.clear(); }

 

最后是整个HGE引擎启动的方式

GDE_UI_HGE.h

 

#ifndef GDE_UI_HGE_H_ #define GDE_UI_HGE_H_ #include <windows.h> #include <string> #include "GDE_UI_HGEFramework.h" /* GDE HGE游戏引擎模块 2009-11-21 var | author | brief ================================================ 1.0 cg create */ namespace GDE { namespace GDE_UI { //HGE线程入口 static DWORD WINAPI HGEThreadProc(LPVOID lpParameter) { HGE_Framework::Instance()->Run(); return 0; } } } #endif

 

 

游戏初始化的时候   

 

//创建hge线程
  hge_thread = CreateThread( NULL, 0,
   HGEThreadProc, NULL, 0, NULL );

 

就可以了