Changes between Version 39 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

    v39 v49  
    1 [[TranslatedPages]]
     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 [[JOSMImage(preferences/imagery)]] **Adding or deleting predefined/custom WMS/TMS/WMTS imagery sources,** general imagery settings, offset bookmarks and imagery cache settings.
     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 (''background'') in the [wikitr:/Help/MapView Mapview] use the [wikitr:/Help/Menu/Imagery Imagery menu] instead.
     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]]
     10**Note**: To display an imagery (''background'') in the [wikitr:/Help/MapView Mapview] use the [wikitr:/Help/Menu/Imagery Imagery menu] instead.
     11
    912
    1013== Imagery providers ==#Imageryproviders
    11 Here you can modify the list of imageries which appear in the [wikitr:/Help/Menu/Imagery Imagery menu] as well as edit entries.
     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.
    1215
    13 [[Image(predefined-imagery.png,90%,link=)]]
     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.
    1418
    15 The 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.
     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.
    1621
    17 The 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 [[JOSMImage(preferences/activate-down)]] **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.)
     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).
    1823
    19 To update (reload from JOSM server) the list of default entries on the top click on the [[JOSMImage(dialogs/refresh)]] button.
     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.)
    2027
    21 To add an custom WMS/TMS/WMTS source click on the respective button on the right: [[JOSMImage(dialogs/add_wms)]], [[JOSMImage(dialogs/add_tms)]] or [[JOSMImage(dialogs/add_wmts)]] and follow the instructions.
     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.
    2233
    23 To delete an entry in the bottom list select it and click on the [[JOSMImage(dialogs/delete)]] button.
    24 
    25 The bottom list is saved in advanced preference as value of key: `imagery.entries`
    26 
    27 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).
    28 
     34The list of ''selected entries'' is saved in advanced preference as value of key: `imagery.entries`
    2935
    3036== Settings ==#Settings
    31 Here you can edit some general imagery 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.
    3238
    3339=== Common Settings ===#CommonSettings
     
    3743
    3844 Tiles zoom offset::
    39   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 in "retina" (high-dpi) displays, positive values (overzoom) will result in higher resolution, at the cost of increased memory consumption. \\
     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. \\
    4046  ''Advance preference: `imagery.generic.zoom_offset`
    4147
     
    4955  ''Advance preference: `imagery.wms.loader.maxjobs` (default: `3`)''
    5056
     57[[Image(PreferencesImagerySettings.png​,link=,45%,right,margin-left=10)]]
    5158 Tile size::
    5259  size of each tile. \\
     
    8390
    8491== Offset bookmarks ==#OffsetBooksmarks
    85 Here are listed all offset bookmarks which can easily be added via "New offset" in the [wikitr:/Help/Menu/Imagery Imagery menu]. \\
     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]. \\
    8693''Advance preference: `imagery.offsetbookmarks`''
    8794
     95[[Image(PreferencesImageryOffsetBookmarks.png​​,link=,45%)]]
     96
    8897== Cache ==#Cache
    89 Here 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.
     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.
    9099
    91 A possibly existing "Mapnik" entry [#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.
     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.
    92101
     102=== Cache settings ===#CacheSettings
    93103 Tile cache directory::
    94104   location of the imagery tile cache, see [wikitr:/Help/Preferences#JOSMpreferencedatacachedirectories default directories]. \\
     
    99109  ''Advance preference: `imagery.cache.max_disk_size` (default: `512`)''
    100110
    101 [[Image(scr_imagery_prefs_cache.png,link=,400px)]]
     111[[Image(PreferencesImageryCache.png​,link=,45%)]]
    102112
    103113----
    104 Back to [wikitr:/Help/Action/Preferences Preferences] \\
     114Back to [wikitr:/Help/Action/Preferences Preferences dialog] \\
     115Back to [wikitr:/Help/Menu/Edit Edit Menu] \\
     116Back to [wikitr:/Help/Menu Main Menu] \\
    105117Back to [wikitr:/Help Main Help]