source: GTP/trunk/App/Demos/Illum/Ogre/ReadMe.txt @ 1678

Revision 1678, 3.8 KB checked in by szirmay, 18 years ago (diff)
Line 
1The OGRE integrated demos of different illumination module techniques can be found in this folder.
2
3Run
4-----
5The executables(Debug and Release) can be found in the \bin directory. The media files like textures, models, shaders etc.
6used by the demos can be found in the \Media directory.
7You don't need to compile the demos if you would only like to test the programs,
8prebuilt executables are located in the bin/Release or Debug directory.
9
10Three demos are ready to run:
11        - GameToolsRaytraceDemo.exe : This demo demonstrates raytrace like effects such as reflections and refractions (using depth impostors)
12                                        and caustics. It also uses glow.
13        - GameToolsParticleDemo.exe : This demo demonstrates spherical billboards, a particle rendering technique that treates particles as spheres
14                                        (while still rendering them as billboards) and uses scene depth information to avoid billboard clipping artifacts.
15        - HPSDemo.exe : This Demo demonstrates hierarchical particle systems, which is a particle system made of particle system.
16                        It first simulates a little particle system, stores its image to a texture and this image will be used as texture of one particle in the bigger particle system.
17                        This way more particles can be simulated, and the "cheating" is usually not visible (as most of the natural phenomena shows self similarity).
18                        The method also eliminates billboard clipping artifacts with a calculation similar to spherical billboards.
19                        The demo also shows that this animated particle system can be shaded according to dynamic lighting conditions.
20       
21        (You can also find two more executables in this directory, but these demos are under development.)
22
23Usage
24-----
25
26The control is the same for all demos:
27
28W - move camera forward
29S - move camera back
30A - slide camera left
31D - slide camera right
32mouse - rotate camera
33F - show/hide FPS data
34R - toggle wireframe on/off
35
36
37Build
38-----
39
40These demos use OGRE 1.2 with changes can be found in the svn (www.gametools.org/repos/gametools/OGRE/trunk/ogre_changes/Ogre1.2).
41These OGRE changes should be copied to your OGRE 1.2 directory and OGRE should be rebuilt. It's important to set
42the prepocessor definition : GAMETOOLS_ILLUMINATION_MODULE for the projects.
43Also add SpriteSet.h SpriteSet.cpp SpriteParticleRenderer.h SpriteParticleRenderer.cpp to the OgreMain project.
44
45The demos also use a library called IllumModule and it's OGRE version OgreIllumModule.
46These libraries can be found in the svn : www.gametools.org/repos/gametools/GTP/trunk/Lib/Illum/IllumModule
47There is also a prepared solution file that containes these library projects and all the demo projects in folder:
48        www.gametools.org/repos/gametools/GTP/trunk/Lib/Illum/shared/scripts
49The source code of the demos are located in:
50        www.gametools.org/repos/gametools/GTP/trunk/App/Demos/Illum/Ogre/src
51So the following directory structure should be downloaded to successfully compile the demos and libraries:
52
53        -|
54         |--App
55         |   |
56         |   |--Demos
57         |       |
58         |       |--Illum
59         |            |
60         |            |--Ogre
61         |                |
62         |                |--bin...
63         |                |--Media...
64         |                |--src...
65         |
66         |
67         |--Lib
68             |
69             |--Illum
70                  |
71                  |--IllumModule...
72                  |--shared...
73
74An environment variable named OGRE_PATH should also be set to your OGRE root directory.
75If you made the steps above the build of the libraries and demos should succeed without errors.
76The demo executables will be copied to App/Demos/Illum/Ogre/bin/Debug or Release automatically.
77( Don't forget you should also copy the dll's from your Ogre directory (OGRE_PATH/Samples/Common/bin/Debug or Release) to these directory after building OGRE.)
Note: See TracBrowser for help on using the repository browser.