X-Git-Url: https://git.street.me.uk/andy/viking.git/blobdiff_plain/e93a40348be6afc05870214f7264884a17153035..44d6bd848a2837d9c8d2a6097a8ee16d282e8596:/help/C/viking.xml?ds=sidebyside diff --git a/help/C/viking.xml b/help/C/viking.xml index 9f493293..423ee6c4 100644 --- a/help/C/viking.xml +++ b/help/C/viking.xml @@ -3,9 +3,9 @@ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [ Viking"> - - - + + + ]> -
GeoRef Layer - -This layer allows one to use any image as a map. You will need to tell it how to align the map to a position in the world and the scale of map. - -
Layer Operations -
Zoom to Fit Map - -Automatically set a zoom level to see the entire map coverage. - -
- -
Goto Map Center - -Center the viewport on this map. - + -
-
Export to World File - -Opens a file save dialog to save the scale and position information as a World File. - -
-
- -
+
Coordinate Layer @@ -2071,7 +2116,7 @@ For Linux you can override this with the setting in the Georef Map Layer Tools You must have a Map Layer selected to use these tools. @@ -2271,6 +2316,31 @@ Generally if you have a system with lots of memory it's recommended to increase This allows setting the specific location of GPSBabel. &appname; will need to be restarted for this setting to take effect.
+
Auto Read World Files +If this is on, when a new image is selected for the GeoRef layer then the associated world file will be read to find the scale and positional properties. +The associated file is based on filename patterns; e.g. if the image is filename.jpg - then the world file may be filename.jpgw or filename.jgw +
+ + +
Advanced +
Save File Reference Mode + + Files referenced within project files can be saved with either absolute or relative paths. + Using relative paths can be useful when copying the project file and the associated files between different systems. + +
+
Ask for Name before Track Creation +A setting to control whether an automatic name is used when creating a new track or route, or whether you are asked to enter a name. +
+
Show Tooltip during Track Creation +A setting to control whether the tooltip with the cumulative track or route distance is shown when creating tracks and routes. +
+
The number of recent files + + The number of recent files shown in the FileOpen Recent File menu. + A value of -1 means all files. The new value applies to New Windows only (or on application restart). + +
OpenStreetMap Traces @@ -2284,6 +2354,40 @@ Your OSM password will be stored in plain text.
+
Mapnik + +If any changes to these settings are made, you will need to restart &appname; to make them be applied. + + +
Plugins Directory +The location of Mapnik plugins. An attempt is made to automatically determine the initial value, + however if this is wrong or Mapnik is upgraded then the directory can be set here. +
+
Fonts Directory + +The location of fonts for use with Mapnik. Normally it is best to simply use the System's font directory. + +
+
Recurse Fonts Directory +Load fonts in any sub-directories of the main font directory. +
+
Rerender Timeout +The time in hours before any tile is rerendered. +This is useful in case the underlying source data for the tiles changes (e.g. OSM data is continually evovling). + &appname; normally has no way of knowing when the data has changed, so this simple timeout method is provided to maintain consistency of the tile images. +
+
CartoCSS +This allows setting the specific location of the carto executable. +
+
Threads + + The number of threads to use for Mapnik rendering tasks. + By default the value is set to the 1 in case of any multi-threading rendering code chain crashes. + Otherwise trying setting the value to the number of the CPUs of the system minus one (so as not to overload the system), in order to minimise the overall rendering times. + +
+
+
Routing
Routing engine You can select the routing engine used by default, ie by features that do not propose a live selection, like . @@ -2316,6 +2420,28 @@ Your OSM password will be stored in plain text.
+
Toolbar +
Append to Menu +Allows setting the toolbar on the same vertical space as the menu, thus increasing vertical space for the map. +
+
Icon Size +Allows configuration of the icon size, including overiding the system's default preference to the setting desired just for &appname; +
+
Icon Style +Allows configuration of the icon style, including overiding the system's default preference to the setting desired just for &appname; +
+
Customize +Opens the Customize Toolbar dialog. +From this dialog the items in the toolbar can be added, removed and reordered. Reordering of items is performed by drag and drop. +
+Customize Toolbar dialog + + + +
+
+
+ @@ -2861,7 +2987,7 @@ Accept: */* You can find more examples in the documentation part of the distribution. -
+
Map Source It is possible to add new map's sources. The file is ~/.viking/maps.xml for UNIX like systems, C:\Documents and Settings\username\.viking\maps.xml on Windows XP or C:\Users\username\.viking\maps.xml on Windows 7 onwards. An example of the file is in the distribution doc/examples/maps.xml. Further examples and values are online in the Maps Wiki @@ -3169,7 +3295,7 @@ Accept: */* url - the parametrized URL to open in the spirit of C printf format, with up to 7 "%s" values. e.g. http://hostname/getfile?lat=%s&lon=%s + the parametrized URL to open in the spirit of C printf format, with up to 9 "%s" values. e.g. http://hostname/getfile?lat=%s&lon=%s The order and meaning of these parameters is given by the url_format_code below @@ -3184,6 +3310,8 @@ 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 + P = selected Point's latitude + N = selected poiNt's longitude 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 @@ -3229,6 +3357,10 @@ Accept: */* Some values in this file are read only, in the sense that there is no way to set it other than by manually entering in the keys and values (the key will not exist in the file otherwise). This allows some fine tuning of &app; behaviours, without resorting to recompiling the code. However is it not expected that these values should need to be changed for a normal user, hence no GUI options for these have been provided. Here is the list of the read only keys and their default values. + + layers_create_trw_auto_default=false + Create new TrackWaypoint layers without showing the layer properties dialog first. + maps_max_tiles=1000 @@ -3241,9 +3373,24 @@ Accept: */* maps_real_min_shrinkfactor=0.0039062499 + + maps_scale_inc_down=4 + + + maps_scale_inc_up=2 + + + maps_scale_smaller_zoom_first=true + + + mapnik_buffer_size=128 (in pixels) + background_max_threads=10 + + background_max_threads_local=Number of CPUs + window_menubar=true @@ -3278,6 +3425,15 @@ Accept: */* If within this range it will skip over this location and move on to the next saved history location. + + external_diary_program=rednotebook + Or in Windows it uses C:/Progra~1/Rednotebook/rednotebook.exe - This string value must use Unix separators and not have spaces. + + + external_astro_program=stellarium + Or in Windows use C:/Progra~1/Stellarium/stellarium.exe - This string value must use Unix separators and not have spaces. + Further note due to this Bug in Stellarium means this does not actually work. You will need to reference a shortcut, rather than the executable directly. +
@@ -3294,6 +3450,7 @@ Accept: */* K = Some text to display at the start of the message - Trkpt A = Altitude of a Trackpoint S = Speed of a Trackpoint + B = Vertical Speed (Climb) C = Course of a Trackpoint L = Location of a Trackpoint T = Time of a Trackpoint @@ -3316,8 +3473,16 @@ Accept: */*
+
+
+ Keyboard Shortcuts (Accelerator) Settings + This is held in the file ~/.viking/keys.rc + It is in the standard GTK Accelerator map format. Values are automatically read in and saved between &app; sessions. + This file is not intended to be manually edited, but since it is a plain text file it can be changed if desired. +
+