source: subversion/applications/share/map-icons/README @ 14147

Last change on this file since 14147 was 13977, checked in by guenther, 11 years ago
  • added new scripts to work with changed icons.xml
File size: 3.6 KB
Line 
1This is the general OSM Map-Icons directory.
2All the icons in these directories have to get an
3entry into the map-features.xml file. So we have one common
4place for all icons used for drawing maps.
5
6Discussions showed that probably the best Licence for all the
7icons would be a PD-Style Licence. Because this wouldn't interfeer
8with any use which is planned. So we expect new icons inserted here
9to be PD-Style-Licence.
10
11We currently have six subdirectories representing
12the six icon schemes(classic,square.big,square.small,svg,japan).
13This means that the user can choose between those
14six (for now) styles for rendering. The styles
15are each represented in there directories:
16  - classic: normally no frames, no borders, transparent
17             but if you are unsure put the icons here
18  - square.big: these icons all have a square shaped frame,
19             where the color of the frame tells which category they belong to.
20  - square.small: similar to the above(square.big), only smaller
21  - svg: these are vectorgrafics in svg-format.
22  - jp:  these are japanese map-sign, as found in openclipart and wikipedia
23For the two svg directories there also exists an thumbnails directory which holds
24thumbnails for easier viewing on a website, ... These thumbnails directories
25 (svg_tn, jp_tn) are only created by the build process. This is the reason
26they are not found in svn (any more).
27The build proccess also takes care of filling up directories from others if it
28thinks this is usefull and possible.
29
30Inside these directories the icons are structured by category.
31Where every category has it's own sub-directory.
32There are the following top-categories:
33      - accommodation
34      - education
35      - food
36      - geocache
37      - health
38      - leisure
39      - misc
40      - money
41      - nautical
42      - people
43      - place
44      - religion
45      - rendering
46      - routing
47      - service
48      - shop
49      - sightseeing
50      - sport
51      - transport
52      - unknown
53      - vehicle
54      - waypoint
55      - wlan
56Each of these categories except 'unknown' can have sub-categories. If you 're
57adding more icons you should try to put them into one of the existing
58categories. For each (sub-)category we have a category-icon which is named
59like the category directory. So for example, for the directory <style>/food/
60we have to have an icon <style>/food.png. The same always applies to each
61sub-sub-directory. Before you start a sub-category you'll have to create an
62icon for this subcategory. This way the renderer can always take the category
63icon if there does not exist a specific icon for this.
64If you are not sure where to put the icon you should consider using
65the misc (directory misc).
66
67Additional files:
68
69- index_*.html
70        gives a nice overview of the available Icons with descriptions
71
72
73The Tools in this directory are used to maintain the map-icons directory:
74copy_icons_to_dir.sh <Verzeichnis>
75        Ist eine Art mini "make install"
76update_thumbnails.pl
77        erzeugt die beiden Verzeichnisse svg_tn und jp_tn aus den svg Dateien
78merge-icons-all-from-svg2classic2square.sh
79        versucht in dem angegebenen Verzeichnis So viele Icons durch mischen
80        der einzelnen Dateien aus den unterschiedlichen Themes zu erzeugen.
81        Sollte man auf keinen Fall im Hauptverzeichnis anwenden, wenn man
82        geänderte Icons dort hat, denn sonst kennt man sich danach gar nicht mehr
83        aus. Update_thumbnails sollte vorher ausgeführt werden, denn von dort wird
84        auch versucht die Daten zu holen.
85copy_icons_to_debian_package_dirs.pl
86        Verteilt die Icons in build/* in die debian packages
87
88create_makefile.sh
89        Ist geblieben und erzeugt immer noch das alte automake Makefile.am
90
Note: See TracBrowser for help on using the repository browser.