WIP to reflect the changes from #8039 (and #10456).

Layers window

source:trunk/images/dialogs/layerlist.png Keyboard shortcut: Shift+Alt+L — one of the JOSM windows

The Layers panel lists the loaded layers, controls their visibility and activates them for editing content.

Layer types

JOSM has several types of layers.

Layers of one type can exist multiple times in a JOSM session, except the validator and the notes layer. More layer types come with additional plugins, e.g. Mapillary plugin.

Layer Buttons

source:trunk/images/dialogs/layerlist/active.png Make this layer the active layer
source:trunk/images/dialogs/layerlist/scale.svg Snap/unsnap the map zoom to the native resolution of this background imagery
source:trunk/images/dialogs/layerlist/eye.png Hide/unhide the layer

Panel Buttons

The Layers window also has several buttons at the bottom which operate on the selected layers:

Move Up

source:trunk/images/dialogs/up.svg 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

source:trunk/images/dialogs/down.svg Down moves the selected layers down one row in the layer stack.

Activate Layer

source:trunk/images/dialogs/activate.svg Keyboard shortcut: Shift+A[0–9] - counting from the top

Activate activates the selected layer.

It is only possible to edit in an active Data layer.


source:trunk/images/dialogs/layerlist/visibility.png 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 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:
  • A slider to adjust the source:trunk/images/dialogs/layerlist/transparency.png Opacity of selected layers.
  • A slider to adjust the source:trunk/images/dialogs/layerlist/colorfulness.png Colorfulness of selected layers.
  • A slider to adjust the source:trunk/images/dialogs/layerlist/gamma.png Gamma of selected layers.
  • A slider to adjust the source:trunk/images/dialogs/layerlist/sharpness.png Sharpness of selected 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 Customize Color in the gpx layer context menu).

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

source:trunk/images/dialogs/delete.svg Delete permanently deletes the selected 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 Unsaved Changes window, asking to upload and/or save these changes.

Individual Buttons

There might be more buttons depending on the loaded plugins, e.g. source:/applications/editors/josm/plugins/rasterfilters/images/josm_filters_48.png in OpenStreetMap Trac RasterFilters plugin.

Back to Windows
Back to Main Help

Last modified 6 months ago Last modified on 2018-08-26T18:37:56+02:00

Attachments (3)

Download all attachments as: .zip