mapnik/demo/c++/README.md

rundemo.cpp

This directory contains a simple c++ program demonstrating the Mapnik C++ API. It mimics the python 'rundemo.py' example with a couple exceptions.

If building on unix you can have this program automatically build by configuring Mapnik like:

./configure DEMO=True

However, this example code also should be able to be built standalone.

The following notes describe how to do that on various operating systems.

Depends

• Mapnik library development headers
• mapnik-config on unix and mapnik-config.bat on windows

Unix

On OS X and Linux you also need make.

Windows

On windows, additional dependencies to build are:

• MSVS 2010 with C++ compiler
• Python 2.x
• gyp: https://code.google.com/p/gyp | https://github.com/springmeyer/hello-gyp

mapnik-config.bat should come with your Mapnik installation.

First confirm it is on your path:

mapnik-config # should give usage

To install gyp, which is pure python do:

svn checkout http://gyp.googlecode.com/svn/trunk/ gyp
cd gyp
python setup.py install

If you do not have svn installed you can grab gyp from:

https://github.com/TooTallNate/node-gyp/archive/master.zip
# unzip and extract the 'gyp' subfolder then do
cd gyp
python setup.py install

Building the demo

Unix

Simply type:

make

Then to run do:

./rundemo mapnik-config --prefix

On OS X you can also create an xcode project:

gyp rundemo.gyp --depth=. -f xcode --generator-output=./build/
xcodebuild -project ./build/rundemo.xcodeproj
./build/out/Release/rundemo `mapnik-config --prefix`

Windows

First you need to build the visual studio solution with gyp:

gyp rundemo.gyp --depth=. -f msvs -G msvs_version=2010

Then you can compile with msbuild:

msbuild rundemo.sln /p:Configuration="Release" /p:Platform=Win32

Then run it!

for /f %i in ('mapnik-config --prefix') do set MAPNIK_PREFIX=%i
Release\rundemo.exe %MAPNIK_PREFIX%