From 7233fcb656b321f5690667077d4c629300fd6ddd Mon Sep 17 00:00:00 2001 From: Rob Norris Date: Fri, 15 Oct 2010 20:19:17 +0100 Subject: [PATCH] Various improvements and tidy ups. Improve concepts: . Add what is a Layer . Mention Statusbar Better use of 'appname' Move verbose/debug mode to bottom + add example for a map download General GUI reference improvements. Add Begin Track Icon. Other misc bits as I went along... --- help/C/figures/begintr_18.png | Bin 0 -> 345 bytes help/C/viking.xml | 300 ++++++++++++++++++++++------------ 2 files changed, 195 insertions(+), 105 deletions(-) create mode 100644 help/C/figures/begintr_18.png diff --git a/help/C/figures/begintr_18.png b/help/C/figures/begintr_18.png new file mode 100644 index 0000000000000000000000000000000000000000..b3e0987770d9b4262892e1ce80ff9a7213168982 GIT binary patch literal 345 zcmeAS@N?(olHy`uVBq!ia0vp^LLkh+1|-AI^@Rf|wj^(N7l!{JxM1({$v_d#0*}aI z1_o|n5N2eUHAey{$X?><>&kwei(Q<{;Ntbue}F==C9V-A&iT2ysd*&~&PAz-C8;S2 z<(VZJ3LzP(3hti10q;{(^MDHXdb&7N`~*55iO_L;##cA4IFoP zpOxFW=73V>3uDH9w&E_Qp2A0$CVjP=#Pg=a=b`m0DL=Q{r%tiN$ej;eF!9L2H7&PK zO{(?%W?Fhtzei){%^>fZ7irgah-~Uvno?(Db-%B>VbAV)@9Z^i-MzJbsjJ$o)=ArP z_WRtp^l$&tpBDrVB(=@)^O1b*d^|J5=cSeagYx7{hbJyEGOy26{$*lvlRHo4R`r{} jH_m#0bKIo=sqbNU=@WRi$ni}#&?5| Viking"> - + - + ]> + + +in the tools menu choose Begin Track which looks like this: +
+Begin Track Icon + + + +
+
leftclick in the map window, enter a name click several times to generate a track (a right-click removes the last point) expand tracks in the layer menu, your track should show up, select it -right click your track, select apply DEM data -right click your track again, select properies -click the tab elevation distance - enjoy the plot +right click your track, select Apply DEM data +right click your track again, select Properies +click the tab Elevation-distance - enjoy the plot In order to save this setting for later usage -click OK in the track properties dialog -filesave as, choose a name (you can open this view later via fileopen). +click OK in the Track Properties dialog +FileSave As, choose a name (you can open this view later via fileOpen). @@ -794,16 +793,16 @@ In order to save this setting for later usage Suppose you want to have the map and DEM data offline for your holiday in Italy near Bologna. -Start a new viking session. -viewgoto location, enter Bologna -layersnew map layer +Start a new &appname; session. +ViewGo to Location, enter Bologna +LayersNew Map Layer Choose e.g. OpenStreetMap (mapnik). adapt the maps directory e.g. to /home/user/.viking-map-holiday/. This allows you to delete the map stuff after holiday without purging the rest of your maps. check autodownload map keep viking zoom level -zoom out to 1024/1024 +zoom out to 1024 add a DEM layer (as discussed above) download the DEM data @@ -817,14 +816,14 @@ tiles into .viking-map-holiday/ if you like. uncheck the DEM layer for the map to show up navigate the map to be centered at Bologna -choose the zoom such, that all regions of interest are displayed in the map window (e.g. 1024/1024) +choose the zoom such, that all regions of interest are displayed in the map window (e.g. 1024) follow this sequence until you have all tiles for all zoom levels you need -right-click the map layer properties +right-click the map layer properties set the zoomlevel explicitely one below the last (in the first cycle 512), hit OK -right click the map layer download onscreen maps -wait untill all tiles for that resolution have been downloaded +right click the map layer Download Missing Onscreen Maps +wait until all tiles for that resolution have been downloaded @@ -841,7 +840,7 @@ Do not forget to save your configuration (as discussed above).
Uploading data to OpenStreetMap -It is possible to upload data directly from Viking to OpenStreetMap. +It is possible to upload data directly from &appname; to OpenStreetMap. Upload a layer @@ -861,7 +860,7 @@ this, simply select the layer and right click on it. Then, select Fill in the form -On both case, Viking will reclaim some informations. +In both cases, &appname; will retain some information. The email field is the email you used to subscribed into OSM. The password field is the password you used with this account. The filename is the name you want your upload has on the server. This information is displayed by the osm server. @@ -1003,7 +1002,7 @@ to write the waypoints to this file.
- External tools + Webtools It is possible to add new external tools. The file is ~/.viking/external_tools.xml. An example of the file in the distribution doc/examples/external_tools.xml. Currently, there is a single object class available: VikWebtoolCenter. Such feature allows to declare any Webtool using a logic based on center coordinates and zoom level value. @@ -1027,7 +1026,98 @@ to write the waypoints to this file.
+
What to Do if &appname; Does Not Seem to Work + +In order to get some information about what &appname; is doing, start it in verbose debug mode via the command line: +viking -dV + + +For instance you can check the correct URLs &appname; is using in requesting remote data for DEMs or map tiles in the verbose debug output. +E.g. Something like this for DEMs: + +** (viking:28778): DEBUG: curl_download_uri: uri=http://dds.cr.usgs.gov/srtm/version2_1/SRTM3/Eurasia/N48E008.hgt.zip +* About to connect() to dds.cr.usgs.gov port 80 (#0) +* Trying 152.61.128.95... * connected +* Connected to dds.cr.usgs.gov (152.61.128.95) port 80 (#0) + GET /srtm/version2_1/SRTM3/Eurasia/N48E008.hgt.zip HTTP/1.1 +User-Agent: viking/0.9.8 libcurl/7.18.2 GnuTLS/2.4.2 zlib/1.2.3.3 libidn/1.8 +Host: dds.cr.usgs.gov +Accept: */* + HTTP/1.1 200 OK + Date: Sun, 26 Jul 2009 18:13:38 GMT + Server: Apache + Last-Modified: Tue, 21 Jul 2009 19:57:35 GMT + ETag: eac3f8-1828f5-46f3caa76070a + Accept-Ranges: bytes + Content-Length: 1583349 + Content-Type: application/zip + +* Connection #0 to host dds.cr.usgs.gov left intact +* Closing connection #0 +** (viking:28778): DEBUG: dem_layer_add_file: /home/username/.viking-maps/srtm3-Eurasia/N48E008.hgt.zip + +Or for OSM Mapnik tile server: + +* About to connect() to tile.openstreetmap.org port 80 (#0) +* Trying 193.63.75.28... * connected +* Connected to tile.openstreetmap.org (193.63.75.28) port 80 (#0) + GET /13/4065/2748.png HTTP/1.1 +User-Agent: viking/0.9.96 libcurl/7.20.1 GnuTLS/2.8.6 zlib/1.2.3.4 libidn/1.18 +Host: tile.openstreetmap.org +Accept: */* + +* HTTP 1.0, assume close after body + HTTP/1.0 200 OK + Date: Thu, 14 Oct 2010 22:18:42 GMT + Server: Apache/2.2.8 (Ubuntu) + ETag: "b66ff9d46474bab68262a3483428a232" +** (viking:16704): DEBUG: curl_get_etag_func: ETAG found: "b66ff9d46474bab68262a3483428a232" + Content-Length: 17194 + Cache-Control: max-age=94805 + Expires: Sat, 16 Oct 2010 00:38:47 GMT + Content-Type: image/png + Age: 5153 + X-Cache: HIT from konqi.openstreetmap.org + X-Cache-Lookup: HIT from konqi.openstreetmap.org:3128 + Via: 1.1 konqi.openstreetmap.org:3128 (squid/2.7.STABLE7) + Connection: close + +* Closing connection #0 +* About to connect() to a.andy.sandbox.cloudmade.com port 80 (#0) +* Trying 178.63.75.195... ** (viking:16704): DEBUG: curl_download_uri: uri=http://tile.openstreetmap.org/13/4065/2749.png +* About to connect() to tile.openstreetmap.org port 80 (#0) +* Trying 193.63.75.28... * connected +* Connected to a.andy.sandbox.cloudmade.com (178.63.75.195) port 80 (#0) + GET /tiles/cycle/13/4065/2747.png HTTP/1.1 +User-Agent: viking/0.9.96 libcurl/7.20.1 GnuTLS/2.8.6 zlib/1.2.3.4 libidn/1.18 +Host: a.andy.sandbox.cloudmade.com +Accept: */* + +* connected +* Connected to tile.openstreetmap.org (193.63.75.28) port 80 (#0) + GET /13/4065/2749.png HTTP/1.1 +User-Agent: viking/0.9.96 libcurl/7.20.1 GnuTLS/2.8.6 zlib/1.2.3.4 libidn/1.18 +Host: tile.openstreetmap.org +Accept: */* + +* HTTP 1.0, assume close after body + HTTP/1.0 200 OK + Date: Thu, 14 Oct 2010 23:44:35 GMT + Server: Apache/2.2.8 (Ubuntu) + ETag: "8e520ad47ce9c1b63430554886eb5fab" +** (viking:16704): DEBUG: curl_get_etag_func: ETAG found: "8e520ad47ce9c1b63430554886eb5fab" + Content-Length: 18094 + Cache-Control: max-age=87742 + Expires: Sat, 16 Oct 2010 00:06:57 GMT + Content-Type: image/png + X-Cache: MISS from konqi.openstreetmap.org + X-Cache-Lookup: MISS from konqi.openstreetmap.org:3128 + Via: 1.1 konqi.openstreetmap.org:3128 (squid/2.7.STABLE7) + Connection: close + + +
+ - -- 2.39.5