Building the VTP Libraries and Applications under Unix
(including Linux, BSD, Irix, Mac OS X...)

1. Acquire the Source

1. Source control: you can get the very latest VTP source with Mercurial.
2. -or-
3. Archive: Source code (2.2 MB zip file)

2. Install and Build

You should refer to the General Unix Build Instructions.

If you are using Mac OSX, see Pete Willemsen's How to get VTP running on Mac OS X, which is dated but may have some valuable insights for Mac people.

3. Confirm that you have the data files installed for GDAL and PROJ.4.

• If you got them from a repository, the data should already be in a place like /usr/share/gdal/1.8 and /usr/share/proj
• In case it didn't install along with GDAL, here are pointers: gdal-data-1.9.2.zip and proj4-data-4.8.0.zip
• Confirm that the environment variables are set.  The path depends on where the files are.
  For example, on Ubuntu, you can add the following lines to your .bashrc file:

  export GDAL_DATA=/usr/share/gdal/1.8
export PROJ_LIB=/usr/share/proj

4. Download Application Data

vtp-apps-data.zip (8 MB) (required) contains basic data for the main applications, includes a world map for use by VTBuilder, and earth image, plant images, road textures, etc. for Enviro.

Optional:

1. Hawaii-demo-0411.zip (32 MB) (optional) contains some demo terrain data, including elevation and satellite imagery for the Island of Hawai`i.  You don't need this if you are only going to use your own geospatial data.
2. vtp-plantlib.zip (80 MB) (optional) contains a large library of billboard plant textures.

5. Run!

You will find documentation for each application in the Docs folder under each directory, and also online.

See the FAQ and status pages for bug reports, feature requests, etc.

Try the software on your own geospatial data!

Send feedback to myself or the VTP mailing list, or the vtp-unix mailing list for anything specific to Unix/Linux/MacOSX.

See also: Porting Notes