用Equalizer擴充Ogre應用的範例程式碼

剛在blogspot上公布了用Equalizer擴充Ogre應用的範例程式碼，因為Equalizer是外國人開發的，所以在那邊是用英文寫的，有點蹩腳，回頭有空再改成中文的吧。
相關的樣本圖片可以參考我以前的文章，這裡。

 eqOgre is my test project for integrating Ogre application with Equalizer. You can get the executable files from here, and you can find some previews from my last post.

Features
1.Simple Ogre application integrated with Equalizer.
2.Load ply file as mesh data.
3.Interact by mouse and keyboard.
4.Realtime textured shaddow for each mesh object.
5.Support multi-window, multi-channel, or cluster running by equalizer.
6.Just support WindowXP by now.

Important
Because of ogre's limitation, thread safeness is poor, so
1.each node can only contain one pipe, that means you must change the config of 2-window.2d.eqc to use one pipe that contains tow windows.
2.there will be a blank window to be created automaticly, which is needed to initialize some opengl extensions by ogre.

What's needed
1. Ogre 1.4.4 for vc8
2. Equalizer v0.4
3. visual c++ 8.0 with sp1.
4. Ply files, you can find from http://graphics.stanford.edu/data/3Dscanrep/
5. eqOgre source from http://www.esnips.com/doc/64e8e015-571f-41a2-9df4-12a4ce5f7274/eqOgre-full
For lower bandwidth, you can get just source from http://www.esnips.com/doc/25bfc7e4-624e-4a2c-a675-e7a146f4952e/eqOgre-source

How to build?
After prepared IDE and SDKs, you can open the solution in './scripts' folder and build it.
Exacutable files will be outputed to './build/debug' or './build/release' as what configuration you choosed.

How to run?
If you just build with ogre 1.4.4 and Equalizer 0.4, the result can run directly and skip these.
But if you want to change the exacuting directory or edit the code, I hope these would be helpful.

1. Copy these files from Ogre's output directories to your executable directory.
for debug solution, you will need these files at least:

• CEGUIBase_d.dll
• CEGUIExpatParser_d.dll
• CEGUIFalagardWRBoard_d.dll
• OgreGUIRender_d.dll
• OgreMain_d.dll
• OIS_d.dll
• ReferenceAppLayer_d.dll
• RenderSystem_GL_d.dll

for release solution, you will need:

• CEGUIBase.dll
• CEGUIExpatParser.dll
• CEGUIFalagardWRBoard.dll
• OgreGUIRender.dll
• OgreMain.dll
• OIS.dll
• ReferenceAppLayer.dll
• RenderSystem_GL.dll

2. Copy these files from Equalizer's output directories to your executable directory.
btw, for both configurations, the files have the same names:

• Equalizer.dll
• EqualizerServer.dll
• pthreadVC2.dll

3. Move ply model files to the parent 'models' directory of your executable directory.
ie. if './build/release' is your executable directory, your can copy the ply file into
'./build/models'
The directory of ply files can be set in EqOgreWindow::setupPlyMesh for each PlyMesh object, you can change that as you want.
The default model used in eqOgre is 'rockerArm.ply', which could be found in equalizer's
examples directory also.

4. If you have changed the executable directory, please check the ogre config files are
set correcttly, just as './build/debug/plugins.cfg', './build/debug/plugins.cfg', and
'./common/*.cfg'

5. Now try to run eqOgre.exe just like Equalizer's eqPly example.
Please try 'a/d/w/s' and arrow keys to move the camera, and draw the mouse to rotate the camera.