Changes between Version 82 and Version 114 of Help/Dialog/LayerList


Ignore:
Timestamp:
(multiple changes)
Author:
(multiple changes)
Comment:
(multiple changes)

Legend:

Unmodified
Added
Removed
Modified
  • Help/Dialog/LayerList

    v82 v114  
    1 [[TranslatedPages(outdated=WIP to reflect the changes from #8039 (and #10456).)]]
     1[[TranslatedPages]]
    22[[PageOutline(2-10,Table of Contents)]]
    3 = Layers window =
     3= Layers List panel =
    44
    5 [[Image(source:trunk/images/dialogs/layerlist.png)]] ''Keyboard shortcut'': **{{{Shift+Alt+L}}}** — one of the [Help/ToggleDialogs#Toactivateawindow JOSM windows]
     5[[JOSMImage(dialogs/layerlist,link=,48,middle,margin-right=20)]] ''Keyboard shortcut'': **`Shift+Alt+L`** - one of the [wikitr:/Help/ToggleDialogs#Toactivateawindow JOSM panels]
    66
    7 The Layers panel lists the **loaded layers**, controls their visibility and activates them for editing content.
     7The Layers panel lists all loaded layers, controls their visibility and allows to activate one layer for editing map content.
    88
    9 === Layer types ===
    10 
    11 JOSM has several types of layers.
    12 
    13  * [[Image(source:trunk/images/layer/osmdata_small.png,link=wikitr:/Help/Menu/OSMLayer)]] [wikitr:/Help/Menu/OSMLayer Data layer] -
    14    Holds a set of map data [wikitr:/Help/Concepts/Object objects].
    15    These can be edited, up- and downloaded unless the [wikitr:/Help/Menu/OSMLayer#Layerstate layer state] is [[Image(source:trunk/images/warning-small.png,8,link=[wiki:Help/Action/EncourageDiscourageUpload])]] changed or [[Image(lock-16px.svg,13px,link=)]] locked.
    16    A [[Image(source:trunk/images/clock.png,15,link=)]] clock indicates an running upload.
    17  * [[Image(source:trunk/images/layer/gpx_small.png,link=wikitr:/Help/Menu/GPXLayer)]] [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] -
    1815   Holds GPS track data.
    1916   Each GPX layer can have own properties like color, line style, etc.
    20  * [[Image(source:trunk/images/layer/marker_small.png,link=wikitr:/Help/Menu/Marker )]] [wikitr:/Help/Menu/Marker Marker Layer] -
    21    Holds identified points on a GPX track, called ''Markers''.
    22    They are created in four varieties:
    23    [wikitr:/Help/Action/MarkersFromNamedPoints Named], [wikitr:/Help/Action/ImportAudio Audio], [wikitr:/Help/Action/ImportImages Image] and Web.
    24  * [[Image(source:trunk/images/dialogs/geoimage.svg,16,link=)]] [wiki:Help/Menu/PhotoLayer Geoimage 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] -
    2520   Holds images which were [wikitr:/Help/Action/Open opened], dragged on the [wikitr:/Help/MapView Mapview] or imported via a GPX layer.
    26  * [[Image(source:trunk/images/imagery_small.png,link=)]] [wikitr:/Help/Menu/ImageryContextMenu Imagery 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] -
    2723   Holds a background retrieved from a tile server like Bing Aerial or other [wikitr:/Help/Menu/Imagery imagery].
    28  * [[Image(source:trunk/images/layer/validator_small.png,link=)]] [wiki:Help/Menu/Validator Validator layer] -
    29    Highlights errors or [wiki:Help/Dialog/Validator warnings] for objects on the active data layer.
    30  * [[Image(source:trunk/images/dialogs/notes/note_open.png,15,link=)]] [wikitr:/Help/Menu/Notes Notes layer] -
    31    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].
    3228
    33 Layers of one type can exist multiple times in a JOSM session, except the validator and the notes layer.
    34 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].
     29Layers 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.
    3530
    36 [[Image(LayerList.png)]]
     31== Layer Buttons ==#LayerButtons
     32[[Image(LayerList.png,right,margin-left=10)]]
     33Each layer has some buttons or clickable areas in its row in the layer list:
    3734
    38 == 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 ||
    3944
    40 || [[Image(source:trunk/images/dialogs/layerlist/active.png,link=)]] ||  \
    41 ||    Make this layer the active layer ||
    42 ||[[Image(source:trunk/images/dialogs/layerlist/scale.svg,16,link=)]] ||  \
    43 ||    Snap/unsnap the map zoom to the native resolution of this background imagery ||
    44 || [[Image(source:trunk/images/dialogs/layerlist/eye.png,link=)]] ||  \
    45 ||    Hide/unhide the layer ||
     45=== Panel Buttons ===#PanelButtons
     46{{{#!comment
     47#PanelButtons target is called from Help/MapView
     48}}}
     49The Layers List has five buttons at its bottom which operate on the marked layers:
    4650
    47 
    48 == Panel Buttons ==
    49 The Layers window also has several buttons at the bottom which operate on the selected layers:
    50 
    51 === Move Up === #LayerUp
    52 [[Image(source:trunk/images/dialogs/up.svg,24,link=)]] **Up** moves the selected layers up one row in the layer stack.
     51==== Move Up ==== #LayerUp
     52[[JOSMImage(dialogs/up,24,bottom,margin-right=10,link=)]] **Up** moves the selected layers up one row in the layer stack.
    5353 This is important when items in one layer obscure those in layers below. You can reorder layers also by drag and drop.
    5454
    55 === Move Down === #LayerDown
    56 [[Image(source:trunk/images/dialogs/down.svg,24,link=)]] **Down** moves the selected layers down one row in the layer stack.
     55==== Move Down ==== #LayerDown
     56[[JOSMImage(dialogs/down,24,bottom,margin-right=10,link=)]] **Down** moves the marked layers down one row in the layer stack.
    5757
    58 === Activate Layer === #ActivateLayer
    59 [[Image(source:trunk/images/dialogs/activate.svg,link=)]] 
    60 ''Keyboard shortcut'': **`Shift+A`⤳`[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.
    6162
    62 **Activate** activates the selected layer.
    63  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.
    6472
    65 === Visibility === #VisibilityLayer
    66 [[Image(source:trunk/images/dialogs/layerlist/visibility.png,link=)]]
    67 Following hotkeys used to control visibility of top10 or bottom10 layers:
    68 * **`Shift+S`⤳`[0–9]`** - where 0 is the top layer; counting down to 9
    69 * **`Alt+[1–0]`** - where 1 is the bottom layer; counting up to 0
    70 
    71 Once clicked on, it offers:
    72 * 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:
    73 * A slider to adjust the [[Image(source:trunk/images/dialogs/layerlist/transparency.png,16,link=)]] **Opacity** of selected layers.
    74 * A slider to adjust the [[Image(source:trunk/images/dialogs/layerlist/colorfulness.png,16,link=)]] **Colorfulness** of selected layers.
    75 * A slider to adjust the [[Image(source:trunk/images/dialogs/layerlist/gamma.png,16,link=)]] **Gamma** of selected layers.
    76 * A slider to adjust the [[Image(source:trunk/images/dialogs/layerlist/sharpness.png,16,link=)]] **Sharpness** of selected layers.
    77 Colorfulness, Gamma and Sharpness are only availible for imagery layers.
    78 
    79 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]).
    80 
    81 [[Image(gpx_colors.png)]]
     73For 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]).
    8274
    8375Note: 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.
    8476
    85 === Delete Layer === #DeleteLayer
    86 [[Image(source:trunk/images/dialogs/delete.svg,24,link=)]] **Delete** permanently deletes the selected layers. **All unsaved changes will be discarded! **
    87  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
     78Following 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.
    8881
    89 === Individual Buttons ===
    90 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 ====
     88There 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].
    9189
    9290----
    93 Back to [wikitr:/Help/ToggleDialogs Windows]\\
     91Back to [wikitr:/Help/Menu/Windows Windows menu] \\
     92Back to [wikitr:/Help/ToggleDialogs Sidebar] \\
     93Back to [wikitr:/Help/Menu Main menu] \\
    9494Back to [wikitr:/Help Main Help]