sij/mapnik
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Updated MapnikViewer (markdown)

springmeyer 2012-10-20 14:34:40 -07:00
parent dd28826aef
commit ea524bafa7
1 changed files with 17 additions and 100 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

107
MapnikViewer.md

@ -1,25 +1,11 @@
<!-- Name: MapnikViewer -->
<!-- Version: 21 -->
<!-- Last-Modified: 2011/02/07 21:46:12 -->
<!-- Author: springmeyer -->
The Mapnik Viewer is a GUI tool for rendering and viewing maps based on Mapnik XML mapfiles. The Mapnik Viewer is a GUI tool for rendering and viewing maps based on Mapnik XML mapfiles.
It's available under https://github.com/mapnik/mapnik/tree/master/demo/viewer and needs to be compiled after manually modifying the build settings. It's available in the `demo/viewer` folder of your mapnik source code. It is not compiled by default, but can be built separately after installing Mapnik.
---- ----
[[/images/mapnik_viewer.png]] [[/images/mapnik_viewer.png]]
---- ----
## A Desktop XML Viewer
1. View tile images on-the-fly.
2. Debug information on bad config files, points to the erroneous line.
3. Shows scale and envelope for current view.
4. Fast zooming and point-based attribute queries.
5. Export to a variety of formats including tif.
## Requirements ## Requirements
* A working Mapnik installation * A working Mapnik installation
@ -27,87 +13,30 @@ It's available under https://github.com/mapnik/mapnik/tree/master/demo/viewer an
* Qt4 including dev files (for example, see [Qt/Mac Open Source Edition](http://trolltech.com/developer/downloads/qt/mac)) * Qt4 including dev files (for example, see [Qt/Mac Open Source Edition](http://trolltech.com/developer/downloads/qt/mac))
* Qmake * Qmake
## Compiling ## Building
1. Modify [viewer.pro](https://github.com/mapnik/mapnik/blob/master/demo/viewer/viewer.pro) to match your system include and lib directories for boost, your mapnik build, unicode, and freetype. NOTE: these instructions assume you are using Mapnik >= 2.1. Mapnik 2.1 source code includes a `viewer.pro` file that will leverage the `mapnik-config` to get the proper build settings from your Mapnik install.
* Most default installs put the mapnik libs and includes in `usr/local`, thus requiring an include like:
Run Qmake to generate a makefile:
```sh ```sh
INCLUDEPATH += /usr/local/include/mapnik cd ./demo/viewer
```
* And a lib like:
```sh
unix:LIBS += -L/usr/local/lib -lmapnik
```
* And to link boost, freetype, and unicode from macports on Mac 10.5, for example, would require:
```sh
INCLUDEPATH += /opt/local/include/boost-1_35
INCLUDEPATH += /opt/local/include/unicode
INCLUDEPATH += /opt/local/include/freetype2
INCLUDEPATH += /opt/local/include
unix:LIBS += -L/opt/local/lib -lfreetype
```
* Since Ubuntu 10.04 those settings are enough:
```sh
QMAKE_CXXFLAGS +=' -ansi'
INCLUDEPATH += /usr/include/freetype2
LIBS += -lmapnik
```
* A patch for Mac OS 10.5 is [attachment:wiki:MapnikViewer:viewer.patch viewable here], and [downloadable here](http://trac.mapnik.org/raw-attachment/wiki/MapnikViewer/viewer.patch)
2. Modify main.cpp by setting the correct paths to Mapnik's plug-ins and fonts directories
* https://github.com/mapnik/mapnik/blob/master/demo/viewer/main.cpp#L46
* On most systems these lines should point to`/usr/local/lib/mapnik/`
```sh
datasource_cache::instance()->register_datasources("/usr/local/lib/mapnik/input");
freetype_engine::register_font("/usr/local/lib/mapnik/fonts/DejaVuSans.ttf");
freetype_engine::register_font("/usr/local/lib/mapnik/fonts/DejaVuSans-Bold.ttf");
freetype_engine::register_font("/usr/local/lib/mapnik/fonts/DejaVuSansMono.ttf");
```
3. Then run Qmake to generate a makefile
```sh
cd mapnik-svn-tree/demo/viewer
qmake -makefile qmake -makefile
``` ```
On Mac OSX the above will generate an Xcodeproject. To generate a normal Makefile do: On Mac OSX the above command may generate an XCode project. To generate a normal Makefile do:
```sh ```sh
qmake -spec macx-g++ qmake -spec macx-g++
``` ```
4. Finally, run Make to build the *viewer.app* or *viewer.exe* Finally, run Make to build the *viewer.app* or *viewer.exe*
```sh ```sh
make make
``` ```
(On OS X, you may need to instead run "open viewer.xcodeproj" to open the project in Apple's XCode environment.) On OS X, if a viewer.xcodeproj was built then open the project in Apple's XCode environment and hit "build and run"
* Your make output should be something like:
```sh
$ make
make -f Makefile.Release
/opt/local/bin/uic forms/about.ui -o ui_about.h
/opt/local/bin/uic forms/info.ui -o ui_info.h
/opt/local/bin/uic forms/layer_info.ui -o ui_layer_info.h
c++ -c -pipe -DDARWIN -Os -Wall -W -DQT_NO_DEBUG -DQT_GUI_LIB -DQT_CORE_LIB -DQT_SHARED -I/opt/local/share/qt4/mkspecs/macx-g++ -I. -I/opt/local/include/qt4/QtCore -I/opt/local/include/qt4/QtCore -I/opt/local/include/qt4/QtGui -I/opt/local/include/qt4/QtGui -I/opt/local/include/qt4 -I/usr/local/include/mapnik -I/opt/local/include/boost-1_35 -I/opt/local/include/unicode -I/opt/local/include -I/opt/local/include/freetype2 -I. -Irelease -I. -o release/main.o main.cpp
[...]
```
* If it fails you need to go back to the viewer.pro and set more lib and include paths
* A successful build will output the ready to run graphical program in that directory.
## Usage ## Usage
@ -121,11 +50,11 @@ You can also load your XML files when launching the viewer from a terminal:
```sh ```sh
# On linux this would look like: # On linux this would look like:
# ./viewer /path/to/your.xml ./viewer /path/to/your.xml
# On mac this would look like: # On mac this would look like:
$ ./viewer.app/Contents/MacOS/viewer /path/to/your.xml ./viewer.app/Contents/MacOS/viewer /path/to/your.xml
# or # or
$ open -a viewer open -a viewer
``` ```
or or
@ -133,15 +62,3 @@ or
```sh ```sh
# ./viewer your.xml -1,50,1,52 # ./viewer your.xml -1,50,1,52
``` ```
or
```sh
# ./viewer # (open your.xml from file menu)
```
## Further Reading
Related mailing list discussions:
* https://lists.berlios.de/pipermail/mapnik-devel/2008-February/000501.html