Welcome to VirtualPlanetBuilder

VirtualPlanetBuilder is terrain database creation tool that is able to read a wide range of geospatial imagery and elevation data and build from small area terrain database to massive whole planet paged databases. These databases can then be uploaded onto the internet and provide online GoogleEarth style roaming of whole planet databases, or kept on local disks for high speed access such as required for professional flight simulators.

VirtualPlanetBuilder just builds databases so for runtime viewing of database you'll need an OpenSceneGraph based application. The VirtualPlanetBuilder itself is based on the OpenSceneGraph real-time graphics toolkit, and creates databases in native OpenSceneGraph binary format for maximum paging performance. For non OpenSceneGraph based applications you'll need to convert the database by writing your own post processing tool to convert from OpenSceneGraph native format into you own native formats, or convert to COLLADA using the OpenSceneGraph native support for reading and writing COLLADA.

The VirtualPlanetBuilder project grew from the original paged database generation tools that can as part of the OpenSceneGraph-1.2, and is now a separate project to enable both projects to focus on their own core disciplines. We are along way through a rewrite of the internals of VirtualPlanetBuilder to make it far more scalable - making it possible to create multi-terabyte paged databases, and to create them across networks of computers, each of which take part of the job of creating the complete database. We will also provide support for database optimization for the lower bandwidth constraints of web based 3d database visualization. For further details on ongoing developments see the DevelopmentPlans page.

We haven't yet made our 1.0 stable release, but it'll be along in summer of 2009. In the run up to the final 1.0 stable release we have been making a series of development releases, the latest of which if 0.9.11, released on the 22nd June 2009. The latest releases builds against the OpenSceneGraph-2.9.5 developer release or later.

svn checkout http://www.openscenegraph.org/svn/VirtualPlanetBuilder/tags/VirtualPlanetBuilder-0.9.11/ VirtualPlanetBuilder

The absolute latest are available form svn trunk:

svn checkout http://www.openscenegraph.org/svn/VirtualPlanetBuilder/trunk VirtualPlanetBuilder

The VirtualPlanetBuilder uses the OpenSceneGraph so to build it you'll first need to download and install the OpenSceneGraph, you'll need to take care of matching the VPB and OSG versions though so please check the version list at the bottom of this page.

To build VirtualPlanetBuilder we use the same build system as OpenSceneGraph so once you've built OpenSceneGraph you should feel at home with the VirtualPlanetBuilder. Under unices one simply does:

  cd VirtualPlanetBuilder
  ./configure
  make
  sudo make install

To build under Windows please follow the guidelines for building the OpenSceneGraph VisualStudio guidelines. To generate database see osgdem user guide page http://www.openscenegraph.org/projects/osg/wiki/Support/UserGuides/osgdem.

Also see the UsageExamples, CommandLineOptions and the TroubleshootingTips wiki pages.

VirtualPlanetBuilder has the following Dependencies.

Robert Osfield, Project Lead, 22nd June 2009.

Version requirements

Different versions of VPB require different versions of OSG to work correctly together.

VPB version		OSG version	Release type
VPB 0.9.1	-->	OSG 2.2	developer release to OSG stable release
VPB 0.9.7	-->	OSG 2.3.6	developer release
VPB SVN r924	-->	OSG 2.6.0	VPB svn revision to OSG stable release
VPB 0.9.8	-->	OSG 2.7.3	developer releases
VPB 0.9.9	-->	OSG 2.7.4	developer releases
VPB 0.9.10	-->	OSG 2.8.0	developer releases to OSG stable release
VPB 0.9.11	-->	OSG 2.9.5	developer release to OSG developer release
VPB svn/trunk	-->	OSG 2.9.5+ or OSG snv/trunk	current development HEAD