{{{ #!comment This contains the list of external style addresses. It will be parsed about each 10 minutes and is used to update the styles list. http://maps.tilusnet.com/josmdata/elemstyles_nolabels.xml http://www.freietonne.de/ft_icons/josm/FreieTonne_rules_presets_zip.php http://github.com/avar/osmis-josm-style/raw/master/elemstyles_is.xml http://dev.openseamap.org/josm/seamark_styles.xml http://dev.openseamap.org/josm/sport_styles.mapcss http://osmalba.org/josm_styles/naptan_bus_stops.zip http://github.com/bastik/mapcss-tools/raw/osm/mapnik2mapcss/osm-results/mapnik.zip https://raw.github.com/molysgaard/OAM-JOSM/master/oam-style.mapcss https://github.com/simon04/coloured-addresses.mapcss/raw/master/dist/coloured-addresses.mapcss http://www.country-linedance.de/daten/Historic_Stones.zip }}} {{{ #!comment Note for translators: - The above list and this note can be stripped from translation. - The reference below to change the source of this page should be modified, so it tells the reader to modify the English page. }}} [[TranslatedPages]] = JOSM Map Styles = [[Image(source:trunk/images/dialogs/mapstyle.png)]] The JOSM map display can be customized with different styles. == Choose Styles == JOSM offers a preselection of styles, that can be turned on or off in the [[Help/Dialog/MapPaint|map style dialog]]. There are base styles (e.g. [http://josm.openstreetmap.de/svn/trunk/styles/standard/elemstyles.xml JOSM standard] or [http://josm.openstreetmap.de/svn/trunk/styles/standard/potlatch2.mapcss Potlatch 2]) that cover a wide range of features each. They can be combined with add-on styles that cover more special topics: [[Styles(en|styles|short description|author|description|version|More details)]] To add more styles to your list, open the map style preferences by clicking the [[Image(source:trunk/images/dialogs/mappaintpreference.png)]][[Help/Dialog/MapPaint#MapStyleSettings|Settings]] button in the map style dialog. ''(Alternatively you can navigate directly to the [Help/Preferences/Map#MapPaintStyles Map Paint Styles Preferences]: Edit -> Preferences -> [[Image(source:trunk/images/preferences/map.png,15)]] Map Settings (3rd button on the left) -> Map Paint Styles (2nd tab))'' ''Example'': Let's assume that you're interested in sea maps, then you probably will make use of the style "SeaMap FreieTonne": Just highlight this entry in the "Available Styles" list by clicking on it and and press the [[Image(source:trunk/images/preferences/activate-right.png)]]-button in the center. Now it should be one of your "Active Styles". Well, let's continue with advanced style usage! You created your own style (see below on this page)? Just click the [[Image(source:trunk/images/dialogs/add.png)]]-sign on the right and enter either path and filename or URL of your style file. == Create your own style == You don't like the standard style? Change it to your own liking: * In the [[Help/Dialog/MapPaint|map style dialog]], right click one of the styles and select [[Image(source:/trunk/images/copy.png)]]"save as...". A copy will be added to the list of styles. You can open the file in a text editor and reload after doing some changes. * Or create a style from scratch and add it in the JOSM mappaint preferences. JOSM supports two formats to define a style: JOSM XML:: The traditional style format in JOSM. The [http://josm.openstreetmap.de/svn/trunk/styles/standard/elemstyles.xml standard style] contains some documentation. MapCSS:: Style language similar to [http://en.wikipedia.org/wiki/Cascading_Style_Sheets CSS] originally developed for Potlatch 2, but aims to be a standard for map styles. (since r3902) * General information can be found in the [http://wiki.openstreetmap.org/wiki/Category:MapCSS osm wiki]. * A [[Help/Styles/MapCSSTutorial|Short tutorial]] should get you started. * The [[Help/Styles/MapCSSImplementation|JOSM implementation reference]] lists the supported features in more detail. Style files with different formats are compatible, they can be loaded at the same time. == Make your style available to other users == * Either edit this wiki page and add URLs for new style files to the list at the top. * Or create a wiki page similar to [[Styles/Maxspeed]] (XML) or [[Styles/Modified]] (MapCSS). In both cases, the new style will be automatically listed in the table above after a few minutes. Then it will also be available in the JOSM mappaint preferences (after clicking the reload button). === Icon handling === There are different forms to handle icons: * Icons distributed with JOSM can be entered directly with the path (relative to JOSM's internal image directory). * Use a path relative to your local style file. * New icons can be directly referenced using a http-link. These are downloaded and cached internally. * Since JOSM version 2289 Zip-Files are supported. * The zip file must contain at least one file with extension xml. * Icon names and path are relative to the topmost zip directory. * If there are multiple XML files, a file with "style" in the name is preferred (to allow packaging styles and presets in one archive). * When the JOSM wiki is used for designing of new styles you have some additional options: * Each file attached to the wiki page is automatically included in the Zip downloaded by JOSM. * If you don't want a file in the Zip file, add the text '''(NOZIP)''' in the description of the attachment. * If you add a Zip file and want its contents included, you may add '''(EXTRACT)''' in the description of the attachment. * The server automatically switches from download of single file to Zip download when files are attached. == Styles managed in JOSM wiki == [[TitleIndex(Styles/)]] [[Styles/Historic_Stones]] == Rendering == Mappaint renders the map data so it looks much more like a map (colors, icons, annotations, ...) - compared to the JOSM wireframe mode. === Nodes === Most nodes that corresponds to tags in the [http://wiki.openstreetmap.org/wiki/Map_Features 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: [[Image(Mappaint_no_icon.png)]] missing icon[[br]] 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. To submit your work, open a [/newticket new ticket] and add your image or zip archive as attachment. [[Image(Mappaint_deprecated.png)]] warning icon[[br]] The corresponding tag was once used but is no longer recommended to be used - or - it is not suitable for a node, e.g. highway=motorway just doesn't make sense on a node. 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). == Advanced Preferences == You can use the following hidden preferences: * mappaint.fillalpha * alpha "opacity level", that is used to fill areas. An integer value between 0 (transparent) and 255 (solid) with the default of 50. * mappaint.fillareas (show areas) * 10000000 (default) - areas will be filled with their corresponding colour and name will be rendered * 0 - areas will be surrounded by lines only and name will not be rendered * any other number - areas will be filled with their corresponding colour and name will be rendered at any zoom level below the given number in meters * mappaint.showicons * select whether icons are shown - same values as mappaint.fillareas * mappaint.shownames * select whether names are shown - same values as mappaint.fillareas * mappaint.strokes * select whether strokes or full lines are used - same values as mappaint.fillareas * mappaint.useRealWidth * true - ways will change width corresponding to the real width in meters set in the elemstyle.xml file * false (default) - ways will have the same width on every zoom level * mappaint.zoomLevelDisplay * true - elements visibility depends on zoom level * false (default) - all elements are displayed * mappaint.fontsize * 8 - size of mappaint texts