source: OGRE/trunk/ogrenew/Docs/README.linux @ 692

Revision 692, 6.2 KB checked in by mattausch, 19 years ago (diff)

adding ogre 1.2 and dependencies

Line 
1Title: Ogre in linux
2Author: Ben Woodhead
3Last Updated: 19 Feb 05
4License: LGPL
5
6Edited by Steve Streeting following configuration changes.
7Edited by James O'Sullivan following requirement changes.
8Edited by Wladimir J. van der Laan following configuration changes.
9
10Downloading The Files
11=====================
12
13If are going to using Ogre for more then just to have a look you will want to have a cvs copy of Ogre. If you are just testing it out, feel free to grab one of the release files.
14
15Release files can be found:
16http://ogre.sourceforge.net/modules.php?op=modload&name=Downloads&file=index
17
18CVS version (anonymous)
19If you are not an ogre developer then use anonymous. You can't write but why would you want to if you are not a developer. Help is always welcome and the occasional thing can be sent with a patch.
20
21Anyway enough of the talk, you probably are not reading it anyway.
22
23Login in
24cvs -d:pserver:anonymous@cvs.ogre.sourceforge.net:/cvsroot/ogre login
25password is blank so just press enter.
26
27Getting the module
28cvs -z3 -d:pserver:anonymous@cvs.ogre.sourceforge.net:/cvsroot/ogre co ogrenew
29// Note the new part on ogre, there is an order version in the repository as well (called ogre).. Don't get that one.
30
31
32Dependencies
33============
34
35So additional files that may not be found on your system that ogre will need.
36
37SDL 1.2.x (when not using the GLX platform manager -- see below) - To find out if you have it type sdl-config --version. This will tell you the version, if its not found then you will have to get sdl. sdl can be found at www.libsdl.org. It would be best to insure that this installs into a standard directory. If you are installing from source run ./configure --prefix=/usr.
38
39FreeType2 2.1.x - If you don't have this on your system then you can get it http://www.freetype.org/. Run freetype-config --version, if you have a version lower then 9.1.x, you will have to upgrade.
40
41DevIL 1.5.x or greater - If you don't have this on your system then you can get
42it from http://openil.sourceforge.net/.  UPDATE: DevIL 1.6.6 seems to introduce some problems, stick to 1.6.5 for the moment.
43
44zziplib 0.12.x or above, available from http://zziplib.sourceforge.net.
45
46Cg, preferably version 1.1 since later versions have known bug which have been reported to nVidia. http://developer.nvidia.com/cg
47
48*Important*
49Do not install the binary version of DevIL as this has caused problems for some
50users, install the source distribution instead. 
51
52Also if you have libpng3 installed on your system look at the following link:
53http://ogre.sourceforge.net/modules.php?op=modload&name=FAQ&file=index&myfaq=yes&id_cat=1&categories=Building+OGRE&parent_id=0#20
54
55Optional Libraries
56==================
57For the samples gui you will need gnome2, if you don't have gnome2 on your system the you will have to use the command line interface. If you are running gnome 2 then you will need 2 additional libraries.
58
59Gtkmm2 version 1.3.26 and Glademm2 version 1.3.4, both libraries can be found at http://gtkmm.sourceforge.net/. Gtkmm will also need libsigc (http://libsigc.sourceforge.net/). When configuring gtkmm and glademm insure that you use an appropriate prefix. (ie if gnome is found /usr then run ./configure --prefix=/usr).
60
61
62Compiling Ogre
63==============
64
65You are not just going to read the code, I am guessing that you actually want to try it and even play with it. So here goes.
66
67GCC Compiler
68I have no idea if Intels compiler will work and I am not going to test to find out.
69
70What version of you compiler are you running. (gcc --version will tell you). You need version 3.2 or above. The new gcc 4.x is supported but please use the latest release since early versions had problems.
71
72Compiling Ogre
73
74NOTE: if you are running the cvs version then you must run ./bootstrap first. It will setup the configure files for you.  If you have some of the dependent libraries installed in another directory (like /usr/local) you might need to set the ACLOCAL_FLAGS variable to point at the extra aclocal directory.  An example is:  export ACLOCAL_FLAGS="-I /usr/local/share/aclocal"; ./bootstrap
75
76./configure
77make
78make install
79
80Well you must be thinking that was easy compared to 2.95.3 and you are right. That's part of the reason I decided to upgrade (again changing compilers is a really good way to turn a linux box into a paper wait, if you can't compile what else are you going to do).
81
82GLX platform manager
83====================
84
85If you add the options --with-gl-support=GLX --with-platform=GLX to the ./configure statement, the GLX platform manager will be used instead of the default, SDL. This means that OGRE will work without the SDL libraries installed and directly make use of the capabilities of your X server. You will also get a nice X startup screen to select your resolution. There is little reason to use SDL, unless you want to use it for input or sound.
86
87Ogre Samples
88============
89
90Alright on to the samples, if you have not used Visual C++ you may find this a little confusing when you start.
91
92cd <ogrenew>/Samples/Common/bin/ - you will see 2 directories there one is Release and Debug. If you were running windows the files would already be in these directories but with Linux there are files only in the Debug directory.
93
94So the first thing is getting all the plugins (this worked for me, but I don't know about you). During the make install all the plugins were copied to /usr/local/lib/ogre except for the OgrePlatform.so which is found in the <ogrenew>/Samples/Common/bin with the samples. This didn't work for me, so I made a few changes. I copied the OgrePlatform.so to /usr/local/lib and the plugins from /usr/local/lib/ogre to /usr/local/lib and ran ldconfig.
95
96
97Next, in windows you have a nice little popup window that you can say the resolution in, Linux has 2 options, due to the fact that a lot of people are not running gnome2 yet, it has a gtk2 config or a cli (command line interface). CLI is the default and I have not figured out how to change that yet.
98
99
100Ok so now we have everything in place. The next thing you are going to have to do is try running some of the examples.  You may need to check the case of the textures found in the media directory.
101
102COMMENTS
103========
104
105And that is it.. I hope this helps
106If you have any comments or questions regarding this document please send them to me at zander@echotech.ca
107
108Ben Woodhead
Note: See TracBrowser for help on using the repository browser.