Gravitator installation guide
Gravitator requires the standard build tools as gcc, automake and autoconf and also GTK 1.2, OpenGL and GLU (and their headers
To install Gravitator, download the source package and extract it. Then the installation procedure is standard. Enter the extracted
directory (I will call it $GRAVITATOR_DIR), run ./configure (run ./configure --help for configuration options, the most usefull is
--prefix to specify the prefix for the installation, e.g. if you want to install it to /usr/local, then write --prefix="/usr/local"),
then run make. After this you can run "make install" (you must have root privileges if you're installing it to system directories), but
that's not really needed, all you need is to copy the binary gravitator from $GRAVITATOR_DIR/gravitator/ to
wherever you want. Gravitator doesn't need any other files.
If you are having problems with rendering to the gtkglarea widget (it's the place where all OpenGL rendering is done) and you're sure
that your OpenGL is OK, then you should try to compile the gtkglarea yourself. A compiled and staticaly linked version of gtkglarea is
shipped with gravitator because the development of gtkglarea is dying and it's a problem to download and compile it. Unfortunately
there is no other simple and reasonable way to use OpenGL in GTK. So you can download the gtkglarea from the Gravitator website,
extract it, enter it's directory, run "./configure --prefix=$GLAREA_DIR", where $GLAREA_DIR is just some temporary directory, then run
make and make install. Then copy $GLAREA_DIR/lib/libgtkgl.a to $GRAVITATOR_DIR/gravitator, delete all .o files and gravitator
executable from $GRAVITATOR_DIR/gravitator/ and rebuild the gravitator by executing make in the $GRAVITATOR_DIR directory. Also
Gtk-CRITICAL **: file gtkwidget.c: line 4880 (gtk_widget_unref): assertion `GTK_IS_WIDGET (widget)' failed.
Gtk-CRITICAL **: file gtkobject.c: line 1173 (gtk_object_unref): assertion `object->ref_count > 0' failed.
are caused by the gtkglarea not being finished, but they don't mean anything serious.