VTP/OS X

VTerrain Mac OS X Install Scripts

These are quite old instructions; the trunk has progressed, but for interested parties, this will get you boot-strapped.

What you need minimally

1) OS X 10.4.6+ (I am running 10.4.8)
2) Apple Developer Tools (optional install off the OSX DVDs)
3) Fink (download) installed
4) Git
5) Read the following directions :)

The Quick Start:

This is the fastest way to get started.  Read subsequent sections to learn more about how the scripts actually work. 

Step 1 - Put the following commands into a file/shell script goVTP.sh:

#!/bin/sh
mkdir ~/vterrain
cd ~/vterrain 
git clone git://github.com/ninowalker/vtp_osx_build.git
cd vtp_osx_build
./download_dependencies.sh ALL
./build_vterrain.sh ALL

Step 2 - Run the new script

From the command line (e.g. Applications/Utilities/Terminal), run your script:

chmod +x goVTP.sh
./goVTP.sh

Step 3 - Go have coffee once the build begins

This will take a while, about 45-60 minutes to build all the dependent libraries.  You should stop by periodically to verify things are going well.  As long it keeps going, you're in good shape.

Step 4 - Once the VTP Xcode project launches, start playing

The scripts have setup your ~/vterrain directory and built all of the dependencies.  Now you should manually launch the VTP build form Xcode.  The TerrainApps target is recommended. 

Note that the VTP source is from the HEAD, and it's possible the build is occasionally broken on OS X.  That's an opportunity to fix the bug and submit a patch!

About downloading the build scripts:

It's best to check out the install scripts from github.  Update often.

To update an already checked out version:

git fetch origin master 

More detailed build instructions:

Start a terminal session, cd into where the scripts are checked out, and the the following should work: 

./download_dependencies.sh ALL 

That will take a while as it fetches all the packages; the default is $HOME/vterrain.

It should be pretty robust, unless you kill it mid-download. If so, just manually remove the partial archive and run again.  Note that the script supports downloading one or more specific packages:

 ./download_dependencies.sh libMini osg

After this process is complete, run:

./build_vterrain.sh ALL

You must have administrative permissions to install fink packages, and you will be prompted for your password.

Note that both scripts respond to the --help option, which will explain what options are available. It is possible to build one or more components at a time:

./build_vterrain.sh libMini gdal PROJ 

Tips: 

Remove ~/.vtp-user.defs if have built VTP on OSX in the past.

Notes:

Send bugs to the vtp-unix yahoo group.