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


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

Legend:

Unmodified
Added
Removed
Modified

  • Help/Preferences/Imagery

    v29 v49  
    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(outdated=This page is incomplete. The individual dialogs for adding customized sources are not explained.)]]
     2[[PageOutline(2-4,Table of Content)]]
     3
    24= Preferences > Imagery =
    35
    4 [[Image(source:trunk/images/preferences/imagery.png)]] **Adding or deleting predefined/custom WMS/TMS/WMTS imagery sources,** general imagery settings and offset bookmarks.
     6[[JOSMImage(preferences/imagery,48,middle,link=,margin-right=20)]] **Modify list of imagery layers displayed in the Imagery menu**
    57
    6 To display an imagery in the MapView use the main menu [Help/Menu/Imagery Imagery].
     8Four tabs are available for adding, deleting and modifying [#Imageryproviders imagery sources], general [#Settings imagery settings], [#OffsetBooksmarks offset bookmarks] and [#Cache imagery cache settings].
    79
    8 [[PageOutline]]
    9 
    10 == 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.
    12 
    13 === Activate more items in Imagery menu ===
    14 
    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
    20 
    21 === Custom imagery URL ===
    22 
    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
     10**Note**: To display an imagery (''background'') in the [wikitr:/Help/MapView Mapview] use the [wikitr:/Help/Menu/Imagery Imagery menu] instead.
    3211
    3312
    34 ==== Troubleshooting ====
    35 If the WMS layer list cannot be loaded, a warning dialog is shown:
     13== Imagery providers ==#Imageryproviders
     14Here you can modify the list of imageries which appear in the [wikitr:/Help/Menu/Imagery Imagery menu]. A lot of predefined sources are available, additionally modifiying existing and defining customized entries is possible. JOSM supports WMS, TMS, WTMS and MVT servers.
    3615
    37 [[Image(wms-error.png)]]
     16=== Available default entries ===#DefaultEntries
     17The 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 category (photo, elevation, historicphoto, map, historicmap, osmbasedmap, quality assurance or other) or the URL.
    3818
    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.
     19* To update (reload from JOSM server) the list of default entries click on the [[JOSMImage(dialogs/refresh)]] button between the two lists.
     20* To copy an entry from the top list to the bottom list select it in the top list and click on the [[JOSMImage(preferences/activate-down)]] ''**Activate**'' button between the two lists.
    4021
     22**Note:** To add an entry to the top list of default entries read the [wiki:/Maps#Documentation Documentation] and edit [wiki:/Maps#Listofsources Maps] or its subpages (for advanced users).
    4123
    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
     24=== Selected entries ===#SelectedEntries
     25[[Image(PreferencesImageryProviders.png​,45%,link=,right,margin-left=10)]]
     26The bottom list contains all entries which will appear in the [wikitr:/Help/Menu/Imagery Imagery menu]. 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.)
    5027
     28* To add an custom WMS/TMS/WMTS/MVT source click on the respective button on the right, [[JOSMImage(dialogs/add_wms)]], [[JOSMImage(dialogs/add_tms)]], [[JOSMImage(dialogs/add_wmts)]] or [[JOSMImage(dialogs/add_mvt)]] and follow the instructions.
     29* To delete an entry in the bottom list select it and click on the [[JOSMImage(dialogs/delete)]] button.
     30* To modify an entry, double click on the field in the table and modify its content.
     31 
     32 **Tip**: To manually add a new entry by hand, activate an entry from the list above and modify it to your needs.
    5133
    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
     34The list of ''selected entries'' is saved in advanced preference as value of key: `imagery.entries`
    5635
    57 === Advanced: Add entry to list of predefined imagery ===
    58 Read the [[Maps#Documentation|Documentation]] and edit [[Maps]].
     36== Settings ==#Settings
     37Here you can edit some general imagery settings. Some of these settings are also available, per imagery layer, by right click in map view with a visible imagery layer.
    5938
    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".)
     39=== Common Settings ===#CommonSettings
     40 Sharpen (requires layer re-add)::
     41  adds a sharpening post-process. Values are ''None'', ''Soft'' or ''Sharp''. As this changes the entry in the list, the imagery layer has to be re-added. \\
     42  ''Advance preference: `imagery.sharpen_level`
    6443
    65 In lower table:
    66   Green means item is also listed in upper table.
     44 Tiles zoom offset::
     45  offset between calculated zoom level and zoom level used to download and show tiles. Negative values (''underzoom'') will result in lower resolution of imagery useful with HiDPI displays, positive values (''overzoom'') will result in higher resolution, at the cost of increased memory consumption. \\
     46  ''Advance preference: `imagery.generic.zoom_offset`
    6747
    68 In both tables if an item is white, it will only be found in one table,
    69 not both.
     48=== WMS Settings ===#WmsSettings
     49 Auto zoom by default::
     50  whether the zoom levels of the WMS imagery layer should be adjusted when zooming in or out of the map. \\
     51  ''Advance preference: `imagery.wms.default_autozoom` (default: `true`)
    7052
    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.
     53 Simultaneous connections::
     54  Number of simultaneous connections. \\
     55  ''Advance preference: `imagery.wms.loader.maxjobs` (default: `3`)''
    7356
    74 == Cache contents ==
    75 [[Image(scr_imagery_prefs_cache.png,400px)]]
     57[[Image(PreferencesImagerySettings.png​,link=,45%,right,margin-left=10)]]
     58 Tile size::
     59  size of each tile. \\
     60  ''Advance preference: `imagery.wms.imageSize` (default: `512`)''
    7661
    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.
     62=== TMS Settings ===#TmsSettings
     63 Auto zoom by default::
     64  whether the zoom levels of the TMS imagery layer should be adjusted when zooming in or out of the map. \\
     65  ''Advance preference: `imagery.generic.default_autozoom` (default: `true`)''
    7866
    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.
     67 Autoload tiles by default::
     68  whether TMS tiles should be loaded automatically or only manually. \\
     69  ''Advance preference: `imagery.generic.default_autoload` (default: `true`)''
     70
     71 Min. zoom level::
     72  minimum zoom level for TMS layers. \\
     73  ''Advance preference: `imagery.tms.min_zoom_lvl` (default: `2`)''
     74
     75 Max. zoom level::
     76  maximum zoom level for TMS layers. \\
     77  ''Advance preference: `imagery.tms.max_zoom_lvl` (default: `20`)''
     78
     79 Add to slippymap chooser::
     80  whether TMS imageries should be available in download dialog. \\
     81  ''Advance preference: `imagery.tms.add_to_slippymap_chooser` (default: `true`)''
     82
     83 Maximum concurrent downloads::
     84  global maxmium number of parallel TMS imagery downloads. \\
     85  ''Advance preference: `imagery.tms.tmsloader.maxjobs` (default: `25`)''
     86
     87 Maximum concurrent downloads per host::
     88  maximum number of parallel TMS imagery downloads per host. \\
     89  ''Advance preference: `imagery.tms.tmsloader.maxjobsperhost` (default: `6`)''
     90
     91== Offset bookmarks ==#OffsetBooksmarks
     92Here are listed all offset bookmarks which can easily be added via [[JOSMImage(mapmode/adjustimg)]] [wikitr:/Help/Action/ImageryAdjust New offset] in the Imagery menu and the [[JOSMImage(dialogs/layerlist)]] [wikitr:/Help/Dialog/LayerList layers list] panel's [wikitr:/Help/Menu/ImageryContextMenu context menu]. \\
     93''Advance preference: `imagery.offsetbookmarks`''
     94
     95[[Image(PreferencesImageryOffsetBookmarks.png​​,link=,45%)]]
     96
     97== Cache ==#Cache
     98Here 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.
     99
     100**Note**: A possibly existing ''Mapnik'' entry stems from using the slippy map shown by the JOSM [wikitr:/Help/Action/Download#Slippymap download dialog] in older JOSM versions. Since r14495 (#17054), you can safely delete it.
     101
     102=== Cache settings ===#CacheSettings
     103 Tile cache directory::
     104   location of the imagery tile cache, see [wikitr:/Help/Preferences#JOSMpreferencedatacachedirectories default directories]. \\
     105  ''Advance preference: `imagery.generic.loader.cachedir`''
     106
     107 Maximum size of disk cache (per imagery) in MB::
     108  quota option per imagery. \\
     109  ''Advance preference: `imagery.cache.max_disk_size` (default: `512`)''
     110
     111[[Image(PreferencesImageryCache.png​,link=,45%)]]
     112
     113----
     114Back to [wikitr:/Help/Action/Preferences Preferences dialog] \\
     115Back to [wikitr:/Help/Menu/Edit Edit Menu] \\
     116Back to [wikitr:/Help/Menu Main Menu] \\
     117Back to [wikitr:/Help Main Help]