| 7 | | **List of currently loaded layers.** |
| | 7 | The Layers panel lists the **loaded layers**, controls their visibility and activates them for editing content. |
| | 8 | |
| | 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] - |
| | 20 | Holds GPS track data. |
| | 21 | Each GPX layer can have own properties like color, line style, etc. |
| | 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] - |
| | 29 | Holds a background retrieved from a tile server like Bing Aerial or other [wikitr:/Help/Menu/Imagery imagery]. |
| | 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]. |
| | 34 | |
| | 35 | Most layer types can have several instances in a JOSM session, but the validator and notes layers can exist only once. |
| | 36 | More layer types come with additional [wikitr:/Plugins plugins], e.g. [[Image(https://raw.githubusercontent.com/mapillary/josm-mapillary-plugin/master/images/icon16.png)]] [osmwiki:JOSM/Plugins/Mapillary Mapillary plugin]. |
| 11 | | == Layer types == |
| 12 | | |
| 13 | | There are different types of layers. Each has a Context Menu accessed from the right mouse button which provides operations on the layer. |
| 14 | | |
| 15 | | * [[Image(source:trunk/images/layer/osmdata_small.png)]] **OSM Data** Layer [wiki:Help/Menu/OSMLayer (context menu)]: holds the OpenStreetMap data (nodes, ways, relations). \\ During the upload process the icon changes to [[Image(source:trunk/images/clock.png,15)]]. \\ ''For experts:'' Several attributes of an OSM data layer can be set: [wiki:Help/Action/EncourageDiscourageUpload upload], [wiki:Help/Action/BlockDownload download], [wiki:Help/Action/LockedLayer locked]. Layers in non-default state are indicated by a modified icon. This leads to those example layer states: |
| 16 | | * normal layers: download allowed, upload allowed, modifications allowed |
| 17 | | * layers needing work: download allowed, upload discouraged (set upload='false'), modifications allowed. These layers should usually not be uploaded. E.g. conversions of gpx tracks to data layers. |
| 18 | | * test layers: download allowed, upload blocked (set upload='never'), modifications allowed |
| 19 | | * private layers: download blocked (set download='never'), upload blocked (set upload='never'), modifications allowed |
| 20 | | * locked layers: nothing allowed, the data cannot be modified in any way (set locked='true'). |
| 21 | | * [[Image(source:trunk/images/layer/gpx_small.png)]] **GPX** Layer [wiki:Help/Menu/GPXLayer (context menu)]: holds the GPS data loaded from your local hard disk (by using the open dialog to load GPX files) or from openstreetmap. The context menu (right mouse click on layer in layer list) allows to set special properties for different gps layers (different colors, line style, etc.). |
| 22 | | * [[Image(source:trunk/images/layer/marker_small.png)]] **Marker** Layer [wiki:Help/Menu/Marker (context menu)]: Markers are specially identified points on the track. They come in four varieties: simple named markers, audio markers, image markers and web markers. They are created as a side effect of opening a GPX file, containing waypoints from that file, or from a set of waypoints artificially constructed using the context menu entry Make Sampled Audio Layer on the GPX layer, which produces only audio markers. |
| 23 | | * [[Image(source:trunk/images/dialogs/geoimage.svg,16)]] **Photo** Layer [wiki:Help/Menu/PhotoLayer (context menu)]: the context menu (right mouse) of a GPS layer provides the menu to import images. Using this feature allows to match digital images with the gps coordinates to ease the naming of streets (for example). |
| 24 | | * [[Image(source:trunk/images/imagery_small.png)]] **Imagery** Layer [wiki:Help/Menu/ImageryContextMenu (context menu)]: backgrounds retrieved from a WMS, TMS or WMTS server. Examples are Landsat satellite imagery, Bing Aerial, NPE out-of-copyright Ordnance Survey maps and OpenStreetMap map tiles. See also [wiki:Help/Menu/Imagery Imagery]. |
| 25 | | * [[Image(source:trunk/images/layer/validator_small.png)]] **Validator** Layer [wiki:Help/Menu/Validator (context menu)]: highlights objects with errors or warnings from the [wiki:Help/Dialog/Validator Validator]. |
| 26 | | * [[Image(source:trunk/images/dialogs/notes/note_open.png,15)]] **Notes** Layer [wiki:Help/Menu/Notes (context menu)]: displays the position of downloaded [wiki:Help/Dialog/Notes Notes] in the Map view. |
| 27 | | |
| 28 | | There might be more layer types depending on the loaded [wiki:/Plugins plugins], e.g. [[Image(https://raw.githubusercontent.com/mapillary/josm-mapillary-plugin/master/images/icon16.png)]] [osmwiki:JOSM/Plugins/Mapillary Mapillary plugin]. |
| 29 | | |
| 32 | | * [[Image(source:trunk/images/dialogs/layerlist/active.png)]] click to make the layer the active layer |
| 33 | | * [[Image(source:trunk/images/dialogs/layerlist/scale.svg,16)]] click to snap/unsnap the zoom to native resolutions of this background imagery layer |
| 34 | | * [[Image(source:trunk/images/dialogs/layerlist/eye.png)]] click to 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 || |
| 63 | | * A slider to adjust the [[Image(source:trunk/images/dialogs/layerlist/transparency.png,16 |
| 64 | | * A slider to adjust the [[Image(source:trunk/images/dialogs/layerlist/colorfulness.png,16 |
| 65 | | * A slider to adjust the [[Image(source:trunk/images/dialogs/layerlist/gamma.png,16 |
| 66 | | * A slider to adjust the [[Image(source:trunk/images/dialogs/layerlist/sharpness.png,16 |
| | 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. |
