[[TranslatedPages]]
[[PageOutline(2-4,Table of Contents)]]
= Layers window =

[[Image(source:trunk/images/dialogs/layerlist.png)]] ''Shortcut'': **{{{Shift+Alt+L}}}**

The Layers panel lists all loaded layers, controls their visibility and allows to activate one layer for editing map content.

=== Layer types ===

 * [[Image(source:trunk/images/layer/osmdata_small.png,link=wikitr:/Help/Menu/OSMLayer)]] [wikitr:/Help/Menu/OSMLayer Data layer] -
   Holds [wikitr:/Help/Concepts/Object map objects] as data set. A [[Image(source:trunk/images/clock.png,15,link=)]] clock indicates an running upload.
   Editing, downloading and uploading data may be restricted by the [wikitr:/Help/Menu/OSMLayer#Layerstate layer state]. 
 * [[Image(source:trunk/images/layer/gpx_small.png,link=wikitr:/Help/Menu/GPXLayer)]] [wikitr:/Help/Menu/GPXLayer GPX layer] - 
   Holds GPS track data.
   Each GPX layer can have own properties like color, line style, etc.
 * [[Image(source:trunk/images/layer/marker_small.png,link=wikitr:/Help/Menu/Marker )]] [wikitr:/Help/Menu/Marker Marker Layer] - 
   Holds identified points on a GPX track, called ''Markers''.   
 * [[Image(source:trunk/images/dialogs/geoimage.svg,16,link=)]] [wikitr:/Help/Menu/PhotoLayer Geoimage layer] - 
   Holds images which were [wikitr:/Help/Action/Open opened], dragged on the [wikitr:/Help/MapView Mapview] or imported via a GPX layer.
 * [[Image(source:trunk/images/imagery_small.png,link=)]] [wikitr:/Help/Menu/ImageryContextMenu Imagery Layer] - 
   Holds a background retrieved from a tile server like Bing Aerial or other [wikitr:/Help/Menu/Imagery imagery].
 * [[Image(source:trunk/images/layer/validator_small.png,link=)]] [wikitr:/Help/Menu/Validator Validator layer] - 
   Highlights errors or [wikitr:/Help/Dialog/Validator warnings] for objects on the active data layer. 
 * [[Image(source:trunk/images/dialogs/notes/note_open.png,15,link=)]] [wikitr:/Help/Menu/Notes Notes layer] -
   Holds [wikitr:/Help/Dialog/Notes Notes] from [osmwiki:Notes OSM].

Layers of one type can exist multiple times in a JOSM session, except the validator and the notes layer. [wikitr:/Plugins Plugins] (e.g. [osmwiki:JOSM/Plugins/Mapillary Mapillary]) can add other layer types.

[[Image(LayerList.png)]]

=== Layer Buttons ===

Each layer has some buttons or clickable areas in its row in the layer list:

|| [[Image(source:trunk/images/dialogs/layerlist/active.png,link=)]] ||  \
||    Activate this layer ||
||[[Image(source:trunk/images/dialogs/layerlist/scale.svg,16,link=)]] ||  \
||    Snap/unsnap the map zoom to the native resolution of this background imagery ||
|| [[Image(source:trunk/images/dialogs/layerlist/eye.png,link=)]] ||  \
||    Hide/unhide the layer ||


=== Panel Buttons ===
The Layers window has five buttons at its bottom which operate on the marked layers:

==== Move Up ==== #LayerUp
[[Image(source:trunk/images/dialogs/up.svg,24,link=)]] **Up** moves the selected layers up one row in the layer stack.
 This is important when items in one layer obscure those in layers below. You can reorder layers also by drag and drop.

==== Move Down ==== #LayerDown
[[Image(source:trunk/images/dialogs/down.svg,24,link=)]] **Down** moves the marked layers down one row in the layer stack.

==== Activate Layer ==== #ActivateLayer
[[Image(source:trunk/images/dialogs/activate.svg,link=)]] **Activate** activates the marked layer.
 It is only possible to edit map data in an active Data layer.  
 Each of the ten topmost layers can be activated with an individual keyboard shortcut sequence: **`Shift+A`⤳`[0–9]`** - counting from the top

==== Visibility ==== #VisibilityLayer
[[Image(source:trunk/images/dialogs/layerlist/visibility.png,link=)]]
Following hotkeys used to control visibility of top10 or bottom10 layers:
* **`Shift+S`⤳`[0–9]`** - where 0 is the top layer; counting down to 9 
* **`Alt+[1–0]`** - where 1 is the bottom layer; counting up to 0 

Once clicked on, it offers:
* 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 the following shortcuts to show/hide a layer:
* A slider to adjust the [[Image(source:trunk/images/dialogs/layerlist/transparency.png,16,link=)]] **Opacity** of marked layers.
* A slider to adjust the [[Image(source:trunk/images/dialogs/layerlist/colorfulness.png,16,link=)]] **Colorfulness** of marked layers.
* A slider to adjust the [[Image(source:trunk/images/dialogs/layerlist/gamma.png,16,link=)]] **Gamma** of marked layers.
* A slider to adjust the [[Image(source:trunk/images/dialogs/layerlist/sharpness.png,16,link=)]] **Sharpness** of marked layers.
Colorfulness, Gamma and Sharpness are only availible for imagery layers.

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]).

[[Image(gpx_colors.png)]]

Note: For ease of use you can use mouse scrolling to move a slider while the pointer is placed at the slider – no need to click-drag-release the slider picker.

==== Delete Layer ==== #DeleteLayer
[[Image(source:trunk/images/dialogs/delete.svg,24,link=)]] **Delete** permanently deletes the marked layers. **All unsaved changes will be discarded! **
 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 window], asking to upload and/or save these changes.

==== Individual Buttons ====
There might be more buttons depending on the loaded [wikitr:/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].

----
Back to [wikitr:/Help/ToggleDialogs Windows menu]\\
Back to [wikitr:/Help/Menu Main menu]\\
Back to [wikitr:/Help Main Help]