Context Navigation

Editing DevelopersGuide/DefaultPresets

Adjust edit area height: Edit side-by-side

[[TranslatedPages]]
= Defaultpresets Guidelines

Some rough guidelines for the [source:trunk/data/defaultpresets.xml defaultpresets] (Starting point was ticket:10246#comment:14)

== New Tags and Values
Basically we have to make sure that the preset menu isn't too cluttered, because it would get hard to find the useful every-day stuff if we had too many exotic entries. New tags and values should have:
* a proper documentation in the [osmwiki: OSM-wiki]
* decent usage numbers (absolute and by number of mappers)
* Controversial cases (like `contact:phone=*` vs. `phone=*`) need to be decided case by case
* If a features is only mapped by a handful of specialists, it is better suited for an [wiki:Presets#Createnewpresets external preset]. Usually this includes tagging schemes restriced to one specific country, hobby, sport or profession.

**Note**:
* When investigating [https://taginfo.openstreetmap.org taginfo], also check **where** unusual values are used.
 * You can use overpass API to load these object in JOSM and check in the history who created them.

* When modifying the defaultpresets also the [source:josm/trunk/styles/standard/elemstyles.mapcss main mappaint style] and maybe also [source:josm/trunk/data/validator validator rules] should be changed for consistency.

== New Icons
* The preferred file format is '''svg''' (for lossless scaling). If this is not possible then png.
* Check if the svg file correctly works with JOSM. There are some svg libraries which do not work with JOSM (the images get deformed). If you have such a file try the following workaround: create a new svg document with Inkscape, copy the svg data to this new file, resize the page to the data and save.
* Check the code of the file in a text editor. Search for '''viewBox''' value in the beginning of the file. If the icon is, for example, in 16x16 pixels, and if you made it in Inkscape (at least this happens in 0.91 version) and have defined in Document Properties 16,00000 by 16,00000 pixels, probably in the file code you have these values '''viewBox="0 0 16.000002 16.000001"'''. Change it to '''viewBox="0 0 16 16"''' or you will have problems (see #12201 and the fix [o31865])
* svg icons are automatically cleaned up to reduce file size in the JOSM build. So there is no need to do this step manually before uploading svg files to svn. See comment:35:ticket:10479 and comment:10:ticket:10877
* The icon should be identifiable at a size of '''16 pixels'''. This is the size the icons are displayed in the [[Help/MapView|Map View]].
* The '''license''' needs to be compatible with GPL3 (like PD or CC0). A good source for Icons is [http://openclipart.org openclipart.org] (all icons there are PD).
* If the tag applies to nodes, the icon in the MapView and the icon of the preset should be the same if possible. (It is not possible when different features use the same preset, e.g. crossing=island and crossing=traffic_signals have different icons, but are handled in only one preset "Pedestrian Crossing".)
* Icons with transparent background must '''not be only black or only white'''. Otherwise if one uses a black or white background (no aerial imagery as background) in the Map View black or white icons would be invisible. Workaround: if you want to use a black icon add a square white background to the icon instead of a transparent background. This doesn't look pretty but is better than an invisible icon. [[BR]] Example: [[Image(BlackWhiteIcon.png,middle)]]
* The icon should be understandable in all countries.

----
Back to [wiki:/DevelopersGuide Developers Guide]

Note: See WikiFormatting and TracWiki for help on editing wiki content.

Change information

Your email or username:

E-mail address and name can be saved in the Preferences

Comment about this change (optional):

Attachments (1)

BlackWhiteIcon.png (694 bytes ) - added by Klumbumbus 9 years ago.

Download all attachments as: .zip

Note: See TracWiki for help on using the wiki.