X-Git-Url: https://git.street.me.uk/andy/viking.git/blobdiff_plain/f2e8376ac7906ba36022fe16f395ac3a3e8c840c..f928e7c40593855ebbbc9706f40155cfc2df1eaa:/help/C/viking.xml diff --git a/help/C/viking.xml b/help/C/viking.xml index b918ea94..221d27ca 100644 --- a/help/C/viking.xml +++ b/help/C/viking.xml @@ -112,7 +112,7 @@ Uploading and downloading waypoints, tracks and routes to/from GPS. -Preparing tracks, routes and waypoints for trips using maps from services such as OpenStreetMap (OSM) and/or Terrasever. +Preparing tracks, routes and waypoints for trips using maps from services such as OpenStreetMap (OSM). The data is only needed to be uploaded to your GPS before you leave. The maps together with your tracks, routes and waypoints can also be printed and used during the trip. @@ -150,7 +150,7 @@ Analyzing speed at different places (to some degree), adding waypoints where you -Downloading and storing OpenStreetMap and/or Terraserver maps on your hard drive and looking at them later. +Downloading and storing OpenStreetMap and/or other map types on your hard drive and looking at them later. @@ -249,7 +249,7 @@ The main &appname; area where the layer data is drawn, is called the -
Projections +
Projections &appname; supports differents projections: @@ -266,7 +266,7 @@ The main &appname; area where the layer data is drawn, is called the
-
Map Cache +
Map Cache &appname; stores downloaded map tiles to disk for a couple of reasons: @@ -298,6 +298,19 @@ The &appname; automatic caching strategy is two fold: This can be useful if you contribute to OpenStreetMap and wish to see your modifications (of course give time for the server to have processed your changes - see I have made edits but they don't show up on the map) + + +The layout of the cache on disk itself can be controlled via a per Map Layer property. + +Viking - Legacy default in a private cache layout scheme +OSM - Newer available default (1.6+) + +This is to increase the compatibility between &appname; and similar applications that cache tiles on disk so that the tiles can be shared. + + + + +
Shortcut Keys @@ -1528,13 +1541,15 @@ Using many DEMs is CPU/memory intensive. Depending on your computer's capability
Maps Layer -This layer provides a single map resource, you may have multiple map layers but only top one (if enabled) will be visible. -You will need an open internet connection when you are downloading maps, but once downloaded they are available from the hard disk cache. When map are avaliable from the disk cache it is much faster and can be used offline. +This layer provides a single map resource, you may have multiple map layers but only top one (if enabled) will be visible (subject to the Alpha compositing property). -Some maps are continually improving over time (e.g. OpenStreetMap) and so in order to not to have to (re)download the data all the time &appname; employs a timeout method - Tile Age to determine whether to access the server. However a forced refresh for the current view can be made via the Reload All Onscreen Maps option. +Some maps are continually improving over time (e.g. OpenStreetMap) thus &appname; employs a caching mechanism to avoid redownloading data (see ). +However a forced refresh for the current view can be made via the Reload All Onscreen Maps option or Ctrl+F5. +Online Map Tile Providers +You will need an open internet connection when you are downloading maps these following map types, but once downloaded they are available from the hard disk cache. When map are avaliable from the disk cache it is much faster and can be used offline. Inbuilt maps include various OpenStreetMap (OSM) ones and more: @@ -1546,10 +1561,54 @@ Inbuilt maps include various OpenStreetMa OpenStreetMap (Humanitarian) (&appname; Version1.5+) NASA BlueMarble + + + +&appname; can be configured to handle additional online map resources. See for further detail. + + +Offline Map Tilesets + +Some map types supported are for on disk tile formats: + + + + On Disk OSM Tile Format + This is equivalent to any map set with OSM Cache Layput. + +MBTiles File +OSM Metatiles + + +Of course you need to have acquired or generated these tilesets yourself. + + +
Map Layer Properties -&appname; can be configured to handle additional maps. See for further detail. +Configurable properties: + + + Map Type. The kind of map this layer displays. + Map types are dependent on the current mode. + +Maps Directory. Not applicable for MBTiles Map type since it is a single file. +Cache Layout. Viking or OSM. See . Only applies to maps from online tile providers. +Map File. Ony applicable for MBTiles Map type since it is a single file. + + Alpha. Control the Alpha value for transparency effect using a value between 0 and 255 with the default being 255 for a fully solid image. + Zero is fully transparent. A value of around 160 can be useful for blending views of multiple map layers (when applied to the upper most map layer). + +Autodownload Maps. This can be useful to turn off when you are not online to avoid pointless download requests or may be keep a map in a 'historical' state. +e.g. perhaps in case a current map rendering is broken. +Autodownload Only Gets Missing Maps. Using this option avoids attempting to update already acquired tiles. +This can be useful if you want to restrict the network usage, without having to resort to manual control. Only applies when Autodownload Maps is on. +Zoom Level. Determines the method of displaying map tiles for the current zoom level. +Viking Zoom Level uses the best matching level, otherwise setting a fixed value will always use map tiles of the specified value regardless of the actual zoom level. + +
+
Layer Operations
Download Missing Onscreen Maps @@ -2826,6 +2885,22 @@ Accept: */* See Zoom Levels + + lat-min (optional) + The minimum latitude value in degrees supported by the tile server. The Default is -90 degrees if not specified. + + + lat-max (optional) + The maximum latitude value in degrees supported by the tile server. The Default is 90 degrees if not specified. + + + lon-min (optional) + The minimum longitude value in degrees supported by the tile server. The Default is -180 degrees if not specified. + + + lon-max (optional) + The maximum longitude value in degrees supported by the tile server. The Default is 180 degrees if not specified. + file-extension (optional) @@ -2837,6 +2912,14 @@ Accept: */* Remember to include the beginning '.' when specifying this parameter. + + use-direct-file-access (optional) + + Only use files on disk. The default is FALSE + This can also be useful for tilesets already on disk as it will avoid attempting to download any tiles. + Thus with this type the hostname and url parameters are not necessary and are ignored. + + switch-xy (optional) @@ -2877,6 +2960,24 @@ Accept: */* check-file-server-time (optional) + + zoom-min (optional) + + + zoom-max (optional) + + + lat-min (optional) + + + lat-max (optional) + + + lon-min (optional) + + + lon-max (optional) + The VikWmscMapSource allows to declare any WMS or WMS-C service. It supports the following properties (as per VikSlippyMapSource above): @@ -2896,6 +2997,24 @@ Accept: */* check-file-server-time (optional) + + zoom-min (optional) + + + zoom-max (optional) + + + lat-min (optional) + + + lat-max (optional) + + + lon-min (optional) + + + lon-max (optional) +
@@ -3051,6 +3170,7 @@ Accept: */* A = center lAtitude of the current view O = center lOngitude of the current view Z = OSM Zoom value of the current view. See Zoom Levels + S = A user specified input string requested from the user via a dialog box Thus for the url example above then the format code should be AO @@ -3062,6 +3182,20 @@ Accept: */* Possible values such as 'kml', 'mapsource' etc.. can be used. See GPSBabel File Formats for the full list. + + babel_filter_args + + This value is passed on for the filter arguments interfacing with GPSBabel. + E.g. "-x nuketypes,routes" can be used to filter all routes from the results. + + + + input_label + + This value is used when requesting input from the user. + It is the label of the text input box. + +
@@ -3185,6 +3319,8 @@ Accept: */*
+ +