Next: , Previous: Code Reference, Up: Top


Appendix A Building Vamos

A.1 Downloading

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.

A.2 Dependencies

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.

SDL http://www.libsdl.org is used for event handling (keys, mouse, and joystick). Sound is handled by OpenAL http://connect.creativelabs.com/openal.

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, and 4.x should do. See http://gcc.gnu.org. The code is intended to be portable, standard C++, so other compilers should work as well.

A.3 Compiling

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.