第二人生的源码分析(七十九)UI控制的类工厂

在游戏的程序里，界面的实现往往是比较复杂的。因为在游戏里，没有 WINDOWS的组件可以使用，也没有其合适的组件可以使用，所有界面的显示都需要从最原始的方式来实现，这样工作量非常庞大。下面就来分析第二生里实现UI的类厂，它的声明代码如下：

#001 class LLUICtrlFactory

#002 {

#003 public:

 

构造函数。

#004     LLUICtrlFactory();

#005     // do not call! needs to be public so run-time can clean up the singleton

 

析构函数。

#006     virtual ~LLUICtrlFactory() {}

#007 

 

查找到界面布局的 XML路径。

#008     void setupPaths();

#009    

 

创建浮动的界面层。

#010     void buildFloater(LLFloater* floaterp, const LLString &filename,

#011                     const LLCallbackMap::map_t* factory_map = NULL, BOOL open = TRUE);

 

创建控制板的界面层。

#012     BOOL buildPanel(LLPanel* panelp, const LLString &filename,

#013                     const LLCallbackMap::map_t* factory_map = NULL);

#014 

 

删除控制板的界面层。

#015     void removePanel(LLPanel* panelp) { mBuiltPanels.erase(panelp->getHandle()); }

 

删除浮动的界面层。

#016     void removeFloater(LLFloater* floaterp) { mBuiltFloaters.erase(floaterp->getHandle()); }

#017 

 

创建界面菜单。

#018     class LLMenuGL *buildMenu(const LLString &filename, LLView* parentp);

 

创建光滑的菜单。

#019     class LLPieMenu *buildPieMenu(const LLString &filename, LLView* parentp);

#020 

 

保存界面布局到 XML文件。

#021     // Does what you want for LLFloaters and LLPanels

#022     // Returns 0 on success

#023     S32 saveToXML(LLView* viewp, const LLString& filename);

#024 

#025 

 

重新建立界面布局。

#026     // Rebuilds all currently built panels.

#027     void rebuild();

#028 

 

获取控件的类型。

#029     static EWidgetType getWidgetType(const LLString& ctrl_type);

 

通过类型获取控件的名称。

#030     static LLString getWidgetType(EWidgetType ctrl_type);

 

获取控件的颜色。

#031     static BOOL getAttributeColor(LLXMLNodePtr node, const LLString& name, LLColor4& color);

#032 

 

下面通过名称来创建控件。

#033     // specific typed getters

#034     static class LLButton*              getButtonByName(        const LLPanel* panelp, const

#035 LLString& name);

#036     static class LLCheckBoxCtrl*        getCheckBoxByName(      const LLPanel* panelp, const LLString& name);

#037     static class LLComboBox*            getComboBoxByName(      const LLPanel* panelp, const LLString& name);

#038     static class LLIconCtrl*            getIconByName(          const LLPanel* panelp, const LLString& name);

#039     static class LLLineEditor*          getLineEditorByName(    const LLPanel* panelp, const LLString& name);

#040     static class LLRadioGroup*          getRadioGroupByName(    const LLPanel* panelp, const LLString& name);

#041     static class LLScrollListCtrl*      getScrollListByName(    const LLPanel* panelp, const LLString& name);

#042     static class LLSliderCtrl*          getSliderByName(        const LLPanel* panelp, const LLString& name);

#043     static class LLSlider*              getSliderBarByName(     const LLPanel* panelp, const

#044 LLString& name);

#045     static class LLSpinCtrl*            getSpinnerByName(       const LLPanel* panelp, const LLString& name);

#046     static class LLTextBox*             getTextBoxByName(       const LLPanel* panelp, const

#047 LLString& name);

#048     static class LLTextEditor*          getTextEditorByName(    const LLPanel* panelp, const LLString& name);

#049     static class LLTabContainer*        getTabContainerByName( const LLPanel* panelp, const LLString& name);

#050     static class LLScrollableContainerView* getScrollableContainerByName(const LLPanel* panelp, const LLString& name);

#051     static class LLPanel*               getPanelByName(         const LLPanel*

#052 panelp, const LLString& name);

#053     static class LLMenuItemCallGL*      getMenuItemCallByName( const LLPanel* panelp, const LLString& name);

#054     static class LLScrollingPanelList* getScrollingPanelList( const LLPanel* panelp, const LLString& name);

#055     static class LLMultiSliderCtrl*     getMultiSliderByName(   const LLPanel* panelp, const LLString& name);

#056     static class LLMultiSlider*         getMultiSliderBarByName(const LLPanel* panelp, const LLString& name);

#057 

#058     // interface getters

#059     static LLCtrlListInterface* getListInterfaceByName( const LLPanel* panelp, const LLString& name);

#060     static LLCtrlSelectionInterface* getSelectionInterfaceByName(const LLPanel* panelp, const LLString& name);

#061     static LLCtrlScrollInterface* getScrollInterfaceByName(const LLPanel* panelp, const LLString& name);

#062 

 

通过名称创建控制板。

#063     LLPanel* createFactoryPanel(LLString name);

#064 

 

根据 XML节点创建一个窗口。

#065     virtual LLView* createCtrlWidget(LLPanel *parent, LLXMLNodePtr node);

#066     virtual void createWidget(LLPanel *parent, LLXMLNodePtr node);

#067 

#068     template <class T> T* createDummyWidget(const LLString& name)

#069     {

#070         return NULL;

#071         //static LLPanel dummy_panel;

#072         //LLXMLNodePtr new_node_ptr = new LLXMLNode(T::getWidgetTag(), FALSE);

#073         //return createWidget(&dummy_panel, new_node_ptr);

#074     }

#075 

 

 

注册创建的回调函数。

#076     // Creator library

#077     typedef LLView* (*creator_function_t)(LLXMLNodePtr node, LLView *parent, LLUICtrlFactory *factory);

#078     void registerCreator(LLString ctrlname, creator_function_t function);

#079 

 

通过名称获取 XML根节点。

#080     static bool getLayeredXMLNode(const LLString &filename, LLXMLNodePtr& root);

#081 

#082 protected:

#083 

#084     template<class T>

#085     class LLUICtrlCreator

#086     {

#087     public:

#088         static void registerCreator(LLString name, LLUICtrlFactory *factory)

#089         {

#090             factory->registerCreator(name, T::fromXML);

#091         }

#092     };

#093 

#094 private:

#095 

#096     typedef std::map<LLHandle<LLPanel>, LLString> built_panel_t;

#097     built_panel_t mBuiltPanels;

#098     typedef std::map<LLHandle<LLFloater>, LLString> built_floater_t;

#099     built_floater_t mBuiltFloaters;

#100 

#101     std::deque<const LLCallbackMap::map_t*> mFactoryStack;

#102 

#103     static const LLString sUICtrlNames[];

#104 

#105     typedef std::map<LLString, creator_function_t> creator_list_t;

#106     creator_list_t mCreatorFunctions;

#107     static std::vector<LLString> mXUIPaths;

#108  };