簡(jiǎn)介：本教程基于Ogre Wiki上的Basic Tutorial系列，并依據(jù)筆者使用的vs2005+sp1+OgreSDK1.4.3開發(fā)環(huán)境簡(jiǎn)化整理而來，其中穿插著筆者自己的理解。這是教程的第一部分，也是我的學(xué)習(xí)筆記。

正文：凡是翻譯過幾篇技術(shù)類文章的人都深知從頭至尾忠實(shí)重現(xiàn)作者的原意是一件多么令人頭疼的事情。當(dāng)我從諸多曾經(jīng)許諾要翻譯的文章中爬出來的時(shí)候，我決定這次不做那樣一個(gè)“傻子”，重寫那些文章要比翻譯它們快樂的多。

在開始前，我希望統(tǒng)一我們的開發(fā)環(huán)境——VS2005+OgreSDK1.4.3。有兩點(diǎn)需要注意：
一、請(qǐng)確認(rèn)你的VS2005安裝了sp1補(bǔ)丁包，這一點(diǎn)非常重要，否則你可以正確的編譯Ogre程序，但你死活運(yùn)行不起它們來。
二、請(qǐng)確認(rèn)你的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免費(fèi)獲得。

創(chuàng)建你的第一個(gè)Ogre應(yīng)用程序

現(xiàn)在，對(duì)表之后，行動(dòng)開始。哦，等一下，忘了給你們發(fā)槍了。請(qǐng)到http://ogreconglo.sourceforge.net/phpBB2/viewtopic.php?p=4領(lǐng)取槍械。是Ogre產(chǎn)的Ogre Application Wizard，不要著急，人人都有。把它解壓到合適的位置，我推薦的位置當(dāng)然是OgreSDK目錄下了，然后運(yùn)行里面的VC8_Setup.js安裝。兄弟們，準(zhǔn)備好了嗎？現(xiàn)在行動(dòng)真的要開始了。

打開vs2005，新建一個(gè)項(xiàng)目，"文件"->"新建"->"項(xiàng)目"->"Visual C++"，在"Visual Studio已安裝的模板"選擇"OGRE SDK Application"。設(shè)置好工程名和存儲(chǔ)路徑后點(diǎn)"確定"按鈕。

彈出了向?qū)Вx項(xiàng)保持默認(rèn)就好了，點(diǎn)"finish"完成。

是不是個(gè)Win32項(xiàng)目的向?qū)б粯雍?jiǎn)單？下面按F7編譯一下。

如果沒有操作失誤的話，會(huì)得到這樣的結(jié)果

------ 已啟動(dòng)生成: 項(xiàng)目: test1, 配置: Debug Win32 ------
正在編譯...
test1.cpp
正在編譯資源...
正在編譯資源清單...
正在鏈接...
正在嵌入清單...
Copying exe to samples bin directory ...
已復(fù)制         1 個(gè)文件。
生成日志保存在“file://d:GameDevelop est1 est1objDebugBuildLog.htm”
test1 - 0 個(gè)錯(cuò)誤，0 個(gè)警告
========== 生成: 1 已成功, 0 已失敗, 0 最新, 0 已跳過 ==========

運(yùn)行卻會(huì)出現(xiàn)如圖的錯(cuò)誤，缺少相應(yīng)的文件，運(yùn)行不起來。一種解決辦法是把缺少的文件復(fù)制過來，但你必須知道需要什么文件，不適合新手。另一種方法是，你注意到“Copying exe to samples bin directory ...”一句了嗎？EXE文件拷貝到哪里去了？拷貝到“\OgreSDK\bin\debug”中去了，找到了嗎？運(yùn)行試試，成功了吧。

揭開向?qū)У拿婕?/strong>

你可能在想Ogre Application Wizard(之后簡(jiǎn)稱OAW)到底做了什么呢？就像當(dāng)初我使用Win32應(yīng)用程序向?qū)?chuàng)建了那個(gè)HelloWorld之后想的一樣。其實(shí)OAW只做了兩件事，一是創(chuàng)建了幾個(gè)源文件，另一個(gè)是設(shè)置了IDE的參數(shù)，這也是最重要的一步。下面我們來手動(dòng)做一次OAW做的事情，以便加深印象，為了以后的方便又一小部分操作是不同的。

