Skip to content
This repository

Changes between Mapnik 0.7.x and Mapnik 2.0

XML

Global Changes

Underscores --> Dashes

All properties that previously used underscores, ie '_' now use dashes ('-'). So, for example: 'allow_overlap' is now 'allow-overlap'

  • Mapnik 0.7.2 has compatibility with both syntaxes as of r2579
  • Mapnik 2.0 moved to only dashes in r2582
  • properties changed include:
['paths_from_xml','minimum_version','buffer_size','face_name,fonset_name','clear_label_cache','vertical_alignment','halo_fill','halo_radius','text_ratio','wrap_width','wrap_before','wrap_character','text_transform','line_spacing','label_position_tolerance','character_spacing','min_distance','minimum_distance','avoid_edges','allow_overlap','max_char_angle_delta','horizontal_alignment','justify_alignment','unlock_image','no_text']

CSSParameters --> Properties

This change affects the PolygonSymbolizer, LineSymbolizer, RasterSymbolizer, and BuildingSymbolizer only.

All CSSParameters have been removed, so for example, this:

    <PolygonSymbolizer>
        <CssParameter name="fill">yellow</CssParameter>
    </PolygonSymbolizer>

is now:

    <PolygonSymbolizer fill="yellow" />

Changes by Element

Map

component old new
Map bgcolor background-color
Map did not exist background-image

Symbolizers

component old new
TextSymbolizer name='field' name='[field]'
TextSymbolizer text_convert text-transform
TextSymbolizer min_distance minimum-distance
TextSymbolizer did not exist minimum-padding
PointSymbolizer / PolygonPatternSymbolizer / LinePatternSymbolizer width removed
PointSymbolizer / PolygonPatternSymbolizer / LinePatternSymbolizer height removed
PointSymbolizer / PolygonPatternSymbolizer / LinePatternSymbolizer type removed

Python API

component old new
mapnik mapnik.Envelope mapnik.Box2d
TextSymbolizer set_displacement (function) displacement (property)
TextSymbolizer first argument was string first argument now mapnik2.Expression('[field]')
ShieldSymbolizer first argument was string first argument now mapnik2.Expression('[field]')
ShieldSymbolizer fifth argument was string fifth argument now mapnik2.PathExpression('/path/to/[field].png')

C++ API

component old new
mapnik::Map getWidth width
mapnik::Map getHeight height
mapnik::Map zoomToBox zoom_to_box
mapnik::Map setBackground set_background
mapnik::Map getCurrentExtent get_current_extent
mapnik::Map zoomToBox zoom_to_box
mapnik:: mapnik::Layer mapnik::layer
mapnik:: mapnik::Envelope mapnik::box2d
mapnik:: mapnik::ImageData32 mapnik::image_data_32
mapnik:: mapnik::Image32 mapnik::image_32
mapnik:: mapnik::Image8 mapnik::image_8
mapnik:: mapnik::rule_type mapnik::rule
mapnik:: mapnik::create_filter mapnik::parse_expression

Planned/Proposed Before Release

Python API

  • Image.tostring -> Image.encode()
  • All remaining uses of 'envelope' -> 'box2d' (like ds.envelope())
Something went wrong with that request. Please try again.