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 for compilation).


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 the messages:
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.