OGRE基础教程1

OGRE基础教程1

简介：本教程基于Ogre Wiki上的Basic Tutorial系列，并依据笔者使用的vs2005+sp1+OgreSDK1.4.3开发环境简化整理而来，其中穿插着笔者自己的理解。这是教程的第一部分，也是我的学习笔记。

正文：凡是翻译过几篇技术类文章的人都深知从头至尾忠实重现作者的原意是一件多么令人头疼的事情。当我从诸多曾经许诺要翻译的文章中爬出来的时候，我决定这次不做那样一个“傻子”，重写那些文章要比翻译它们快乐的多。

在开始前，我希望统一我们的开发环境——VS2005+OgreSDK1.4.3。有两点需要注意：
一、请确认你的VS2005安装了sp1补丁包，这一点非常重要，否则你可以正确的编译Ogre程序，但你死活运行不起它们来。
二、请确认你的Ogre是合适的版本，也就是OGRE 1.4.3 SDK for Visual C++ .Net 2005(8.0)SP1，你可以从http://www.ogre3d.org/index.php?option=com_content&task=view&id=411&Itemid=131免费获得。

创建你的第一个Ogre应用程序

现在，对表之后，行动开始。哦，等一下，忘了给你们发枪了。请到http://ogreconglo.sourceforge.net/phpBB2/viewtopic.php?p=4领取枪械。是Ogre产的Ogre Application Wizard，不要着急，人人都有。把它解压到合适的位置，我推荐的位置当然是OgreSDK目录下了，然后运行里面的VC8_Setup.js安装。兄弟们，准备好了吗？现在行动真的要开始了。

打开vs2005，新建一个项目，"文件"->"新建"->"项目"->"Visual C++"，在"Visual Studio已安装的模板"选择"OGRE SDK Application"。设置好工程名和存储路径后点"确定"按钮。

弹出了向导，选项保持默认就好了，点"finish"完成。

是不是个Win32项目的向导一样简单？下面按F7编译一下。

如果没有操作失误的话，会得到这样的结果

------  已启动生成: 项目: test1, 配置: Debug Win32  ------
正在编译...
test1.cpp
正在编译资源...
正在编译资源清单...
正在链接...
正在嵌入清单...
Copying exe to samples bin directory ...
已复制          1  个文件。
生成日志保存在“file: // d:GameDevelop est1 est1objDebugBuildLog.htm”
test1  -   0  个错误， 0  个警告
==========  生成:  1  已成功,  0  已失败,  0  最新,  0  已跳过  ==========

运行却会出现如图的错误，缺少相应的文件，运行不起来。一种解决办法是把缺少的文件复制过来，但你必须知道需要什么文件，不适合新手。另一种方法是，你注意到“Copying exe to samples bin directory ...”一句了吗？EXE文件拷贝到哪里去了？拷贝到“\OgreSDK\bin\debug”中去了，找到了吗？运行试试，成功了吧。

揭开向导的面纱

你可能在想Ogre Application Wizard(之后简称OAW)到底做了什么呢？就像当初我使用Win32应用程序向导创建了那个HelloWorld之后想的一样。其实OAW只做了两件事，一是创建了几个源文件，另一个是设置了IDE的参数，这也是最重要的一步。下面我们来手动做一次OAW做的事情，以便加深印象，为了以后的方便又一小部分操作是不同的。

关闭刚才的解决方案，新建一个项目，"文件"->"新建"->"项目"->"Visual C++"->"Win32"，在"Visual Studio已安装的模板"选择"Win32项目"。设置好工程名和存储路径后点"确定"按钮。（我用的工程名和解决方案名都是test2，路径名为D:\GameDevelop）

在向导的"应用程序设置"中选择"Windows应用程序"和"空项目"，点击完成。

除了几个工程文件，向导没再多做任何事情。为了这个项目的独立性与方便性，我们还要复制"\OgreSDK"下的"\bin"和"\media"到"D:\GameDevelop\test2"里，并创建"include"、"src"和"scripts"，这样你在"D:\GameDevelop\test2"下将看到6个文件夹。

然后创建一个"SampleApp.cpp"，保存路径为"D:\GameDevelop\test2\src"，内容如下：

#include  " ExampleApplication.h "

class  TutorialApplication :  public  ExampleApplication
{
protected:
public:
    TutorialApplication()
    {
    }

    ~TutorialApplication() 
    {
    }
protected:
    void createScene(void)
    {
    }
} ;

#if  OGRE_PLATFORM == OGRE_PLATFORM_WIN32
#define  WIN32_LEAN_AND_MEAN
#include  " windows.h "

INT WINAPI WinMain( HINSTANCE hInst, HINSTANCE, LPSTR strCmdLine, INT )
#else
int  main( int  argc,  char   ** argv)
#endif
{
    // Create application object
    TutorialApplication app;

    try {
        app.go();
    } catch( Exception& e ) {
#if OGRE_PLATFORM == OGRE_PLATFORM_WIN32 
        MessageBoxA( NULL, e.getFullDescription().c_str(), "An exception has occurred!", MB_OK | MB_ICONERROR | MB_TASKMODAL);
#else
        fprintf(stderr, "An exception has occurred: %s ",
                e.getFullDescription().c_str());
#endif
    }

    return 0;
}

