Changes between Version 29 and Version 30 of Help/Preferences/Imagery


Ignore:
Timestamp:
2019-08-31T21:44:29+02:00 (2 weeks ago)
Author:
Klumbumbus
Comment:

complete rework

Legend:

Unmodified
Added
Removed
Modified
  • Help/Preferences/Imagery

    v29 v30  
    1 [[TranslatedPages(outdated=This page is incomplete and heavily outdated. The "settings" and "offset bookmark" tabs are not explained. The screenshots are outdated. WMTS is missing. Changes from #16249 and #16301 are missing.)]]
     1[[TranslatedPages]]
    22= Preferences > Imagery =
    33
    4 [[Image(source:trunk/images/preferences/imagery.png)]] **Adding or deleting predefined/custom WMS/TMS/WMTS imagery sources,** general imagery settings and offset bookmarks.
     4[[Image(source:trunk/images/preferences/imagery.png)]] **Adding or deleting predefined/custom WMS/TMS/WMTS imagery sources,** general imagery settings, offset bookmarks and imagery cache settings.
    55
    6 To display an imagery in the MapView use the main menu [Help/Menu/Imagery Imagery].
     6To display an imagery ("background") in the [wikitr:/Help/MapView Mapview] use the [wikitr:/Help/Menu/Imagery Imagery menu] instead.
    77
    88[[PageOutline]]
    99
    1010== Imagery providers ==
    11 This is the place to modify the list of imagery providers that is presented in the imagery menu and from which you can activate the imagery layers.
     11Here you can modify the list of imageries which appear in the [wikitr:/Help/Menu/Imagery Imagery menu] as well as edit entries.
    1212
    13 === Activate more items in Imagery menu ===
     13[[Image(predefined-imagery.png)]]
    1414
    15 [[Image(predefined-imagery.png,400px)]]
    16 1. Select one or more imagery provider of interest in the **Available default entries** table on the left
    17 1. Optional: verify bounds on the map on the right
    18 1. Click **Activate** (Activated default entries are highlighted green in both lists.)
    19 1. Click **OK** to close the preferences dialog
     15The top left list contains all available sources. If you select a source and if it is not provided global its bounds are displayed on the little map on the top right. You can filter this list by typing in the box above. You can use parts of the source name, the country code (e.g. cz), the country name (e.g. czech republic, use the country name in the language JOSM is set to), the source type (photo, historicphoto, map, historicmap, osmbasedmap or other) or the URL.
    2016
    21 === Custom imagery URL ===
     17The bottom list contains all entries which will appear in the [wikitr:/Help/Menu/Imagery Imagery menu]. To copy an entry from the top list to the bottom list select it in the top list and click on the [[Image(source:trunk/images/preferences/activate-down.png,20,middle)]] **Activate** button. Activated default entries are highlighted green in both lists. (The green color doesn't say anything about the state/health of the servers they mention, nor the validity of the URLs.)
    2218
    23 ==== Add custom WMS imagery ====
    24 1. Click [[Image(source:trunk/images/dialogs/add.png,18)]] just to the right of the **Selected entries** table on the bottom half of this tab
    25 [[Image(wms.png,400px)]]
    26 1. Insert **Menu Name**
    27 1. Paste **Service URL** (Mac users: paste is ctrl-v in josm)
    28 1. Click **Get Layers**
    29 1. Select one or more layers
    30 1. Click **OK** to close the window
    31 1. Click **OK** to close the preferences dialog
     19To update (reload from JOSM server) the list of default entries on the top click on the [[Image(source:trunk/images/dialogs/refresh.png,20,middle)]] button on the right.
    3220
     21To add an custom WMS/TMS/WMTS source click on the respective button on the right: [[Image(source:trunk/images/dialogs/add_wms.png,20,middle)]], [[Image(source:trunk/images/dialogs/add_tms.png,20,middle)]] or [[Image(source:trunk/images/dialogs/add_wmts.png,20,middle)]] and follow the instructions.
    3322
    34 ==== Troubleshooting ====
    35 If the WMS layer list cannot be loaded, a warning dialog is shown:
     23To delete an entry in the bottom list select it and click on the [[Image(source:trunk/images/dialogs/delete.svg,20,middle)]] button.
    3624
    37 [[Image(wms-error.png)]]
     25To add an entry to the top list of default entries read the [wiki:/Maps#Documentation Documentation] and edit [wiki:/Maps] or its subpages (for advanced users).
    3826
    39 To trace the problem, copy the URL from most recent line from the console (e.g., `GET http://vogis.cnv.at/mapserver/mapserv?...`) and open it in your browser.
     27== Settings ==
     28Here you can edit some general imagery settings.
    4029
     30== Offset bookmarks ==
     31Here are listed all offset bookmarks which can easily be added via "New offset" in the [wikitr:/Help/Menu/Imagery Imagery menu].
    4132
    42 ==== Add custom TMS imagery ====
    43 [[Image(tms.png,400px)]]
    44 1. Click [[Image(source:trunk/images/dialogs/add.png,18)]] just to the right of the **Selected entries** table on the bottom half of this tab
    45 1. Click **TMS**!
    46 1. Insert **Menu Name**
    47 1. Paste **TMS URL**, replace `x`, `y`, `zoom` parameter in the URL by `{x}`, `{y}`, `{zoom}`, respectively. Use for instance `{switch:a,b,c}` or `{switch:1,2,3,4}` for a random selection of the subdomain. Example: `http://{switch:a,b,c}.www.toolserver.org/tiles/bw-mapnik/{zoom}/{x}/{y}.png`. See [[Maps#TileMapServicesTMS]] for more options.
    48 1. Optional: insert the zoom range in **Zoom**
    49 1. Click **OK** to close the preferences dialog
     33== Cache ==
     34Here are listed all cached images (tiles) from each source. You can use the "clear" button in each line to delete the cached images for each source. You may need a JOSM restart to take effect in the Mapview.
    5035
     36A possibly existing "Mapnik" entry [[ticket:17054|stems from]] using the slippy map shown by the JOSM [wikitr:/Help/Action/Download#Slippymap download dialog] in older JOSM versions. You can safely delete it.
    5137
    52 === Delete entry from imagery list ===
    53 1. Select one or more entries in the **Selected entries** table on the bottom half of this tab
    54 1. Click [[Image(source:trunk/images/dialogs/delete.svg,18)]] to delete selected entries
    55 1. Click **OK** to close the preferences dialog
    56 
    57 === Advanced: Add entry to list of predefined imagery ===
    58 Read the [[Maps#Documentation|Documentation]] and edit [[Maps]].
    59 
    60 === Notes ===
    61 ==== Meaning of green and white rows ====
    62 In upper table:
    63   Green means item is also listed in lower table. (This is called "activated".)
    64 
    65 In lower table:
    66   Green means item is also listed in upper table.
    67 
    68 In both tables if an item is white, it will only be found in one table,
    69 not both.
    70 
    71 Neither green nor white lines have any relation to the state / health of the
    72 servers they mention, nor the validity of the URLs they contain.
    73 
    74 == Cache contents ==
    7538[[Image(scr_imagery_prefs_cache.png,400px)]]
    7639
    77 You can use the "clear" button in each line to delete the cached images for each source. May need a JOSM restart to take effect in the view.
    78 
    79 A possibly existing "Mapnik" line [[ticket:17054|stems from]] using the [[Help/Action/Download#Slippymap|slippy map shown by the JOSM download dialogue]] in a JOSM version before version 14495 (Dec. 2018). You can safely delete it.
     40----
     41Back to [wikitr:/Help Main Help]