OGRE 1.9 的第一个程序（OGRE HelloWorld程序）

平台：win7， VS2010

先看运行结果吧：

1. 安装OGRE

下载OGRE SDK 1.9，解压，放在你喜欢的地方，在OGRE SDK文件加下创建“OGRE_HOME.bat.bat”文本文件，添加如下脚本：

setx OGRE_HOME %CD%

双击运行“OGRE_HOME.bat.bat”，该操作定义环境变量OGRE_HOME值为OGRE SDK目录，该环境变量将在VC++工程中使用。

2. 下载BaseApplication

到这个地方下载Tutorial Framework 1.9 - (Windows Line-endings)：

http://www.ogre3d.org/tikiwiki/tiki-index.php?page=Ogre+Wiki+Tutorial+Framework

这是OGRE为入门者准备的基本示例程序，给我们写好了初始化OGRE的代码（BaseApplication.cpp, BaseApplication.h）。

3. 创建VC++工程

step 1：控制台项目（空项目），将上一节下载的BaseApplication.cpp, BaseApplication.h拷贝到项目文件夹里，并添加到项目中。添加新源文件main.cpp，main.cpp中加入如下代码：

 #include "BaseApplication.h"

 class MyClass : public BaseApplication
 {
 public:
     MyClass(void) { }
     virtual ~MyClass(void) { }
 protected:
     virtual void createScene(void);
 };

 void MyClass::createScene(void)
 {
     // shadow
     mSceneMgr->setShadowTechnique(Ogre::SHADOWTYPE_STENCIL_ADDITIVE);
     mSceneMgr->setAmbientLight(Ogre::ColourValue(0.2f, 0.2f, 0.2f));

     // light and light sphere
     Ogre::Light* pointLight1 = mSceneMgr->createLight("pointLight1");
     pointLight1->setType(Ogre::Light::LT_POINT);
     pointLight1->setDiffuseColour(Ogre::ColourValue::White);
     pointLight1->setSpecularColour(Ogre::ColourValue::White);

     Ogre::Entity* sphereEnt = mSceneMgr->createEntity("MyEntity", "sphere.mesh");
     Ogre::SceneNode* lightNode = mSceneMgr->getRootSceneNode()->createChildSceneNode("LightNode");
     lightNode->attachObject(sphereEnt);
     lightNode->setScale(0.1f,0.1f,0.1f);
     sphereEnt->setMaterialName("BaseWhiteNoLighting");

     Ogre::Vector3 lightPosition(,,);
     lightNode->setPosition(lightPosition);
     pointLight1->setPosition(lightPosition);

     // Ninja
     Ogre::Entity* entNinja = mSceneMgr->createEntity("Ninja", "ninja.mesh");
     entNinja->setCastShadows(true);
     mSceneMgr->getRootSceneNode()->createChildSceneNode()->attachObject(entNinja);

     // ground
     Ogre::Plane plane(Ogre::Vector3::UNIT_Y, );
     Ogre::MeshManager::getSingleton().createPlane("ground", Ogre::ResourceGroupManager::DEFAULT_RESOURCE_GROUP_NAME,
         plane, , , , , true, , , , Ogre::Vector3::UNIT_Z);
     Ogre::Entity* entGround = mSceneMgr->createEntity("GroundEntity", "ground");
     mSceneMgr->getRootSceneNode()->createChildSceneNode()->attachObject(entGround);
     entGround->setMaterialName("Examples/Rockwall");
     entGround->setCastShadows(false);

     // set camera position
     mCamera->setPosition(,,-);
     mCamera->lookAt(,,);
 }

 int main(int argc, char *argv[])
 {
     // Create application object
     MyClass app;

     try{
         app.go();
     }
     catch( Ogre::Exception& e ){
         std::cerr << "An exception has occured: " <<
             e.getFullDescription().c_str() << std::endl;
     }
     return ;
 }

添加好之后，工程是这个样子的：

step 2：添加包含目录和库目录

项目上右键属性“配置属性 >> VC++目录 >> 包含目录”所有配置下添加如下项：

$(OGRE_HOME)\include
$(OGRE_HOME)\include\OIS
$(OGRE_HOME)\include\OGRE
$(OGRE_HOME)\include\OGRE\Overlay
$(OGRE_HOME)\boost

“配置属性 >> VC++目录 >> 库目录”所有配置下添加如下项：：

$(OGRE_HOME)\lib\$(Configuration)
$(OGRE_HOME)\boost\lib

现在知道环境变量OGRE_HOME的用途了吧。

step 3：添加库文件

项目上右键属性“配置属性 >> 链接器 >> 输入 >> 附加依赖项”Debug配置下添加如下项：

OgreMain_d.lib
OIS_d.lib
OgreOverlay_d.lib

Release配置下添加如下项：

OgreMain.lib
OIS.lib
OgreOverlay.lib

这个时候编译项目已经可以成功编译了，但运行不了，因为没有运行环境（.dll文件，资源文件）。在Release下编译，将编译出的helloOGRE.exe文件拷贝到OGRE_HOME/bin/Release下，双击运行，报错如下：

此时这是因为没有安装D3D，你可以到MSDN下载D3D安装，我们这里用OpenGL（OGRE同支持OpenGL和Direct3D）：将OGRE_HOME/bin/Release/plugins.cfg文件的第7, 8两行注释：

Plugin=RenderSystem_Direct3D9
Plugin=RenderSystem_Direct3D11

修改为

# Plugin=RenderSystem_Direct3D9
# Plugin=RenderSystem_Direct3D11

再运行还是不行，通过分析OGRE_HOME/bin/Release/Ogre.log（GORE程序运行产生的日志文件）发现是资源解析的问题。因为之前用OGRE 1.8.1时没问题，可以用OGRE SDK 1.8.1的资源包，具体就是OGRE_HOME/media整个文件夹和OGRE_HOME/bin/Release/resources.cfg文件替换为OGRE SDK 1.8.1（再去官网下载吧）中的相应项，就可以运行了。用“WASD”移动相机，鼠标改变视角，Esc键退出程序。

step 4：运行环境配置

因为不想每次运行程序都要手动拷贝，也不想改变OGRE_HOME目录下的文件。这里采取的策略是：将OGRE_HOME/bin和OGRE_HOME/media这两个文件夹都拷贝到VS解决方案文件夹下（OGRE 1.9的OGRE_HOME/bin和OGRE 1.8.1的OGRE_HOME/media），当然bin/debug和bin/release下的plugins[_d].cfg和samples[_d].cfg还是要改，见上一步。工程目录结构目前是这样的：

另外还要配置工程属性，修改生成目标位置：

项目上右键属性“配置属性 >> 常规 >> 输出目录”所有配置下修改为“$(SolutionDir)bin\$(Configuration)\”：

“配置属性 >> 调试 >> 工作目录”所有配置下修改为“$(TargetDir)”：

4. 问题解决

如果程序还是运行不起来，欢迎给我留言。另外可以查看/bin/Release/Ogre.log（Release版本），搜索“error”，查看错误信息。

5. 参考文献

http://www.ogre3d.org/tikiwiki/tiki-index.php?page=Setting+Up+An+Application+-+Visual+Studio

http://www.ogre3d.org/tikiwiki/tiki-index.php?page=Basic+Tutorial+1&structure=Tutorials