JOSM/Plugins/MapPaint

From OpenStreetMap

An alternative render for the map with colouring, line thickness, icons after tags. You can also customize your map as you like.

Please note: Since JOSM 486, Mappaint is now included into JOSM, so no need to install a separate plugin.

Contents 1 Rendering 1.1 Nodes 1.2 Ways 1.3 Areas 2 Preferences 3 Styles 3.1 Standard style 3.2 Create your own style 4 Real width mode 4.1 Width of a street 4.2 Direction arrows 5 TODOs

Rendering

Mappaint renders the map data so it looks much more like a map (colors, icons, annotations, ...) - compared to the standard JOSM renderer.

Nodes

Most nodes that corresponds to tags in the Map_Features page will show an appropriate icon, e.g. a "P" on blue ground for amenity=parking.

There are some special icons for missing/incomplete things:

missing icon: we just don't have an appropriate icon for this tag yet

We don't have the right icon for every node tag in map features yet, e.g. icons for most natural=xy tags are still missing. If you encounter such a "missing icon", feel free to create a nice 16*16 pixel icon that matches the tag and send it to the talk list.

caution icon: the corresponding tag is only a proposal and not approved yet, so it may change in the future

Only a few proposed tags will show this icon. There are lot's of proposals floating around, so this can only be a "subjective incomplete selection". Also be prepared that a proposed tag may change before the feature is actually approved.

deprecated icon: the corresponding tag was once used but is no longer recommended to be used

Probably not all deprecated tags will show this icon.

Ways

Most ways that correspond to tags in the map features page will get special color, thickness and line style (e.g. dashed lines for railways).

Areas

Areas are ways that form a sort of ring. Most areas that corresponds to tags in the map features page will be filled with a special color (the filling will be transparent to some degree).

Preferences

You can use the following preferences in your ~/.josm/preferences file with this plugin.

• mappaint.fillareas
  • true (default) - areas will be filled with their corresponding colour
  • false - areas will be surrounded by dashed lines
• mappaint.fillalpha (since mappaint 5024)
  • alpha "opacity level", that is used to fill areas. An integer value between 0 (transparent) and 255 (solid) with the default of 50.
• mappaint.style
  • standard (default) - use a style named "standard"
  • "something else" - use a style named "something else"
• mappaint.useRealWidth
  • true (default) - ways will change width corresponding to the real width in meters set in the elemstyle.xml file
  • false - ways will have the same width on every zoom level (no longer the default since mappaint 6030)

Styles

Standard style

With mappaint your map will look much different then in JOSM "wireframe" before. This is the "standard" mappaint style that is compiled into JOSM.

Create your own style

You don't like the standard style? Change it to your own liking:

• Go to your plugins folder and make a folder named mappaint, i.e.
  • Linux: ~/.josm/plugins
  • Windows Vista: systemdisk:\Users\username\AppData\Roaming\JOSM\plugins
  • Windows XP: systemdisk:\Documents and Settings\username\Application Data\JOSM\plugins
• Go to the newly created mappaint folder.
• Open josm-xxx.jar with your favorite zip tool (WinZip, ...) and copy the whole standard directory (located inside of the styles dir) into the newly created plugins/mappaint
• rename the directory standard to your new style name (e.g. mystyle)
• Go into that (mystyle) directory. Now you can edit the elemstyles.xml (a small help is at the top comment of that file)
• start JOSM, open the Edit/Preferences dialog and select the Advanced Preferences
• add the line mappaint.style=mystyle (or whatever you've named the new style)
  • note if this is the first time there will not be an existing mappaint.style entry
• ... restart JOSM and your new style will be used!!

Real width mode

Setting the option

mappaint.useRealWidth=true

in your preferences file starts the plugin in real width mode.

Width of a street

If the real width of a way type is given in the elemstyles.xml file the road will be scaled to this width. If you zoom closer to a road it will get wider, this gives you a better control of putting things near the road (fuel stations etc.)

Direction arrows

Direction arrows in this mode are only drawn for selected items, this gives you a a significant speedup while moving the map. Its done also because drawing an arrow for a street which covers nearly the whole screen is not possible. The selected way is also scaled down to a thin line, to allow drawing nice arrows.

TODOs

Taken from Essen Developers Workshop/JOSM

• Further line styles (dashed, dash-dotted etc.) which we can use for areas (landuse)
• Better visualisation if a selected item is a segment or a way (segments are gone)
• Create a list of tags of the loaded data and let the user hide certain tags (landuse, natural etc.). This is needed to avoid streets to be connected to administrative borders etc.
• Choose different colours for tagged or connected nodes to visualise senseless nodes (see JOSM/Plugins/Validator)
• Fix the drawing of nodes so that doesn't use the last selected way width

others

• Fix the drawing of nodes when a way has been split
• when a way has highway=* and railway=*, draw both, starting with the highway representation
• make mappaint.fillalpha.selected