这份指南将为你演示如何向引擎中载入一张Quake3地图文件，并且告诉你如何 最便捷优化的创建一个场景节点渲染，以及创建一个用户控制的摄象机。

/*
这份指南将为你演示如何向引擎中载入一张Quake3地图文件，并且告诉你如何
最便捷优化的创建一个场景节点渲染，以及创建一个用户控制的摄象机。

让我们象上一个HelloWorld例子一样做吧：首先包含Irr引擎头文件。
另外包含一个 iostream头为了方便用户的控制台输入。
*/
#include <irrlicht.h>
#include <iostream>

/*
类似于写HelloWorld例子之前需要做的准备一样，在Irrlicht引擎中，一切
函数，类命名都是在irr命名空间内的。我们依旧要告诉编辑器我们现在使用
的函数应当在irr命名空间内寻找。它有五个子命名空间，Core,Scene,Video,
Io,Gui.与HelloWorld不同的是，我们这里没有为五个子空间分别指定命名空间
的通知，因为这样做的话，在下面的代码中，你将更容易获知每个函数到底是属于
哪个命名空间内的。当然，你也可以加上using namespace XX;尽随你意了。
*/
using namespace irr;

/*
同样，为了可以使用Irrlicht.DLL文件，我们需要链接一个Irrlicht.lib文件，我们需要
进行项目设置，或者在代码中进行一次链接声明。
*/
#pragma comment(lib, "Irrlicht.lib")

/*
OK，我们开始。main()入口
*/
int main()
{
/*
类似HelloWorld例子，我们通过CreateDevice创建一个Irr设备，不过在这里我们允许
用户进行硬件加速设备的选择。其中软件模拟进行一次巨大的Q3场景的加载将会相当慢，
不过为了进行演示有这样一个功能，我们也把它列做选项了。
*/

video::E_DRIVER_TYPE driverType;

printf("Please select the driver you want for this example:\n"\
   " (a) Direct3D 9.0c\n (b) Direct3D 8.1\n (c) OpenGL 1.5\n"\
   " (d) Software Renderer\n (e) Burning's Software Renderer\n"\
   " (f) NullDevice\n (otherKey) exit\n\n");

char i;
std::cin >> i;

switch(i)
{
   case 'a': driverType = video::EDT_DIRECT3D9;break;
   case 'b': driverType = video::EDT_DIRECT3D8;break;
   case 'c': driverType = video::EDT_OPENGL;   break;
   case 'd': driverType = video::EDT_SOFTWARE; break;
   case 'e': driverType = video::EDT_BURNINGSVIDEO;break;
   case 'f': driverType = video::EDT_NULL;     break;
   default: return 1;
}

// 创建Irr设备

IrrlichtDevice *device =
   createDevice(driverType, core::dimension2d<s32>(640, 480));

if (device == 0)
   return 1;

/*
获取一个视频驱动和场景管理的指针。
*/
video::IVideoDriver* driver = device->getVideoDriver();
scene::ISceneManager* smgr = device->getSceneManager();

/*
为了显示QUAKE3的地图，我们首先需要读取它。
Quake3地图被打包在.pk3文件中，所以我们的文件系统需要加载.pk3包文件，
在我们加载它之后，我们还需要从包文件中对其进行读取。
*/
device->getFileSystem()->addZipFileArchive("../../media/map-20kdm2.pk3");

/*
现在我们可以通过调用getMesh()函数来进行Mesh的读取。我们获得了一个动画Mesh
IAnimatedMesh的指针。然而我们可能有疑问，Quake3地图并非一个动画，我们为什么要
使用IAnimatedMesh动画Mesh呢？我们先研究下Quake3的地图，它是由一个巨大的模型
以及一些贴图文件组成的。我们可以理解为，它是由一个动画组成，而这个动画仅有一桢，
所以我们获得动画的第一桢getMesh(0)(其中0就是指定桢数)，然后使用它创建一个八叉树场景节点。
八叉树的作用是对场景渲染进行优化，就是仅仅渲染摄象机所见的场景，这个请自行
查看3D渲染相关书籍。
相对于八叉树场景节点的另一种加载方式就是直接创建一个AnimatedMeshSceneNode，
动画Mesh场景节点，但是这样做的话就不会进行优化的拣选，它会一次性加载绘制所有的场景。
在下面的代码里，我两种类型都写了，你可以切换着进行尝试一下。
值得注意的是八叉树场景的适用范围一般是大型的室外场景加载。
*/
scene::IAnimatedMesh* mesh = smgr->getMesh("20kdm2.bsp");
scene::ISceneNode* node = 0;

if (mesh)
   /* 下面两行可更替进行编译 */
   //node = smgr->addOctTreeSceneNode(mesh->getMesh(0), 0, -1, 128);
   node = smgr->addAnimatedMeshSceneNode(mesh);

/*
我们将世界矩阵的原点进行一些平移以适应这个模型。
*/
if (node)
   node->setPosition(core::vector3df(-1300,-144,-1249));

/*
现在我们仅仅需要一个摄象机去观察这张地图。这次我们设计一个可用户控制的
灵活摄象机。在Irr引擎中有许多不同类型的摄象机：例如，Maya摄象机就类似于
Maya软件中的摄象机控制，左键按下可进行旋转，两键按下就可以进行缩放，
右键按下就可以进行移动。假如我们想创建这样操作方式的摄象机，那么只要
addCameraSceneNodeMaya()就可以了。而我们现在需要设计的摄象机则是类似于
标准FPS的控制设定，所以我们调用addCameraSceneNodeFPS()函数来创建。
*/
smgr->addCameraSceneNodeFPS();

/*
鼠标的图标没必要显示出来，所以我们设置其属性为隐藏。
*/

device->getCursorControl()->setVisible(false);

/*
我们做完了所有的事情，现在我们开始绘制它吧。我们还需要在窗口的标题上
显示当前的FPS。
if (device->isWindowActive()) 这一行代码是可选的，但是为了预防由于
切换活动窗口而导致引擎渲染桢速率显示不正确，还是加上吧。
*/
int lastFPS = -1;

while(device->run())
if (device->isWindowActive())
{
   driver->beginScene(true, true, video::SColor(0,200,200,200));
   smgr->drawAll();
   driver->endScene();

   int fps = driver->getFPS();

   if (lastFPS != fps)
   {
    core::stringw str = L"Irrlicht Engine - Quake 3 Map example [";
    str += driver->getName();
    str += "] FPS:";
    str += fps;

    device->setWindowCaption(str.c_str());
    lastFPS = fps;
   }
}

/*
最后，记得销毁Irr设备。
*/
device->drop();
return 0;
}