保存，按F7编译一下。

------  已启动生成: 项目: test2, 配置: Debug Win32  ------
正在编译...
SampleApp.cpp
d:gamedevelop est2srcsampleapp.cpp( 1 ) : fatal error C1083: 无法打开包括文件:“ExampleApplication.h”: No such file or directory
生成日志保存在“file: // d:GameDevelop est2 est2DebugBuildLog.htm”
test2  -   1  个错误， 0  个警告
==========  生成:  0  已成功,  1  已失败,  0  最新,  0  已跳过  ==========

出错了，找不到"ExampleApplication.h"。其中的"ExampleApplication"又是什么呢？它是Ogre为初学者设计的实例程序类（可能是个程序框架什么的，我是这么理解的），以便你可以快速的开始Ogre编程的学习。"ExampleApplication.h"在"\OgreSDK\samples\include"下。默认情况下，IDE是不会找到这里的。还记得我说过Ogre程序向导做过什么吗？对了，设置我们的IDE环境。下面我们就来一步步地把IDE设置好。

"项目"->"属性"，打开"test2 属性页"，展开"配置属性"。设置：
"调试"->"工作目录"为"..\bin\Debug"，
"C/C++"->"常规"->"附加包含目录"中添加"..\include"、"$(OGRE_HOME)\include"和"$(OGRE_HOME)\samples\include"，
"C/C++"->"代码生成"->"运行时库"为"多线程调试 DLL (/MDd)"（这个好像就是默认的），
"链接器"->"常规"->"输出文件"为"..\bin\Debug\$(ProjectName).exe"，
"链接器"->"常规"->"附加库目录"中添加"$(OGRE_HOME)\lib"，
"链接器"->"输入"->"附加依赖项"中添加"OgreMain_d.lib"和"OIS_d.lib"（如果是Release版则添加"OgreMain.lib"和"OIS.lib"）

设置好了，再编译一次试试。如果你看懂了以上部分，并且编译通过的话，我们就可以继续了，之后的内容将修改前面这个程序来向你展示Ogre的世界。

OGRE是如何工作的

SceneManager、Entity和SceneNode是Ogre的3个基础模块。

其中SceneManager是管理者，所有显示在屏幕上的东西都由SceneManager管理。SceneManager的类型众多，随着教程的推进，你会慢慢的了解它。

Entity就是你想要渲染的物体的模型，它们使用mesh（Ogre使用的一种文件格式）描述。在Ogre中你需要注意，物体模型是与它的位置和方向分开的。这就意味着你不能直接把一个物体放在场景里，你必须将Entity和一个SceneNode相关联，而这个SceneNode包含了位置和方向的信息。

正如前面所说，SceneNode可以和Entity相关联，关联的数量是不受限制的。这有什么用处呢？例如，你想制作一个人物在屏幕上行走，同时有一圈神圣的光环绕着他。实现这个的一种方法就是先创建一个SceneNode，然后创建一个人物的Entity并与SceneNode关联。接着再创建一个光的Entity也与SceneNode关联。人和光就这么联系在一起了，简单吧。

SceneNode不光可以和Entity相关联，和其他的SceneNode关联也是允许的。这将有助于你创建结构层次复杂的游戏世界。如果你不太明白，就想想windows中的窗口，子窗口套在父窗口里，层层嵌套就组成了一个程序的界面，而这里组成的是游戏世界的一部分，可能是人、房子，也可能是些别的什么东西。

SceneNode可以有孩子（ChildSceneNode），当然也就有父亲（ParentSceneNode）。（典型的树状结构嘛）

windows中所有窗口的根都是桌面（Desktop），在Ogre中每一个SceneManager也有这样一个根（RootSceneNode），它和其他所有的SceneNode关联着。

一个更加丰富的世界

刚才创建的程序中空荡荡的，除了数值和Logo什么也没有。现在我们添加一些代码让这个世界丰富起来。在刚才的代码中找到TutorialApplication::createScene成员函数，今天后面的代码都是添加在这个函数中的。

为了能看清楚我们将要做的事情，首先要设置场景的光线。

 mSceneMgr->setAmbientLight(ColourValue(1,1,1));

然后创建一个物体。

Entity *ent1 = mSceneMgr->createEntity("Robot","robot.mesh");

对了，还要有与之关联的SceneNode。

SceneNode *node1 = mSceneMgr->getRootSceneNode()->createChildSceneNode("RobotNode");

最后，把它们关联在一起。

node1->attachObject(ent1);

好了，就是它了！编译运行你的程序，你会看到一个机器人站在屏幕上。如果你想了解这几个函数的具体用法请查看"OGRE API Reference"，你可以在开始菜单中找到，作用相当于OGRE的MSDN。

坐标和向量

在继续深入之前，我们需要讨论一下屏幕坐标和Ogre向量对象。和许多图形引擎一样，Ogre使用x和z轴表示水平面，y轴作垂直轴。现在看着你的显示器，x轴是从你显示器的左边到右边，向右为x的正方向。y轴是从你显示器的底部到顶部，向上为y的正方向。z轴是从你的显示器屏幕内部向外延伸，向外为z的正方向。如图：

