-----------------------------------------------------------------------------
|    ___  ___  _  _ _     ___                                        _      |
|   / __>| . \| || \ |   | __>_ _  ___ ._ _ _  ___  _ _ _  ___  _ _ | |__   |
|   \__ \|  _/| ||   |   | _>| '_><_> || ' ' |/ ._>| | | |/ . \| '_>| / /   |
|   <___/|_|  |_||_\_|   |_| |_|  <___||_|_|_|\___.|__/_/ \___/|_|  |_\_\   |
|                                                                           |
|---------------------------------------------------------------------------|

http://spinframework.org
Copyright (C) 2009 Mike Wozniewski, Zack Settel

Developed/Maintained by:
   Mike Wozniewski (http://www.mikewoz.com)
   Zack Settel (http://www.sheefa.net/zack)

Principle Partners:
   La Société des Arts Technologiques (http://www.sat.qc.ca)
   Institut Arts Cultures et Technologies, Université de Montréal (http://www.iact.umontreal.ca)    
   Shared Reality Lab, McGill University (http://www.cim.mcgill.ca/sre)

Funding by:
   NSERC/Canada Council for the Arts - New Media Initiative
   Heritage Canada
   Ministere du Developpement economique, de l'Innovation et de l'Exportation

About
-----

The SPIN Framework allows for 'Spatial Interaction' in a networked system of virtual environments. Tools are provided for high-level layout of 3D content, visualization, and distribution of state over networks. Possible application areas include:

    * Immersive Environments / Virtual Reality
    * Collaborative 3D authoring and editing
    * Telepresence
    * Visualization
    * Distributed Performance Art
    * Online Game / Metaverse Engines

One of the key features of the system is that spatial layout and editing is done in real time rather than in an offline process. This allows for rapid prototyping of virtual environments and interaction. Network communication is achieved through OpenSoundControl (OSC), allowing the use several existing systems for control flow, including Pure Data, Max/MSP, Processing, etc. The framework provides generic mechanisms for spatial manipulation, based on geometric events (movement, intersection, incidence, etc.), so a number of interaction paradigms can be explored.

A number of audio/video/image formats are supported by means of the OpenSceneGraph (OSG) library and its extensible plugin architecture. Additionally, powerful rendering and visualization solutions can be realized, including multi-projector configurations, and distortion correction for cylindrical or hemispheric displays.

Ultimately, the SPIN Framework allows for the creation of collaborative environments where several distributed users can share and interact with immersive 3D content.

Dependencies
------------
 * Compile and install openscenegraph 2.9.8 or later.
 * Compile and install wxwidgets2.9 2.9.1 or later.
   On Ubuntu, you can get the libwxgtk2.9-dev package from the Metalab PPA. Do this:
   $ sudo add-apt-repository ppa:sat-metalab/metalab
   $ sudo apt-get update
   $ sudo apt-get install libwxgtk2.9-dev libcppintrospection-2.11-dev
   $ sudo ln -s /usr/lib/wx/config/gtk2-unicode-2.9 /usr/local/bin/wx-config
 * Compile and install cppintrospection from the https://github.com/sat-metalab/cppintrospection

Compiling
---------

./autogen.sh (if from svn/git, not the tarball)
./configure
make 


Installing 
----------

sudo make install