| 9 | | === Layer types === |
| 10 | | |
| 11 | | JOSM has several types of layers. |
| 12 | | Each has a Menu accessed from the right mouse button which provides operations on the layer. |
| 13 | | |
| 14 | | * [[Image(source:trunk/images/layer/osmdata_small.png,link=)]] [wikitr:/Help/Menu/OSMLayer Data layer] - |
| 15 | | Holds a set of map data [wikitr:/Help/Concepts/Object objects].\\ |
| 16 | | Map data can usually be downloaded, created and edited unless the [wikitr:/Help/Menu/OSMLayer#Layerstate layer state] is [[Image(source:trunk/images/warning-small.png,link=)]] [wiki:Help/Action/BlockDownload private] or [[Image(source:trunk/images/lock.svg,13px,link=)]] [wiki:Help/Action/LockedLayer locked]. |
| 17 | | A running upload is indicated by [[Image(source:trunk/images/clock.png,15,link=)]]. |
| 18 | | Some uploads are marked [wiki:Help/Action/EncourageDiscourageUpload risky] for OSM. |
| 19 | | * [[Image(source:trunk/images/layer/gpx_small.png,link=)]] [wikitr:/Help/Menu/GPXLayer GPX layer] - |
| | 9 | == Layer types ==#Layertypes |
| | 10 | * [[JOSMImage(layer/osmdata_small,24,middle,link=)]] [wikitr:/Help/Menu/OSMLayer Data layer] - |
| | 11 | Holds [wikitr:/Help/Concepts/Object map objects] as data set. A [[JOSMImage(clock,middle,24,link=)]] clock indicates an running upload. \\ |
| | 12 | Editing, downloading and uploading data may be restricted by the [wikitr:/Help/Menu/OSMLayer#LayerState layer state]. \\ |
| | 13 | The indicators **Ø** ''(empty)'' and '''*''' ''(modified)'' are placed at the end of the line behind the name. |
| | 14 | * [[JOSMImage(layer/gpx_small,24,bottom,link=)]] [wikitr:/Help/Menu/GPXLayer GPX layer] - |
| 22 | | * [[Image(source:trunk/images/layer/marker_small.png)]] [wikitr:Help/Menu/Marker Marker Layer] - |
| 23 | | Holds identified points on a GPX track, called ''Markers''. |
| 24 | | They are created in four varieties: |
| 25 | | [wikitr:/Help/Action/MarkersFromNamedPoints Named], [wikitr:/Help/Action/ImportAudio Audio], [wikitr:/Help/Action/ImportImages Image] and Web. |
| 26 | | * [[Image(source:trunk/images/dialogs/geoimage.svg,16,link=)]] [wiki:Help/Menu/PhotoLayer Geoimage layer] - |
| 27 | | Holds images which were imported via a GPX layer, dragged on the [wikitr:/Help/MapView Mapview] or [wikitr:/Help/Action/Open opened]. |
| 28 | | * [[Image(source:trunk/images/imagery_small.png,link=)]] [wikitr:/Help/Menu/ImageryContextMenu Imagery Layer] - |
| | 17 | * [[JOSMImage(layer/marker_small,24,middle,link=)]] [wikitr:/Help/Menu/Marker Marker Layer] - |
| | 18 | Holds identified points on a GPX track, called ''Markers''. |
| | 19 | * [[JOSMImage(dialogs/geoimage,24,middle,link=)]] [wikitr:/Help/Menu/PhotoLayer Geoimage layer] - |
| | 20 | Holds images which were [wikitr:/Help/Action/Open opened], dragged on the [wikitr:/Help/MapView Mapview] or imported via a GPX layer. |
| | 21 | * [[JOSMImage(wikimedia_commons,link=,middle,24)]] Wikimedia Commons - [wikitr:/Help/Menu/PhotoLayer Geoimage layer] for images downloaded with [wikitr:/Help/Action/WikimediaCommonsLoader Load images from Wikimedia Commons]. |
| | 22 | * [[JOSMImage(imagery_menu)]] [wikitr:/Help/Menu/ImageryContextMenu Imagery Layer] - |
| 30 | | * [[Image(source:trunk/images/layer/validator_small.png,link=)]] [wiki:Help/Menu/Validator Validator layer] - |
| 31 | | Highlights errors or [wiki:Help/Dialog/Validator warnings] for objects on the active data layer. |
| 32 | | * [[Image(source:trunk/images/dialogs/notes/note_open.png,15,link=)]] [wikitr:/Help/Menu/Notes Notes layer] - |
| 33 | | Holds [wiki:Help/Dialog/Notes Notes] from [osmwiki:Notes OSM]. |
| | 24 | * [[JOSMImage(dialogs/validator)]] [wikitr:/Help/Menu/Validator Validator layer] - |
| | 25 | Highlights errors or [wikitr:/Help/Dialog/Validator warnings] for objects on the active data layer. |
| | 26 | * [[JOSMImage(dialogs/notes/note_open)]] [wikitr:/Help/Menu/Notes Notes layer] - |
| | 27 | Holds [wikitr:/Help/Dialog/Notes Notes] from [osmwiki:Notes OSM]. |
| 40 | | == Layer Buttons == |
| | 35 | ||= **Icon** =||= **Description** =|| |
| | 36 | || [[JOSMImage(dialogs/layerlist/active,24,link=,middle)]] ||\ |
| | 37 | || Activate this layer || |
| | 38 | || [[JOSMImage(dialogs/layerlist/scale,24,middle,link=)]] ||\ |
| | 39 | || Snap/unsnap the map zoom to the native resolution of this background imagery || |
| | 40 | || [[JOSMImage(dialogs/layerlist/offset,24,link=,middle)]] ||\ |
| | 41 | || Reset the imagery offset || |
| | 42 | || [[JOSMImage(dialogs/layerlist/eye,24,link=,middle)]] ||\ |
| | 43 | || Hide/unhide the layer || |
| 42 | | || [[Image(source:trunk/images/dialogs/layerlist/active.png,link=)]] || \ |
| 43 | | || Make this layer the active layer || |
| 44 | | ||[[Image(source:trunk/images/dialogs/layerlist/scale.svg,16,link=)]] || \ |
| 45 | | || Snap/unsnap the map zoom to the native resolution of this background imagery || |
| 46 | | || [[Image(source:trunk/images/dialogs/layerlist/eye.png,link=)]] || \ |
| 47 | | || Hide/unhide the layer || |
| | 45 | === Panel Buttons ===#PanelButtons |
| | 46 | {{{#!comment |
| | 47 | #PanelButtons target is called from Help/MapView |
| | 48 | }}} |
| | 49 | The Layers List has five buttons at its bottom which operate on the marked layers: |
| 60 | | === Activate Layer === #ActivateLayer |
| 61 | | [[Image(source:trunk/images/dialogs/activate.svg,link=)]] |
| 62 | | ''Keyboard shortcut'': **{{{Shift+A}}}** ('''''release keys''''') then **{{{[0-9]}}}** - counting from the top |
| | 58 | ==== Activate Layer ==== #ActivateLayer |
| | 59 | [[JOSMImage(dialogs/activate,middle,margin-right=10,link=)]] **Activate** activates the marked layer. |
| | 60 | It is only possible to edit map data in an active Data layer. |
| | 61 | Each of the layers can be activated with an individual keyboard shortcut sequence: **`Shift+A` followed by `[1–0A-Z]`** - where `1` is the top layer; counting down to `9`, then `0` which activates 10, then `A-Z`. Press **`Shift+A`** only and wait a second. JOSM will display a list with all layers and their shortcuts in this format. |
| 64 | | **Activate** activates the selected layer. |
| 65 | | It is only possible to edit in an active Data layer. |
| | 63 | ==== Visibility ==== #VisibilityLayer |
| | 64 | [[Image(gpx_colors.png,link=,right,margin-left=10)]] |
| | 65 | [[JOSMImage(dialogs/layerlist/visibility,middle,margin-right=10,link=)]] Once clicked on, it offers: |
| | 66 | * A checkbox to show/hide a layer, i.e. turns visibility of marked layers on or off. The layers are unchanged when hidden, but their contents are not shown. You can also use shortcuts to show/hide a layer, see keyboard shortcuts [#KeyboardShortcuts below]. |
| | 67 | * A slider to adjust the [[JOSMImage(dialogs/layerlist/transparency,16,bottom,link=)]] **Opacity** of marked layers. |
| | 68 | * A slider to adjust the [[JOSMImage(dialogs/layerlist/colorfulness,16,bottom,link=)]] **Colorfulness** of marked layers. |
| | 69 | * A slider to adjust the [[JOSMImage(dialogs/layerlist/gamma,16,bottom,link=)]] **Gamma** of marked layers. |
| | 70 | * A slider to adjust the [[JOSMImage(dialogs/layerlist/sharpness,16,bottom,link=)]] **Sharpness** of marked layers. |
| | 71 | Colorfulness, Gamma and Sharpness are only available for imagery layers. |
| 67 | | === Visibility === #VisibilityLayer |
| 68 | | [[Image(source:trunk/images/dialogs/layerlist/visibility.png,link=)]] |
| 69 | | |
| 70 | | Following hotkeys used to control visibility of top10 or bottom10 layers: |
| 71 | | * {{{Shift+S}}} ('''''release keys''''') then **{{{[0-9]}}}** - where 0 it the top layer; 9 - bottom |
| 72 | | * **{{{Alt+[0-9]}}}** - counting from the bottom; 1 - first from the bottom; 0 - bottom10 |
| 73 | | |
| 74 | | Once clicked on, it offers: |
| 75 | | * A checkbox to show/hide a layer, i.e. turns visibility of selected layers on or off. The layers are unchanged when hidden, but their contents are not shown. You can also use the following shortcuts to show/hide a layer: |
| 76 | | * A slider to adjust the [[Image(source:trunk/images/dialogs/layerlist/transparency.png,16,link=)]] **Opacity** of selected layers. |
| 77 | | * A slider to adjust the [[Image(source:trunk/images/dialogs/layerlist/colorfulness.png,16,link=)]] **Colorfulness** of selected layers. |
| 78 | | * A slider to adjust the [[Image(source:trunk/images/dialogs/layerlist/gamma.png,16,link=)]] **Gamma** of selected layers. |
| 79 | | * A slider to adjust the [[Image(source:trunk/images/dialogs/layerlist/sharpness.png,16,link=)]] **Sharpness** of selected layers. |
| 80 | | Colorfulness, Gamma and Sharpness are only availible for imagery layers. |
| 81 | | |
| 82 | | For gpx layers you can choose one of 7 default colors. (Other colors are available via [Help/Action/LayerCustomizeColor Customize Color] in the gpx layer [wiki:Help/Menu/GPXLayer context menu]). |
| 83 | | |
| 84 | | [[Image(gpx_colors.png)]] |
| | 73 | For gpx layers you can choose one of 7 default colors. (Other colors are available via [wikitr:/Help/Action/LayerCustomizeColor Customize Color] in the gpx layer [wikitr:/Help/Menu/GPXLayer context menu]). |
| 88 | | === Delete Layer === #DeleteLayer |
| 89 | | [[Image(source:trunk/images/dialogs/delete.png,link=)]] **Delete** permanently deletes the selected layers. **All unsaved changes will be discarded! ** |
| 90 | | If you try to delete an OSM data layer or Notes layer which contains changes, JOSM will open the [wiki:Help/Dialog/UnsavedChangesDialog Unsaved Changes window], asking to upload and/or save these changes. |
| | 77 | ===== Keyboard Shortcuts ===== #KeyboardShortcuts |
| | 78 | Following hotkeys are used to control visibility of layers counted from top or bottom: |
| | 79 | * **`Shift+S`** followed by **`[1–0A-Z]`** - where `1` is the **''top**'' layer; counting down to `9`, then `0` which toggles 10, then `A-Z`, `S` has a special meaning as it repeats the last toggled layer. Press **`Shift+S`** only and wait a second. JOSM will display a list with all layers and their shortcuts in this format. |
| | 80 | * **`Alt+[1–0]`** - where `1` is the **''bottom''** layer; counting up to `9` and then `0` which toggles layer 10. (Use only the numbers above the letters on your keyboard, not the numbers in the numeric keypad.) The layer numbers in this format are displayed by default in the layer list. |
| 92 | | === Individual Buttons === |
| 93 | | There might be more buttons depending on the loaded [wiki:/Plugins plugins], e.g. [[Image(osm:source:/applications/editors/josm/plugins/rasterfilters/images/josm_filters_48.png,16,link=)]] [osmwiki:JOSM/Plugins/RasterFilters RasterFilters plugin]. |
| | 82 | |
| | 83 | ==== Delete Layer ==== #DeleteLayer |
| | 84 | [[JOSMImage(dialogs/delete,24,middle,margin-right=10,link=)]] **Delete** permanently deletes the marked layers. **All unsaved changes will be discarded! ** |
| | 85 | If you try to delete an OSM data layer or Notes layer which contains changes, JOSM will open the [wikitr:/Help/Dialog/UnsavedChangesDialog Unsaved Changes dialog], asking to upload and/or save these changes. |
| | 86 | |
| | 87 | ==== Individual Buttons ==== |
| | 88 | There might be more buttons depending on the loaded [wikitr:/Plugins plugins], e.g. [[Image(source:osm/applications/editors/josm/plugins/rasterfilters/images/josm_filters_48.png,24,middle,link=)]] [osmwiki:JOSM/Plugins/RasterFilters RasterFilters plugin]. |
