[IrrLicht/中文/例子]IrrLicht 例子的中文讲解 - Tutorial 2: Quake 3 Map

[IrrLicht/中文/例子]IrrLicht 例子的中文讲解 - Tutorial 2: Quake 3 Map

from  http://www.cppblog.com/irrwowview/articles/55310.html
--------------------------------------------------
Tutorial 2: Quake 3 Map
这个教程演示如何在引擎中加载一个Quake3地图，创建场景节点（SceneNode）来优化渲染速度和如何创建一个受用户控制的摄像机。请注意，在开始这个教程前你应该有本引擎的基础。如果没有，请大概看一下第一个教程， 1. HelloWorld。
本例子的效果图如下:






Lets start!（教程开始）

根据HelloWorld设置好IDE，并在代码中包含引擎的头文件。
还加上控制器程序要使用的头文件比较。

#include <irrlicht.h>
#include <iostream>


正如引擎中的HelloWorld例子那样,引擎中的所有东西都包含在命名空间“irr“中。我们可以告诉编译器，从现在开始使用irr作为命名空间，则可以在类的前面省去irr::。
还有5个子命名空间'core', 'scene', 'video', 'io' 和 'gui'。我们不像HelloWorld那样使用'using namespace'把5个命名空间添加到代码，因此会在代码的类前加上相应的命名空间前缀。你还是可以像以前的例子那样在代码中包含那命名空间。代码正 如你想的那样。

using namespace irr;


再说一次，我们要链接IrrLicht.lib才可以使用IrrLicht.dll。可以在项目中设置，但为了简单也可如下设置：

#pragma comment(lib, "Irrlicht.lib")


很好。我们还是使用main函数作为程序的开始，而不使用WinMain，因为代码能更短。

int main()
{


好像HelloWorld例子那样，我们使用createDevice（）函数创建一个IrrlichtDevice。有所不同的是要求用户选择 一种硬件加速驱动（hardware accelerated driver）。软件驱动(Software driver)实在太慢以至不能用于绘制Quake3的大地图，但作为消遣，还是加上这个选项。

// ask user for driver

video::E_DRIVER_TYPE driverType = video::EDT_DIRECT3D9;

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) Apfelbaum 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_SOFTWARE2;break;
  case 'f': driverType = video::EDT_NULL;    break;
  default: return 1;
}       

// create device and exit if creation failed

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

if (device == 0)
  return 1;


获取视频驱动（video driver）和场景管理器（SceneManager）的指针，则不必经常调用device->getVideoDriver()和device->getSceneManager()。

video::IVideoDriver* driver = device->getVideoDriver();



scene::ISceneManager* smgr = device->getSceneManager();


要显示Quake3的地图，我们首先要加载它。Quake3的地图被打包成一种等同于*.zip格式的*.pk3文件里。则我们加载*.pk3文件到引擎的文件系统。添加进文件系统后，我们能够读取存放在硬盘中的文件。

device->getFileSystem()->addZipFileArchive("../../media/map-20kdm2.pk3");


现在我们可以调用getMesh（）函数加载网格（mesh）文件，并返回一个IAnimatedMesh类型的指针。正如你所知道的， Quake3地图不能活动的，它们只是一个附上材质的具大静态几何型。因此IAnimatedMesh只包含一帧，而获得这个“动画 （animation）”的“第一帧（first frame）”是我们的quake level（地震级数？）和根据它调用addOctTreeSceneNode（）函数创建一个八叉数（OctTree）场景节点。
八叉数尝试只绘制当前看到的几何型来有一点优化场景。另一种代替八叉树（OctTree）的是活动网格场景节点 （AnimatedMeshSceneNode），它会没优化，只会把整个网格几何型绘制出来。试试这样:用 addAnimatedMeshSceneNode（）函数代替addAnimatedMeshSceneNode（）函数并作一下比较 （IVideoDriver类里有一个getPrimitiveCountDrawed（）函数）。注意八叉树（OctTree）优化只在大型网格地图时 有效。

scene::IAnimatedMesh* mesh = smgr->getMesh("20kdm2.bsp");
scene::ISceneNode* node = 0;







if (mesh)
    node = smgr->addOctTreeSceneNode(mesh->getMesh(0));


因为原点（0，0，0）周围无模型，我们改变了一下坐标。

if (node)
    node->setPosition(core::vector3df(-1300,-144,-1249));


现在我们只需要一个摄像机就可以观察Quake3的地图。而又想创建一个可以控制的摄像机。在IrrLicht引擎中有几种摄像机。For example the Maya Camera which can be controlled compareable to the camera in Maya: Rotate with left mouse button pressed, Zoom with both buttons pressed,
translate with right mouse button pressed. This could be created with addCameraSceneNodeMaya(). 但在这个例子中，我们创建了一个类似第一人称射击（first person shooter (FPS)）游戏的摄像机:

smgr->addCameraSceneNodeFPS();


要使鼠标的光标不显示，我们隐藏了鼠标。

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


我们已经准备好一切，开始绘制它。我们在窗口的标题栏加上当前的FPS（frames per second）。'if (device->isWindowActive())' 这一行是一个判断, 防止其它程序激活时，引擎渲染鼠标光标（锁定鼠标）。

int lastFPS = -1;

while(device->run())



{



  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;



  }



}


最后，删除IrrLicht设备。

  device->drop();
  return 0;
}


就这样，编译和演示一下这程序吧。