Next: Copying, Previous: Code Reference, Up: Top
You can get the latest release by going to the Vamos home page, http://vamos.sourceforge.net, and following the “Download” link. Another way to get there is to go through the SourceForge project page, http://sourceforge.net/projects/vamos.
Vamos makes use of some external libraries. These libraries need to be present in order to compile Vamos.
OpenGL-compatible libraries, including the OpenGL Utility Library (GLU) and the OpenGL Utility Toolkit (GLUT) must be installed. Mesa http://www.mesa-3d.org works fine. In addition, you need accelerated video hardware. Some video cards require specific GL implementations.
For joystick control and sound, PLIB version 1.4 or later must be present. You can get it from http://plib.sourceforge.net.
XML files are parsed with the help of SimGear. Get version 0.2.0 or later from http://www.simgear.org.
Libsigc++ version 1.2 is used for implementing callbacks to member functions. Libsigc++ can be downloaded from http://libsigc.sourceforge.net.
You will also need a reasonably up-to-date C++ compiler. Specifically, it must handle namespaces. Gcc version 2.96 and later, including 3.x, should do. See http://gcc.gnu.org.
By the way, the phrase “or later” does not mean that I can see into the future. I can't guarantee that a new version of one of these packages will not be incompatible with Vamos. If you find such an incompatibility, please let me know.
After downloading the source archive (the tar.gz file), unpack it with the tar command, or some other utility. All of the files in the archive are placed in a subdirectory. If the archive is vamos-1.2.3.tar.gz, the files are placed in vamos-1.2.3.
Vamos uses the GNU Autotools (automake, autoconf,
and libtool) to check for prerequisites and handle different
architectures. Change to the directory created by un-archiving and
type ./configure. Type ./configure --help to see
the options accepted by configure. I have only tried to
compile Vamos on GNU/Linux and Cygwin/Win32 platforms. Please write
me if you find an architecture that is not handled correctly.
The configure script generates the Makefiles needed to compile the program. Issue the make command to start the compilation. If you encounter errors, or warnings that you think I should know about, please contact me.
If the compilation succeeds, you can install the libraries, headers, and application by typing make install. You may need to be a privileged user to install software on your system. You do not need to install the program to run the application. Switch to the vamos directory and run ./vamos to try the application without installing.