OSG Virtual Planets Framework
=============================

OSG Virtual Planets is a development framework to render Planets with different
projection and load data dynamicly. The System provides a set of utilities and
libraries to create planets, manage layers, render vectorial data, or even
manipulate 3d objects.

Subversion Repository
---------------------

Team Developers: svn co https://gvsig.org/svn/osgvp/trunk osgVP
External Developers: svn co http://subversion.gvsig.org/osgvp/trunk osgVP

Project Page
------------

https://gvsig.org/web/projects/gvsig-commons/osgvp

Setting Build Environment
-------------------------

The minimum requirements to compile are:
- Maven.
- CMake.
- VS7/VS8/VS9 in Windows.
- g++ in Linux and MacOsX.

Build and Execution Dependencies
--------------------------------

We have added automatic download of native dependencies using maven, so is not
necessary download an compile this dependencies anyway you can do it if your
system is not supported.

- GDAL (http://www.gdal.org):
	Download and compile/install gdal in your system. 
	Export the enviromental variable GDAL_DIR pointing to gdal sdk(include,
	bin, lib directories)

- OpenSceneGraph (http://www.openscenegraph.org):
	Download and compile/install OpenSceneGraph version 2.8.2 in with GDAL
	support in your system, then export OSG_DIR environment variable pointing to
	the SDK installed dir. (MAKE SURE YOU HAVE GDAL SUPPORT INSIDE OSG).  Export
	the environmental variable OSG_DIR pointing to the sdk(include, bin, lib
	directories)

- JOGL (http://jogl.dev.java.net):
	Download and install jogl inside system PATH. It's only required for
	execution environment.

Setting Execution Environment
-----------------------------

Linux:
	export OSG_DIR=/path-to-openscenegraph-sdk
	export LD_LIBRARY_PATH=/path-to-jogl-natives/:/path-to-gdal-natives/:$OSG_DIR/lib:$LD_LIBRARY_PATH

Windows
	set OSG_DIR=C:\path-to-openscenegraph-sdk
	set PATH=C:\PATH-TO-JOGL-NATIVES\:C:\PATH-TO-GDAL-NATIVES\;%OSG_DIR%\bin:%PATH%

Mac:
	export OSG_DIR=/path-to-openscenegraph-sdk
	export DYLD_LIBRARY_PATH=/path-to-jogl-natives/:/path-to-gdal-natives/:$OSG_DIR/lib:$DYLD_LIBRARY_PATH


Build Instructions
------------------

To Compile and Develop Minimum Components:
 $ mvn install -Dmaven.test.skip=true
 $ mvn eclipse:eclipse
 $ mvn eclipse:add-maven-repo -Declipse.workspace="."

Distribution Instructions
-------------------------

To create a deployable package on web:
 $ mvn install assembly:assembly -Dmaven.test.skip

To deploy to maven repository:
 $ mvn deploy -Dmaven.test.skip

Additional Build Notes
----------------------

We have added a maven scripts that allows the distribution and management of
native dependencies, so you can change some required build conditions if your
system is not the default.

Build for VS9 compiler on windows:
 $ mvn install -Dmaven.test.skip=true -Dnative-compiler=vs9
 $ mvn eclipse:eclipse -Dnative-compiler=vs9
 $ mvn eclipse:add-maven-repo -Declipse.workspace="."
 
Build for Ubuntu 8.10 distribution:
 $ mvn install -Dmaven.test.skip=true -Dnative-distribution="Ubuntu-8.10"
 $ mvn eclipse:eclipse -Dnative-distribution="Ubuntu-8.10"
 $ mvn eclipse:add-maven-repo -Declipse.workspace="."