Skip to content


Subversion checkout URL

You can clone with
Download ZIP


This directory contains a simple c++ program demonstrating the Mapnik C++ API. It mimics the python '' 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.


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


On OS X and Linux you also need make.


On windows, additional dependencies to build are:

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 gyp
cd gyp
python install

If you do not have svn installed you can grab gyp from:
# unzip and extract the 'gyp' subfolder then do
cd gyp
python install

Building the demo


Simply type:


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`


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

C:\Python27\python.exe c:\Python27\Scripts\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%
Something went wrong with that request. Please try again.