我们的机器人为什么是朝向x轴正方向的？这是mesh自身的属性，取决于它是如何设计的。Ogre不对你如何确定你模型的方向作任何假设。你所加载的每一个mesh都有它自己的开始方向。

Ogre使用向量(Vector)类而不是点(Point)类来描述位置和方向。向量的定义分2个向量(Vector2)、3个向量(Vector3)和4个向量(Vector4)，其中Vector3最常用。如果你不熟悉向量，我建议你在开始用Ogre做任何事前先复习一下（向量），这对你将来复杂的编程会很有帮助。

下面我们再添加一个物体。

Entity  * ent2  =  mSceneMgr -> createEntity( " Robot2 " , " robot.mesh " );
SceneNode  * node2  =  mSceneMgr -> getRootSceneNode() -> createChildSceneNode( " RobotNode2 " ,Vector3( 50 , 0 , 0 ));
node2 -> attachObject(ent2);

跟刚才的代码很像，只是多了几个参数。我们为node2指定了坐标Vector3(50,0,0)。编译运行，你会看到有两个机器人排排站，哈哈。

简介：Basic Tutorial 1最后的1/3是大段的理论，是使用Ogre开发的必备知识，但恰恰是网络上诸多译本所不涉及的范围。在这里我将使用最简练的语言向你介绍它们，当然我会砍掉部分内容，但那都是无关紧要的。本教程基于Ogre Wiki上的Basic Tutorial系列，并依据笔者使用的vs2005+sp1+OgreSDK1.4.3开发环境简化整理而来，其中穿插着笔者自己的理解。这是教程的第一部分，也是我的学习笔记。

正文：

The Ogre Environment

本文提到的大部分文件（.DLL/.CFG）都可以在OgreSDK的"\bin\debug"或"\bin\release"文件夹下找到。

DLLs and Plugins

首先我来解释一下Ogre library是如何工作的。

在Ogre中存在着各式各样的共享库，它们被分到了不同的组里。其中第一组就是Ogre库本身以及它所依赖的库。Ogre库完全保存在OgreMain.dll中。这个dll又需要像cg.dll之类的其他的库。Ogre程序无一例外地需要这些DLL文件。

第二组是插件。Ogre将许多功能放在了插件里面，因此可以根据你程序的需要添加或删除它们。Ogre中的基础插件都使用"Plugin_"前缀。如果你的程序需要，你也可以自己创建新的插件。Ogre的渲染系统（OpenGL, DirectX等等）同样使用了插件技术。这些插件以"RenderSystem_"为名字的前缀。你可以为你的程序添加或删除渲染系统，这非常的有用。例如，你想在一个非标准的平台上使用Ogre，不能用OpenGL了，也不能用DirectX了，你就需要自己写一个RenderSystem插件。

第三组就是第3方的共享库和辅助库。Ogre本身只是一个图像渲染引擎，它没有GUI没有输入控制更没有物理引擎。你必须用别的库来完成这些。Ogre的demo和SDK中包含一些第3方库。例如，CEGUI轻松地将一个GUI系统融入了Ogre，键盘和鼠标的输入则是由OIS（一个输入系统）完成的。

Configuration Files

Ogre程序的运行需要几个配置文件，他们控制着哪些插件被加载，程序的资源又在哪里等等。我们将简要地看一下这些配置文件都是做什么用的。

plugins.cfg包含插件的使用情况。如果想要删除某个插件，只需简单的删除对应的行或者在行首添加"#"将其注释掉。添加控件则需要按照"Plugin=[PluginName]"的形式增加一行。注意，pluginname不需要以.DLL结尾，也不一定要以"RenderSystem_"或"Plugin_"开头。你也可以修改"PluginFolder"的值来定义Ogre寻找插件的路径，绝对路径和相对路径都可以，但是不能用系统的环境变量。

resources.cfg包含着Ogre搜寻资源文件的路径列表。资源包括scripts, meshes, textures等等。同样是只能使用绝对路径和相对路径，不能用系统的环境变量。注意，Ogre是不搜寻子目录的，所以如果有多层目录的话，你必须手动输入他们。例如，你有像"res\meshes"和"res\meshes\"这样的目录树，你就必须添加2个两个路径。

media.cfg包含了更多的资源细节信息，关于这个文件的更多信息请查看手册或Ogre的论坛。（我也没有找到关于这个文件的信息，以后找到了会补上的）

ogre.cfg文件由Ogre's configuration screen根据你的电脑和图形设置生成。发布你的程序时这个文件不需要一起打包。注意，你不能直接地编辑这个文件，你应该使用configuration screen配置。

quake3settings.cfg文件应同BSPSceneManager一起使用。如果你没有使用BSPSceneManager，那么你就可以忽略此文件，当然也就不需要发布它。

这些就是Ogre使用的全部配置文件。在稍后的教程里我们将涉及这些文件的更多信息，比如如何改变它们的位置，如何使用它们完成更多的事情等等。