Changes between Version 36 and Version 37 of Help/Preferences/Imagery


Ignore:
Timestamp:
2021-02-23T19:54:10+01:00 (7 days ago)
Author:
skyper
Comment:

add options; little bigger icons

Legend:

Unmodified
Added
Removed
Modified
  • Help/Preferences/Imagery

    v36 v37  
    44[[JOSMImage(preferences/imagery)]] **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 ("background") in the [wikitr:/Help/MapView Mapview] use the [wikitr:/Help/Menu/Imagery Imagery menu] instead.
     6To display an imagery (''background'') in the [wikitr:/Help/MapView Mapview] use the [wikitr:/Help/Menu/Imagery Imagery menu] instead.
    77
    88[[PageOutline]]
     
    1111Here you can modify the list of imageries which appear in the [wikitr:/Help/Menu/Imagery Imagery menu] as well as edit entries.
    1212
    13 [[Image(predefined-imagery.png)]]
     13[[Image(predefined-imagery.png,link=)]]
    1414
    1515The 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.
    1616
    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,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.)
     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 [[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.)
    1818
    19 To update (reload from JOSM server) the list of default entries on the top click on the [[JOSMImage(dialogs/refresh,20,middle)]] button.
     19To update (reload from JOSM server) the list of default entries on the top click on the [[JOSMImage(dialogs/refresh)]] button.
    2020
    21 To add an custom WMS/TMS/WMTS source click on the respective button on the right: [[JOSMImage(dialogs/add_wms,20,middle)]], [[JOSMImage(dialogs/add_tms,20,middle)]] or [[JOSMImage(dialogs/add_wmts,20,middle)]] and follow the instructions.
     21To 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.
    2222
    23 To delete an entry in the bottom list select it and click on the [[JOSMImage(dialogs/delete,20,middle)]] button.
     23To delete an entry in the bottom list select it and click on the [[JOSMImage(dialogs/delete)]] button.
     24
     25The bottom list is saved in advanced preference as value of key: `imagery.entries`
    2426
    2527To 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
    2629
    2730== Settings ==#Settings
    2831Here you can edit some general imagery settings.
    2932
    30 Tiles zoom offset: 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.
     33=== Common Settings ===#CommonSettings
     34 Sharpen (requires layer re-add)::
     35  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. \\
     36  ''Advance preference: `imagery.sharpen_level`
     37
     38 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. \\
     40  ''Advance preference: `imagery.generic.zoom_offset`
     41
     42=== WMS Settings ===#WmsSettings
     43 Auto zoom by default::
     44  weather the zoom levels of the WMS imagery layer should be adjusted when zooming in or out of the map. \\
     45  ''Advance preference: `imagery.wms.default_autozoom` (default: `true`)
     46
     47 Simultaneous connections::
     48  Number of simultaneous connections. \\
     49  ''Advance preference: `imagery.wms.loader.maxjobs` (default: `3`)''
     50
     51 Tile size::
     52  size of each tile. \\
     53  ''Advance preference: `imagery.wms.imageSize` (default: `512`)''
     54
     55=== TMS Settings ===#TmsSettings
     56 Auto zoom by default::
     57  whether the zoom levels of the TMS imagery layer should be adjusted when zooming in or out of the map. \\
     58  ''Advance preference: `imagery.generic.default_autozoom` (default: `true`)''
     59
     60 Autoload tiles by default::
     61  whether TMS tiles should be loaded automatically or only manually. \\
     62  ''Advance preference: `imagery.generic.default_autoload` (default: `true`)''
     63
     64 Min. zoom level::
     65  minimum zoom level for TMS layers. \\
     66  ''Advance preference: `imagery.tms.min_zoom_lvl` (default: `2`)''
     67
     68 Max. zoom level::
     69  maximum zoom level for TMS layers. \\
     70  ''Advance preference: `imagery.tms.max_zoom_lvl` (default: `20`)''
     71
     72 Add to slippymap chooser::
     73  whether TMS imagerys should be available in download dialog. \\
     74  ''Advance preference: `imagery.tms.add_to_slippymap_chooser` (default: `true`)''
     75
     76 Maximum concurrent downloads::
     77  global maxium number of parallel TMS imagery downloads. \\
     78  ''Advance preference: `imagery.tms.tmsloader.maxjobs` (default: `25`)''
     79
     80 Maximum concurrent downloads per host::
     81  maxium number of parallel TMS imagery downloads per host. \\
     82  ''Advance preference: `imagery.tms.tmsloader.maxjobsperhost` (default: `6`)''
    3183
    3284== Offset bookmarks ==#OffsetBooksmarks
    33 Here are listed all offset bookmarks which can easily be added via "New offset" in the [wikitr:/Help/Menu/Imagery Imagery menu].
     85Here are listed all offset bookmarks which can easily be added via "New offset" in the [wikitr:/Help/Menu/Imagery Imagery menu]. \\
     86''Advance preference: `imagery.offsetbookmarks`''
    3487
    3588== Cache ==#Cache
    3689Here 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.
    3790
    38 A 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.
     91A 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.
    3992
    40 [[Image(scr_imagery_prefs_cache.png,400px)]]
     93 Tile cache directory::
     94   location of the imagery tile cache, see [wikitr:/Help/Preferences#JOSMpreferencedatacachedirectories default directories]. \\
     95  ''Advance preference: `imagery.generic.loader.cachedir`''
     96
     97 Maximum size of disk cache (per imagery) in MB::
     98  quota option per imagery. \\
     99  ''Advance preference: `imagery.cache.max_disk_size` (default: `512`)''
     100
     101[[Image(scr_imagery_prefs_cache.png,link=,400px)]]
    41102
    42103----
     104Back to [wikitr:/Help/Action/Preferences Preferences] \\
    43105Back to [wikitr:/Help Main Help]