關(guān)閉剛才的解決方案，新建一個(gè)項(xiàng)目，"文件"->"新建"->"項(xiàng)目"->"Visual C++"->"Win32"，在"Visual Studio已安裝的模板"選擇"Win32項(xiàng)目"。設(shè)置好工程名和存儲(chǔ)路徑后點(diǎn)"確定"按鈕。（我用的工程名和解決方案名都是test2，路徑名為D:\GameDevelop）

在向?qū)У?應(yīng)用程序設(shè)置"中選擇"Windows應(yīng)用程序"和"空項(xiàng)目"，點(diǎn)擊完成。

除了幾個(gè)工程文件，向?qū)]再多做任何事情。為了這個(gè)項(xiàng)目的獨(dú)立性與方便性，我們還要復(fù)制"\OgreSDK"下的"\bin"和"\media"到"D:\GameDevelop\test2"里，并創(chuàng)建"include"、"src"和"scripts"，這樣你在"D:\GameDevelop\test2"下將看到6個(gè)文件夾。

然后創(chuàng)建一個(gè)"SampleApp.cpp"，保存路徑為"D:\GameDevelop\test2\src"，內(nèi)容如下：

#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編譯一下。

------ 已啟動(dòng)生成: 項(xiàng)目: 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 個(gè)錯(cuò)誤，0 個(gè)警告
========== 生成: 0 已成功, 1 已失敗, 0 最新, 0 已跳過 ==========

出錯(cuò)了，找不到"ExampleApplication.h"。其中的"ExampleApplication"又是什么呢？它是Ogre為初學(xué)者設(shè)計(jì)的實(shí)例程序類（可能是個(gè)程序框架什么的，我是這么理解的），以便你可以快速的開始Ogre編程的學(xué)習(xí)。"ExampleApplication.h"在"\OgreSDK\samples\include"下。默認(rèn)情況下，IDE是不會(huì)找到這里的。還記得我說過Ogre程序向?qū)ё鲞^什么嗎？對(duì)了，設(shè)置我們的IDE環(huán)境。下面我們就來一步步地把IDE設(shè)置好。

"項(xiàng)目"->"屬性"，打開"test2 屬性頁"，展開"配置屬性"。設(shè)置：
"調(diào)試"->"工作目錄"為"..\bin\Debug"，
"C/C++"->"常規(guī)"->"附加包含目錄"中添加"..\include"、"$(OGRE_HOME)\include"和"$(OGRE_HOME)\samples\include"，
"C/C++"->"代碼生成"->"運(yùn)行時(shí)庫(kù)"為"多線程調(diào)試 DLL (/MDd)"（這個(gè)好像就是默認(rèn)的），
"鏈接器"->"常規(guī)"->"輸出文件"為"..\bin\Debug\$(ProjectName).exe"，
"鏈接器"->"常規(guī)"->"附加庫(kù)目錄"中添加"$(OGRE_HOME)\lib"，
"鏈接器"->"輸入"->"附加依賴項(xiàng)"中添加"OgreMain_d.lib"和"OIS_d.lib"（如果是Release版則添加"OgreMain.lib"和"OIS.lib"）

設(shè)置好了，再編譯一次試試。如果你看懂了以上部分，并且編譯通過的話，我們就可以繼續(xù)了，之后的內(nèi)容將修改前面這個(gè)程序來向你展示Ogre的世界。

OGRE是如何工作的

SceneManager、Entity和SceneNode是Ogre的3個(gè)基礎(chǔ)模塊。

其中SceneManager是管理者，所有顯示在屏幕上的東西都由SceneManager管理。SceneManager的類型眾多，隨著教程的推進(jìn)，你會(huì)慢慢的了解它。

Entity就是你想要渲染的物體的模型，它們使用mesh（Ogre使用的一種文件格式）描述。在Ogre中你需要注意，物體模型是與它的位置和方向分開的。這就意味著你不能直接把一個(gè)物體放在場(chǎng)景里，你必須將Entity和一個(gè)SceneNode相關(guān)聯(lián)，而這個(gè)SceneNode包含了位置和方向的信息。

