mapnik/plugins/input/templates/helloworld
2013-01-25 00:49:55 -08:00
..
build.py add back depedence of hello world plugin on libmapnik accidentally removed in refactoring in 3e67c1d694 2013-01-13 22:16:43 -08:00
hello_datasource.cpp remove bind option for datasources - refs #962 2012-12-17 10:03:07 -08:00
hello_datasource.hpp remove as much mutable as possible 2012-12-17 12:59:15 -08:00
hello_featureset.cpp fixup includes and value type and params usage across plugins 2013-01-04 09:23:06 -08:00
hello_featureset.hpp fixup includes and value type and params usage across plugins 2013-01-04 09:23:06 -08:00
Makefile recompile stale targets during deploy 2012-07-10 14:50:43 -07:00
README.md tests: make consistent the proj4 string for epsg:4326 2013-01-25 00:49:55 -08:00
test.xml tests: make consistent the proj4 string for epsg:4326 2013-01-25 00:49:55 -08:00

hello world plugin

This is a very simple sample plugin. It is designed to help developers see the skeletal basics needed to achieve a functional datasource plugin.

It is not a model plugin of best practices as much as a model of the bare minimum you need to have a working plugin that returns a single feature.

Code comments attempt to highlight which code is mandatory, which is simply recommended, and which is purely fluff used to get the plugin to actually show some data.

When added to a map it provides a single point geometry representing the center of any query. This means that it should place a point in the middle of any map tile and display a "hello world!" label if used like:

style hello

Or used in python like:

from mapnik import * m = Map(600,400) m.background = Color('white') s = Style() r = Rule() r.symbols.append(PointSymbolizer()) t = TextSymbolizer(Expression("[key]"),"DejaVu Sans Book",10,Color('black')) t.displacement = (15,15) r.symbols.append(t) s.rules.append(r) m.append_style('style',s) ds = Datasource(type="hello") l = Layer('test') l.styles.append('style') l.datasource = ds m.layers.append(l) m.zoom_all() render_to_file(m,'test.png')