Irrlicht学习备忘录——9 Meshviewer
9 Meshviewer
官方代码($sdk)\examples\09.Meshviewer
切换两种不同的摄象机。切换摄像机其实很简单，场景管理器里已经提供了现成的方法setActiveCamera(摄像机)，使用此方法就行了，不过需要注意一点就是，FPS和Maya摄像机已经提供了用户控制摄像机位置和视角的功能，在切换前应该设置摄像机是否接收输入。例子中将这功能写出了setActiveCamera方法，方便以后调用。
//设置活动摄像机，参数为摄像机场景节点
void setActiveCamera(scene::ICameraSceneNode* newActive)
{
// Device是全局变量，使用的irr设备
if (0 == Device)
return;
//通过场景管理器获取当前的活动摄像机
scene::ICameraSceneNode * active = Device->getSceneManager()->getActiveCamera();
//将当前的活动摄像机接收输入功能关闭
active->setInputReceiverEnabled(false);
//将替换摄像机接收输入功能开启
newActive->setInputReceiverEnabled(true);
//使用场景管理器将替换摄像机设为当前活动摄像机
Device->getSceneManager()->setActiveCamera(newActive);
}
setSkinTransparency设置GUI皮肤透明度，这个基本没什么好说的，例子05.UserInterface中已经出现过，只是这次把它写成了一个函数，成了一个功能模块，以后好调用。第一个参数是透明度，第二个是要修改的GUI皮肤。
void setSkinTransparency(s32 alpha, irr::gui::IGUISkin * skin)
{
for (s32 i=0; i<irr::gui::EGDC_COUNT ; ++i)
{
video::SColor col = skin->getColor((EGUI_DEFAULT_COLOR)i);
col.setAlpha(alpha);
skin->setColor((EGUI_DEFAULT_COLOR)i, col);
}
}
updateScaleInfo更新模型的缩放比例信息。也就是将模型的显示比例，以直观的数字显示到GUI上。传入场景节点做参数。以前例子里没用到的功能有，场景节点的getScale，这个看名称也就知道，获取缩放比例，没什么好说的；还有个就是GUI元素里的getElementFromId，这个是获取GUI元素下指定ID的子元素，这个功能在文件存储和载入GUI界面时很有用。
void updateScaleInfo(scene::ISceneNode* model)
{
//获取工具箱窗口
IGUIElement* toolboxWnd = Device->getGUIEnvironment()->getRootGUIElement()->getElementFromId(GUI_ID_DIALOG_ROOT_WINDOW, true);
//如果没有工具箱窗口，信息也就不用显示了，直接退出
if (!toolboxWnd)
return;
if (!model)//场景节点不存在
{
//设置编辑框内XYZ三个轴方向缩放比例的显示文字为“-”
toolboxWnd->getElementFromId(GUI_ID_X_SCALE, true)->setText( L"-" );
toolboxWnd->getElementFromId(GUI_ID_Y_SCALE, true)->setText( L"-" );
toolboxWnd->getElementFromId(GUI_ID_Z_SCALE, true)->setText( L"-" );
}
else//场景节点存在
{
//获取场景节点的缩放比例
core::vector3df scale = model->getScale();
//设置编辑框内XYZ三个轴方向缩放比例
toolboxWnd->getElementFromId(GUI_ID_X_SCALE, true)->setText( core::stringw(scale.X).c_str() );
toolboxWnd->getElementFromId(GUI_ID_Y_SCALE, true)->setText( core::stringw(scale.Y).c_str() );
toolboxWnd->getElementFromId(GUI_ID_Z_SCALE, true)->setText( core::stringw(scale.Z).c_str() );
}
}
showAboutText这个函数没什么好说的，就是添加一个消息对话框。
loadModel这个的代码也太长了，其实还可以细分成几个函数，那样看起来就容易多了。
它用来从文件载入一个模型，传入参数为文件名。这里面又有irr的文件系统操作了，值得看看。
void loadModel(const c8* fn)
{
//创建个文件路径和文件扩展名
io::path filename(fn);
io::path extension;
//获取文件扩展名
core::getFileNameExtension(extension, filename);
//将扩展名转为小写字母
extension.make_lower();
// 如果文件名是支持的纹理格式
if (extension == ".jpg" || extension == ".pcx" ||
extension == ".png" || extension == ".ppm" ||
extension == ".pgm" || extension == ".pbm" ||
extension == ".psd" || extension == ".tga" ||
extension == ".bmp" || extension == ".wal" ||
extension == ".rgb" || extension == ".rgba")
{
//创建纹理，这个前面的例子里出现很多次了
video::ITexture * texture =
Device->getVideoDriver()->getTexture( filename );
if ( texture && Model )
{
// 重新加载纹理
Device->getVideoDriver()->removeTexture(texture);
texture = Device->getVideoDriver()->getTexture( filename );
//设置模型的纹理
Model->setMaterialTexture(0, texture);
}
//纹理文件处理结束，退出
return;
}
//如果是压缩文件，就把它放置到文件管理器系统中进行处理
else if (extension == ".pk3" || extension == ".zip" || extension == ".pak" || extension == ".npk")
{
Device->getFileSystem()->addFileArchive(filename.c_str());
//压缩文件处理结束，退出
return;
}
//将模型载入到引擎
//如果已经存在模型，就移除它
if (Model)
Model->remove();
Model = 0;
//如果是.irr场景文件
if (extension==".irr")
{
//创建一个场景节点列表
core::array<scene::ISceneNode*> outNodes;
//通过场景管理器载入场景文件
Device->getSceneManager()->loadScene(filename);
//筛选出AnimatedMeshSceneNode节点
Device->getSceneManager()->getSceneNodesFromType(scene::ESNT_ANIMATED_MESH, outNodes);
//将第一个符合条件的场景节点做为模型
if (outNodes.size())
Model = outNodes[0];
//irr场景文件处理结束，退出
return;
}
//载入一个AnimatedMesh模型
scene::IAnimatedMesh* m = Device->getSceneManager()->getMesh( filename.c_str() );
if (!m)
{
// 如果模型 Load 失败，则弹出警告窗口
if (StartUpModelFile != filename)
Device->getGUIEnvironment()->addMessageBox(
Caption.c_str(), L"The model could not be loaded. " \
L"Maybe it is not a supported file format.");
return;
}
//如果允许使用八叉树，就已八叉树场景节点载入
if (Octree)
Model = Device->getSceneManager()->addOctreeSceneNode(m->getMesh(0));
else
{
//载入动画节点，并将动画速度设为30
scene::IAnimatedMeshSceneNode* animModel = Device->getSceneManager()->addAnimatedMeshSceneNode(m);
animModel->setAnimationSpeed(30);
Model = animModel;
}
// 设置默认材质属性
Model->setMaterialFlag(video::EMF_LIGHTING, UseLight);
Model->setMaterialFlag(video::EMF_NORMALIZE_NORMALS, UseLight);
// Model->setMaterialFlag(video::EMF_BACK_FACE_CULLING, false);
Model->setDebugDataVisible(scene::EDS_OFF);
// 取消菜单中选项
gui::IGUIContextMenu* menu = (gui::IGUIContextMenu*)Device->getGUIEnvironment()->getRootGUIElement()->getElementFromId(GUI_ID_TOGGLE_DEBUG_INFO, true);
if (menu)
for(int item = 1; item < 6; ++item)
menu->setItemChecked(item, false);
//更新缩放信息
Updatescaleinfo(Model);
}
createToolBox创建工具箱窗口，窗口上主要就是有一个标签页，在标签页上有三个显示模型缩放比例的编辑框，还有两个滑动条用来控制GUI透明度，和模型动画速度。里面用到的GUI元素，前面的例子基本都用过，首次出现的只有标签元素。要使用标签页，首先需要在窗口上添加一个IGUITabControl元素，它用来控制标签页的切换；然后就是在IGUITabControl上添加IGUITab元素。IGUITab就是真正的标签页面，需要在页面上怎么什么内容，就是直接在把新添加的GUI元素的父节点设为IGUITab就可以了。具体关键代码如下
// 创建工具箱窗口
IGUIWindow* wnd = env->addWindow(core::rect<s32>(600,45,800,480),false, L"Toolset", 0, GUI_ID_DIALOG_ROOT_WINDOW);
//创建标签控制元素
IGUITabControl* tab = env->addTabControl(core::rect<s32>(2,20,800-602,480-7), wnd, true, true);
//创建一个标签页面
IGUITab* t1 = tab->addTab(L"Config");
//添加一个静态文本框到标签页面
env->addStaticText(L"Scale:",core::rect<s32>(10,20,60,45), false, false, t1);
//添加一个文本编辑框到标签页面
env->addEditBox(L"1.0", core::rect<s32>(40,46,130,66), true, t1, GUI_ID_X_SCALE);
//添加一个按钮到标签页面
env->addButton(core::rect<s32>(10,134,85,165), t1, GUI_ID_BUTTON_SET_SCALE,L"Set");
//添加一个滑动条
IGUIScrollBar* scrollbar = env->addScrollBar(true,core::rect<s32>(10,225,150,240), t1,GUI_ID_SKIN_TRANSPARENCY);
updateToolBox更新工具箱信息。这个函数的功能就只是更新模型动画的帧速。里面首次使用的有IAnimatedMeshSceneNode的getAnimationSpeed方法和getFrameNr方法。getAnimationSpeed返回的动画模型节点的动画帧速，getFrameNr方法返回的是当前节点的显示动画帧序号。
onKillFocus当户用移动摄像机时按下ALT+Tab，强制FPS摄像机继续移动。我也没搞明白这段代码有什么用。看代码里的注释，它就是发送irr的按键事件给摄像机的运动器，使摄像机继续运动。但代码里设置按键按下标志确是false，跟注释描述的功能似乎刚好相反。没搞懂就不研究它了。
hasModalDialog检查当前是否有一个modal对话框。使用IGUIEnvironment的getFocus可以获取当前焦点所在的GUI元素；使用IGUIElement的isVisible方法可以判断该元素是否显示，用hasType可以判断是否有相关类型的GUI元素，通过getParent可以得到该GUI元素的父元素。在hasModalDialog里，通过当前拥有焦点的GUI元素，不断逐级向父元素查询是否有EGUIET_MODAL_SCREEN类型的GUI元素，直到查到modal对话框或已到GUI跟元素。
MyEventReceiver类，这个在05.UserInterface里已经出现过了，用户自定义的事件接收器。里面就是根据相应的GUI事件做出相应的控制，没什么好说明的。
OnKeyUp这个算是自己设计热键，根据那个按键弹起，做出相应的事件处理。它在MyEventReceiver类中EET_KEY_INPUT_EVENT事件处理处被调用。
OnMenuItemSelected用来处理选择菜单项目事件，里面根据预设的GUI元素的ID来判断具体是哪个菜单项被选择中，让后做出相应的事件处理。它同样在MyEventReceiver类中 被调用，不同的是选择菜单项目事件是EGET_MENU_ITEM_SELECTED。
OnTextureFilterSelected纹理材质过滤选择。这个函数就是相应纹理过滤的下拉列表的事件。通过IGUIComboBox的getSelected可以知道具体是第几个下拉列表项被选中。设置不同的纹理材质过滤，其实用的就是场景节点的setMaterialFlag，打开或关闭相应的材质标志。IGUIComboBox触发的事件是EGET_COMBO_BOX_CHANGED。
最后要看的代码就是main函数了。这里面大部分代码都很熟悉，前面的例子中就出现过 。已经熟悉的东西就不再研究了，只看新鲜的东西。
smgr->getParameters()->setAttribute(scene::COLLADA_CREATE_SCENE_INSTANCES, true)；//获取场景管理器的参数，设置COLLADA_CREATE_SCENE_INSTANCES属性。这个属性设置了有什么用，我真搞不明白，设不设似乎都没影响。
smgr->setAmbientLight(video::SColorf(0.3f,0.3f,0.3f));//设置环境光
Device->getFileSystem()->addFileArchive("../../media/");//添加一个文件存档
io::IXMLReader* xml = Device->getFileSystem()->createXMLReader( L"config.xml");//这个比较有用，它irr的xml解析器。从irr的文件系统可以创建xml解析器。IXMLReader的read方法，将IXMLReader移动到下一个xml节点；getNodeType 方法获取节点的类型；getNodeName 方法获取节点名字；getAttributeValue 获取节点的属性。
//循环读取下一个xml节点
while(xml && xml->read())
{
//获取节点类型
switch(xml->getNodeType())
{
case io::EXN_TEXT://文本节点
//获取文本节点内容
MessageText = xml->getNodeData();
break;
case io::EXN_ELEMENT://xml元素
{
//如果是startUpModel元素，将元素中file属性的值赋值给StartUpModelFile
if (core::stringw("startUpModel") == xml->getNodeName())
StartUpModelFile = xml->getAttributeValue(L"file");
//如果是messageText 元素，将元素中caption 属性的值赋值给Caption
else if (core::stringw("messageText") == xml->getNodeName())
Caption = xml->getAttributeValue(L"caption");
}
break;
default:
break;
}
}
前面GUI的例子中没有教使用菜单，在这例子里有了。
//通过GUI环境添加一个菜单
gui::IGUIContextMenu* menu = env->addMenu();
//给IGUIContextMenu 添加项目
menu->addItem(L"File", -1, true, true);//文件菜单
menu->addItem(L"View", -1, true, true);//查看菜单
menu->addItem(L"Camera", -1, true, true);//摄像机菜单
menu->addItem(L"Help", -1, true, true);//帮助菜单
//获取第一个菜单项目，在项目下添加子项目
gui::IGUIContextMenu* submenu;
submenu = menu->getSubMenu(0);
submenu->addItem(L"Open Model File & Texture...", GUI_ID_OPEN_MODEL);
submenu->addItem(L"Set Model Archive...", GUI_ID_SET_MODEL_ARCHIVE);
submenu->addItem(L"Load as Octree", GUI_ID_LOAD_AS_OCTREE);
submenu->addSeparator();
submenu->addItem(L"Quit", GUI_ID_QUIT);
前面的例子中同样没有使用GUI的工具栏和下拉列表。这里看看工具栏和下拉列表如何使用。
//添加一个工具栏
gui::IGUIToolBar* bar = env->addToolBar();
//创建一个工具按钮图标的纹理
video::ITexture* image = driver->getTexture("open.png");
//添加一个工具按钮
bar->addButton(GUI_ID_BUTTON_OPEN_MODEL, 0, L"Open a model",image, 0, false, true);
//添加一个下拉列表
gui::IGUIComboBox* box = env->addComboBox(core::rect<s32>(250,4,350,23), bar, GUI_ID_TEXTUREFILTER);
//添加下拉列表项目
box->addItem(L"No filtering");
box->addItem(L"Bilinear");
box->addItem(L"Trilinear");
box->addItem(L"Anisotropic");
box->addItem(L"Isotropic");
还有个天空盒场景节点在前面的例子中也没有出现过。在场景中，最远处的景色因距离太远，一般不会随摄像机的移动而发生改变，因此最远处的场景可以用静态的几幅图片来代替3D模型。在场景的最远处建立一个巨大的立方体或球体，把所有3D模型包围在这个几何体内，然后将远处场景的图片绑定到这个几何体上，摄像机在场景内移动，就能以最小的开销看到最远方法的景色，这就是天空盒或天空球。不过球体的贴图纹理一般不容易做，因此大部分时候见到的是使用天空盒。在irr里，制作天空盒的过程引擎已经帮实现好了，只需在场景管理器里调用addSkyBoxSceneNode方法，并设置好天空盒6个面的纹理就能把天空盒添加到场景里。
//添加一个天空盒场景节点。
SkyBox = smgr->addSkyBoxSceneNode(driver->getTexture("irrlicht2_up.jpg"),driver->getTexture("irrlicht2_dn.jpg"),driver->getTexture("irrlicht2_lf.jpg"), driver->getTexture("irrlicht2_rt.jpg"),driver->getTexture("irrlicht2_ft.jpg"),driver->getTexture("irrlicht2_bk.jpg"));
这个例子真够长啊，竟然总结了好久。写完竟然到光棍节了。//(ㄒoㄒ)// 这里祝各位跟我一样的光棍早日脱光！光棍节快乐！