正如前面所說，SceneNode可以和Entity相關(guān)聯(lián)，關(guān)聯(lián)的數(shù)量是不受限制的。這有什么用處呢？例如，你想制作一個(gè)人物在屏幕上行走，同時(shí)有一圈神圣的光環(huán)繞著他。實(shí)現(xiàn)這個(gè)的一種方法就是先創(chuàng)建一個(gè)SceneNode，然后創(chuàng)建一個(gè)人物的Entity并與SceneNode關(guān)聯(lián)。接著再創(chuàng)建一個(gè)光的Entity也與SceneNode關(guān)聯(lián)。人和光就這么聯(lián)系在一起了，簡(jiǎn)單吧。

SceneNode不光可以和Entity相關(guān)聯(lián)，和其他的SceneNode關(guān)聯(lián)也是允許的。這將有助于你創(chuàng)建結(jié)構(gòu)層次復(fù)雜的游戲世界。如果你不太明白，就想想windows中的窗口，子窗口套在父窗口里，層層嵌套就組成了一個(gè)程序的界面，而這里組成的是游戲世界的一部分，可能是人、房子，也可能是些別的什么東西。

SceneNode可以有孩子（ChildSceneNode），當(dāng)然也就有父親（ParentSceneNode）。（典型的樹狀結(jié)構(gòu)嘛）

windows中所有窗口的根都是桌面（Desktop），在Ogre中每一個(gè)SceneManager也有這樣一個(gè)根（RootSceneNode），它和其他所有的SceneNode關(guān)聯(lián)著。

一個(gè)更加豐富的世界

剛才創(chuàng)建的程序中空蕩蕩的，除了數(shù)值和Logo什么也沒有。現(xiàn)在我們添加一些代碼讓這個(gè)世界豐富起來。在剛才的代碼中找到TutorialApplication::createScene成員函數(shù)，今天后面的代碼都是添加在這個(gè)函數(shù)中的。

為了能看清楚我們將要做的事情，首先要設(shè)置場(chǎng)景的光線。

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

然后創(chuàng)建一個(gè)物體。

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

對(duì)了，還要有與之關(guān)聯(lián)的SceneNode。

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

最后，把它們關(guān)聯(lián)在一起。

node1->attachObject(ent1);

好了，就是它了！編譯運(yùn)行你的程序，你會(huì)看到一個(gè)機(jī)器人站在屏幕上。如果你想了解這幾個(gè)函數(shù)的具體用法請(qǐng)查看"OGRE API Reference"，你可以在開始菜單中找到，作用相當(dāng)于OGRE的MSDN。

坐標(biāo)和向量

在繼續(xù)深入之前，我們需要討論一下屏幕坐標(biāo)和Ogre向量對(duì)象。和許多圖形引擎一樣，Ogre使用x和z軸表示水平面，y軸作垂直軸。現(xiàn)在看著你的顯示器，x軸是從你顯示器的左邊到右邊，向右為x的正方向。y軸是從你顯示器的底部到頂部，向上為y的正方向。z軸是從你的顯示器屏幕內(nèi)部向外延伸，向外為z的正方向。如圖：

我們的機(jī)器人為什么是朝向x軸正方向的？這是mesh自身的屬性，取決于它是如何設(shè)計(jì)的。Ogre不對(duì)你如何確定你模型的方向作任何假設(shè)。你所加載的每一個(gè)mesh都有它自己的開始方向。

Ogre使用向量(Vector)類而不是點(diǎn)(Point)類來描述位置和方向。向量的定義分2個(gè)向量(Vector2)、3個(gè)向量(Vector3)和4個(gè)向量(Vector4)，其中Vector3最常用。如果你不熟悉向量，我建議你在開始用Ogre做任何事前先復(fù)習(xí)一下（向量），這對(duì)你將來復(fù)雜的編程會(huì)很有幫助。

下面我們?cè)偬砑右粋€(gè)物體。

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