MMORPG大型游戏设计与开发(客户端架构 part2 of vgui)

这一节我将讲解vgui的基础系统部分,也是该库提供给外部使用的一些重要接口。作为UI部分比较重要的部分,该节有着至关重要的部分,如果没有看到上一节内容,请留意下面的连接。我们现在可以猜想一下在客户端UI部分,要设计到哪些东西呢?首先UI的大部分操作便是窗口的显示,那么窗口中又有哪些元素呢?链接、文字……

CODE

/**
 * PAP Engine ( -- )
 * $Id system.h
 * @link -- for the canonical source repository
 * @copyright Copyright (c) 2013-2014 viticm( viticm@126.com )
 * @license
 * @user viticm<viticm@126.com/viticm.ti@gmail.com>
 * @date 2014-3-26 11:26:48
 * @uses vgui base system
 */
#ifndef VGUI_BASE_SYSTEM_H_
#define VGUI_BASE_SYSTEM_H_

#include <OgreRoot.h>
#include <imm.h>
#include "CEGUIString.h"
#include "vengine/ui/system.h"
#include "vgui/config.h"

/** ogre and cegui { **/

namespace Ogre {
class Root;
}; //namespace Ogre

namespace CEGUI {
class System;
class OgreCEGUIRenderer;
class FalagardActionButton;
class EventArgs;
class Window;
}; //namespace CEGUI

namespace vgui_script {
class Base;
}; //namespace vgui_script

/** }ogre and cegui **/

namespace vgui_window {
class Manager;
}; //namespace vgui_base

namespace vgui_icon {
class Manager;
}; //namespace vgui_icon

namespace vgui_string {
class System;
}; //namespace vgui_string

namespace vgui_creature {

namespace head_board {
class System;
}; //namespace head_board

}; //namespace vgui_creature

namespace vgui_base {

class System : public vengine_ui::System {

VENGINE_KERNEL_DECLARE_DYNAMIC(vgui_base_System);

 public:
   System();
   virtual ~System();
   static System* getself();

 public: //implement from abstract class
   virtual void on_windowsize_change(uint32_t message,
                                     WPARAM wparam, 
                                     LPARAM lparam); //窗口大小改变事件
   virtual void injectinput(); //如果事件结果为true则获取了输入
   virtual bool messageprocess(HWND hwnd, 
                               uint32_t message, 
                               WPARAM wparam, 
                               LPARAM lparam); //文字输入消息
   virtual bool is_mousehover(); //鼠标是否在UI上空
   //鼠标是否在聊天板上空
   virtual bool is_mousehover_chatboard(int64_t x, int64_t y); 
   //获得聊天信息里的超链接信息
   virtual STRING get_chatboard_hyplink_content(int64_t x, int64_t y);
   //创建一个新的角色信息板
   virtual vengine_ui::CreatureHeadBoard* create_creature_headboard();
   //添加一个新的被击中信息框
   virtual void add_behit_board(bool _double, 
                                const char* info, 
                                float startx, 
                                float starty, 
                                uint8_t type, 
                                uint8_t movetype);
   virtual bool is_windowshow(const char* name, 
                              const char* childname = NULL);
   virtual bool close_allwindow();
   //通知UI创建一组UI显示模型
   virtual void fakeobject_show(const char* windowname, const char* name);
   //知UI销毁一组UI显示模型
   virtual void fakeobject_destroy(const char* windowname, 
                                   const char* name);
   
   //debugs
 public:
   virtual void debug_push_chatstring(const char* name, 
                                      const char* message);
   virtual void debug_save_fonttexture();

 public:
   virtual void change_dragflag(bool flag);
   virtual bool is_dragend();

 public:
   //逻辑层添加系统通知信息
   virtual STRING parsestring_varparam(const char* id, ...);
   virtual void parsestring_nocolor(const STRING& in, 
                                    STRING& out, 
                                    bool control = false);
   virtual STRING parsestring_nocolor_varparam(const char* id, ...);
   virtual STRING parsestring_no_varparam(const char* id);
   virtual STRING parsestring_nocolor_no_varparam(const char* id);

   //聊天模板字串的取得
   virtual STRING get_talktemplate(const STRING& key, uint16_t index);
   virtual STRING modify_chattemplate(const STRING& temp, 
                                      const STRING& talker, 
                                      const STRING& target);
   virtual STRING get_talkrand_helpmessage(); //聊天随机提示消息
   //查看当前获取输入的EditBox
   virtual bool is_IME_editbox_active(const char* windowname);
   virtual int32_t get_current_IMEstate(); //获取当前输入法状态
   virtual STRING get_IME_editbox_string(const char* name); //获得输入内容

   //传入一个物品信息
   virtual bool inject_iteminfo(
       vengine_game::ItemTransferSystem::element_t* element);

   virtual void on_pushescape();
   virtual bool is_paopao_active();
   virtual uint32_t lumination_ogrecolor(uint32_t ogrecolor, 
                                         int32_t lumination);
   virtual int32_t ogrecolor_lumination(uint32_t ogrecolor);

   //过滤字符串中的非法敏感字符
   virtual bool check_stringfilter(
       const STRING& in, 
       const vengine_ui::filtertype_enum type = vengine_ui::kFilterTypeNone);
   virtual bool check_stringcode(const STRING& in, STRING& out);
   //完全匹配过滤
   virtual bool check_string_fullcompare(const STRING& in, 
                                         const STRING& filtertype = "all", 
                                         bool use_alltable = true);
   virtual STRING get_debugstring();

