蔡军生先生第二人生的源码分析(七十九)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  };