80 lines
3.1 KiB
Plaintext
80 lines
3.1 KiB
Plaintext
Celestia Install instructions for UNIX
|
|
--------------------------------------
|
|
|
|
You need to have the following components installed before Celestia
|
|
will build: OpenGL (tested with Mesa 3.4), glu, libjpeg, and libpng.
|
|
Should you have a package based installation (most Linux distributions these
|
|
days are), you will also need to install the devel packages for your OpenGL,
|
|
glu and glibc packages.
|
|
|
|
OK, assuming you've collected all the necessary libraries, here's
|
|
what you need to do to build and run Celestia:
|
|
|
|
libtoolize
|
|
autoreconf -f
|
|
./configure --with-INTERFACE [*]
|
|
make
|
|
make install
|
|
|
|
[*] INTERFACE must be replaced with one of "gtk" or "glut".
|
|
|
|
Four interfaces are available for Celestia:
|
|
- glut: minimal interface, barebone Celestia core with no toolbar or menu...
|
|
- GTK: A full interface with minimal dependencies, adds a menu, a configuration
|
|
dialog some other utilities.
|
|
|
|
To build the GTK interface (requires gtkglext and gtkglext-devel):
|
|
configure --with-gtk
|
|
|
|
To build the GLUT interface (requires glut and glut-devel):
|
|
configure --with-glut
|
|
|
|
At the end of the configure output shows which interface has been selected, you
|
|
should check it is correct before running make.
|
|
|
|
Starting with version 1.3.1, Lua is the new scripting engine for Celestia,
|
|
the old homegrown scripting engine is still available. By default Lua support
|
|
will NOT be compiled in, to enable it you need to download the Lua library
|
|
from:
|
|
http://www.lua.org/
|
|
Version 5.1 or newer is required.
|
|
|
|
Once Lua has been installed on your system, you need to run:
|
|
configure --with-lua=/path/to/lua
|
|
|
|
To check wether your Celestia has been compiled with Lua support, go to File
|
|
-> Open. If you have '*.cel *.celx' in the filter box, then Lua is available
|
|
otherwise the filter will contain only '*.cel'.
|
|
|
|
The GtkGLExt widget that is required in order to build Celestia with Gtk+ may
|
|
be downloaded from http://gtkglext.sf.net. Note that depending in your
|
|
distribution you may also need other packages containing various files needed
|
|
by the build process. For instance, to build under SUSE Linux, you will also
|
|
need to have the gtk-devel package installed.
|
|
|
|
Celestia will be installed into /usr/local by default, with data files landing
|
|
in /usr/local/share/celestia , but you may specify a new location with the
|
|
--prefix option to configure:
|
|
|
|
configure --prefix=/home/my_directory
|
|
|
|
All the other usual configure parameters apply; you may see which options
|
|
are available using 'configure --help'
|
|
|
|
If while running configure you see an error reporting that gl.h,
|
|
is missing, you either don't have OpenGL installed on your system,
|
|
or you don't have the corresponding devel package installed. If for
|
|
instance you have Mesa installed, you will also have to install the
|
|
mesa-devel package (or something named similarly). Missing glu.h or glut.h
|
|
means that you don't have GLU, GLUT, or their devel pacakges installed.
|
|
|
|
|
|
Chris Laurel & Deon Ramsey
|
|
claurel@.shatters.net dramsey@users.sourceforge.net
|
|
|
|
Updated 2003-06-10 by
|
|
Christophe Teyssier
|
|
chris@teyssier.org
|
|
|
|
Updated 2004-04-28 by pat@suwalski.net
|