minetest源码解析三：菜单响应以及核心函数介绍

菜单响应以及核心函数介绍

一 流程图

二 流程图中涉及到的核心函数介绍

1.点击响应鼠标事件

在device->run()控制的循环体内，一直循环，当有鼠标事件时，CIrrDevice::run()->CIrrDevice::postEventFromUser()->CGUIEnvironment::postEventFromUser()->CGUITabControl:onEvent()->GUIFormSpecMenu::OnEvent()->acceptInput()->TextDestGuiEngine::gotText->ScriptApiMainMenu::handleMainMenuButtons()

第一个代码中可以控制接受到的event事件是GUIFormSpecMenu::OnEvent()

主要涉及函数

acceptInput()

{

…

m_text_dst->gotText(fields);

}

这里的m_text_dst就是最初创建的TextDestGuiEngine对象。可以执行如下操作,最终更改了m_formspecgui存的控件以及控件属性值。

void TextDestGuiEngine::gotText(std::map<std::string,std::string> fields)

{

m_engine->getScriptIface()->handleMainMenuButtons(fields);

}

void ScriptApiMainMenu::handleMainMenuButtons(std::map<std::string,std::string> fields)

{

…

// Call it

if (lua_pcall(L,1,0,m_errorhandler))

scriptError();

}

int ModApiMainMenu::l_update_formspec(lua_State *L)

{

if (engine->m_formspecgui !=0) {

engine->m_formspecgui->setForm(formspec);

}

}

2.CGUIEnvironment绘制

流程如下：CGUIEnvironment::drawAll()->IGUIElement:draw()->GUIModalMenu:draw()->GUIFormSpecMenu:drawMenu()-> 获取m_form_src->getForm()，即m_formspecgui刚刚响应界面后设置的值->regenerateGui()->parseElement()->parseButton()->Environment->addButton()

主要涉及函数

void GUIFormSpecMenu::drawMenu()

{

if(m_form_src)

{

std::string newform =m_form_src->getForm();

if(newform !=m_formspec_string)

{

m_formspec_string = newform;

regenerateGui(m_screensize_old);

}

}

…

}