--------------------------------------------------------------------------------------------
 osm-isometric-3d
--------------------------------------------------------------------------------------------

Webfrontend and rendering script for generating isometric 3D maps of OSM data using osm2pov and povray

--------------------------------------------------------------------------------------------
 Introduction
--------------------------------------------------------------------------------------------

some basic explanation...

TBC

--------------------------------------------------------------------------------------------
 Install and configure on Mac OS X (10.7)
--------------------------------------------------------------------------------------------

1. Checkout the source of osm-isometric-3d (if you didn't already):

$ git clone git@github.com:bitsteller/osm-isometric-3d.git
$ cd osm-isometric-3d

2. Install macports (if you haven't already) and do the following:

$ port install py27-lxml
$ port select python python27
$ port install py27-pil

3. easy_install keyring (http://pypi.python.org/pypi/keyring)

4. Create a directory "osmosis" and extract the latetest stable version of osmosis (http://wiki.openstreetmap.org/wiki/Osmosis#Latest_Stable_Version) in that directory.

5. Make sure that the the osmosis executable file has the executeable permission set (in osmosis/osmosis-0.x/bin: chmod u+x osmosis). Check if the location of the executable matches the path specified in the make.py script of osm-isometric-3d. The relevant line in make.py should look something like this: COMMAND_OSMOSIS = "osmosis/osmosis-0.39/bin/osmosis"

6. TBC

...

--------------------------------------------------------------------------------------------
 Install and configure on Linux (Ubuntu)
--------------------------------------------------------------------------------------------

1. Download and install povray (http://www.povray.org) using the package manager of your distribution or by downloading the soure and compiling yourself.

2. Checkout the source of osm-isometric-3d (if you didn't already):

$ git clone git@github.com:bitsteller/osm-isometric-3d.git
$ cd osm-isometric-3d

3. Create a directory "osmosis" and extract the latetest stable version of osmosis (http://wiki.openstreetmap.org/wiki/Osmosis#Latest_Stable_Version) in that directory. 
Make sure that the the osmosis executable file has the executeable permission set. Check if the location of the executable matches the path specified in the make.py script of osm-isometric-3d. The relevant line in make.py should look something like this: COMMAND_OSMOSIS = "osmosis/osmosis-0.39/bin/osmosis"

4. sudo apt-get install python-setuptools, easy_install keyring

...

--------------------------------------------------------------------------------------------
 License
--------------------------------------------------------------------------------------------

 (C) Copyright 2010-2011 by Nils Breyer

 Project Info:  http://bitsteller.bplaced.net/osm, https://github.com/bitsteller/osm-isometric-3d

 This library is free software: you can redistribute it and/or modify
 it under the terms of the GNU Lesser General Public License as published by
 the Free Software Foundation, either version 3 of the License, or
 (at your option) any later version.
 
 This library is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU Lesser General Public License for more details.
 
 You should have received a copy of the GNU Lesser General Public License
 along with this library.  If not, see <http://www.gnu.org/licenses/>.