   //取当前的鼠标下面的窗口
   virtual void openwindow(const STRING& name);
   virtual void closewindow(const STRING& name);
   virtual void togglewindow(const STRING& name);

   virtual bool has_inputfocus();

   //加聊天信息(提高显示聊天信息的效率)
   virtual bool add_chathistory_message(int32_t id,
                                        const char* windowname, 
                                        const char* message, 
                                        int32_t type = -1, 
                                        uint32_t disappeartime = 0);
   virtual void replacestring_usefilter(
       const STRING& in, 
       STRING& out, 
       vengine_ui::filtertype_enum filtertype = vengine_ui::kFilterTypeChat);
   virtual STRING check_stringvalid(const char* string);
   virtual bool reload_windowscript(const STRING& windowname);
   virtual void uirender_toggleshow();

 public:
   virtual void init(void*);
   virtual void release();
   virtual void tick();

 public:
   virtual bool is_ctrlinfo_enable();
   virtual void set_ctrlinfo_enable(bool enable);
 
 public: //action buttons
   vgui_icon::Manager* get_iconmanager();
   //捕获拖动开始
   bool handle_action_dragdrop_started(const CEGUI::EventArgs& event);
   //鼠标进入,显示super tooltip
   bool handle_actionbutton_mouseenter(const CEGUI::EventArgs& event);
   //鼠标离开,隐藏super tooltip
   bool handle_actionbutton_mouseleave(const CEGUI::EventArgs& event);
   //父窗口关闭
   bool handle_actionbutton_parenthidden(const CEGUI::EventArgs& event);
   //mesh window开始显示
   bool handle_meshwindow_shown(const CEGUI::EventArgs& event);
   //mesh window隐藏
   bool handle_meshwindow_hiden(const CEGUI::EventArgs& event);

 public: //超链接
   bool handle_hyperlink_active(const CEGUI::EventArgs &event);
   bool handle_hyperlink_leftactive(const CEGUI::EventArgs &event);
   bool handle_hyperlink_rightactive(const CEGUI::EventArgs &event);
   bool handle_hyperlink_inactive(const CEGUI::EventArgs &event);

 public:
   //删除itemelement的通知相关
   bool handle_elementdelete(const CEGUI::EventArgs &event);
   //chat history 点击infoelement的通知
   bool handle_chathistory_infoelement_click(const CEGUI::EventArgs& event);
   //chat history 鼠标在infoelement的通知
   bool handle_chathistory_infoelement_movein(const CEGUI::EventArgs& event);
   bool handle_chathistory_infoelement_moveout(const CEGUI::EventArgs& event);
   //click sound 对应按钮点击后播放声音
   bool handle_pushbutton_clicksound(const CEGUI::EventArgs& event);

 protected:
   Ogre::Root* ogreroot_;
   CEGUI::System* cegui_system_;
   CEGUI::OgreCEGUIRenderer* cegui_render_;
   vgui_script::Base* script_;
   vgui_window::Manager* windowmanager_;
   vgui_icon::Manager* iconmanager_;
   vgui_string::System* stringsystem_;
   vgui_creature::head_board::System* creature_headboard_system_;
   CEGUI::String buttonname_indragging_; 
   bool is_dragend_;
   HCURSOR draggingcursor_;
   bool active_paopao_;
   bool is_ctrlinfo_enable_; //是否激活按住Ctrl键激活系统设置中所见所得功能
                             //是否用快捷键的设置,在游戏性设置部分
   
 protected:
   static System* self_;

 protected:
   void on_dragbegin(CEGUI::FalagardActionButton* dranggingbutton_);
   //拖动结束,targetbutton为目标button如果为空,则表示拖动到空白
   void on_dragend(CEGUI::Window* targetwindow);

};

}; //namespace vgui_base

#endif //VGUI_BASE_SYSTEM_H_

解释

  在讲述这里面的接口之前,我不得不吐槽一下园子了,最近发出的博文都无法正常进入首页了,里面就算不乏图文并茂的文章,其程度一直让博主觉得有些心灰意懒了。首先说发布博文的原因,那就是同大家交流与分享知识,没有太多别的目的。对于最近几天园子管理的调整,我也无心过问,但是我真心希望大家能够分享出一些能让大家进步的文章,也喜欢园子的管理能够发现这些文章并给予推广。

  下面开始讲这部分的内容,最近在忙着写plain framework的参考手册,所以也就无暇来做之前的这些知识分享。而且客户端的部分,我觉得把这些重要接口展示给大家,大家如果能完全了解的话对于设计方面就已足够了,至于源码我会在讲解完这些接口后放出,所以大家不会担心。

  基础系统提供了比较全面的UI操作接口,包括界面的显示与界面事件的控制。里面牵扯到几个重要的系统,包括OGRE、CEGUI、CEGUI RENDER、SCRIPT、窗口管理器、图标管理器、字符串管理器、角色面板管理器等等。

链接

  最近在忙着整理plain framework框架的文档,但是文章被移出了首页,如果有兴趣的朋友不妨看看:http://www.cnblogs.com/lianyue/p/3972492.html

posted @ 2014-09-15 14:07  恋月  阅读(1443)  评论(0编辑  收藏  举报