X-Git-Url: https://git.street.me.uk/andy/viking.git/blobdiff_plain/e64708102df67db1a8cb715c1af21fae9b903abb..8429176e4077668daddb0e8a15a0088711552f62:/help/C/viking.xml diff --git a/help/C/viking.xml b/help/C/viking.xml index 3e04a9d8..f5f6dabd 100644 --- a/help/C/viking.xml +++ b/help/C/viking.xml @@ -249,6 +249,13 @@ The main &appname; area where the layer data is drawn, is called the +
Toolbar +The toolbar is an area for buttons that perform common actions. +Some actions are modal, so the appropriate layer needs selected before these toolbar buttons are enabled. See more detail. +The display of the toolbar is influenced by the +Right clicking on the toolbar and selecting Customize allows jumping to the directly. +
+
Projections &appname; supports differents projections: @@ -318,7 +325,7 @@ This is to increase the compatibility between &appname; and similar applications &appname; has several shortcut keys or key combinations for commands as listed in the main window along side the command. -Some function keys follow standard GUI behaviour: +By default some function keys follow standard GUI behaviour: F1 Help (view this manual) @@ -355,12 +362,33 @@ Then there are shortcuts specific to &appname; to switch projection modes, zoom Ctrl+Left Pan the viewport West Ctrl+Keypad+ Zoom In Ctrl+Keypad- Zoom Out -These work irrespective of the mode selected +These work irrespective of the mode selected For other combinations see the menu entry themselves.
+
+Keyboard Configuration +Keyboard configuration is supported by the standard GTK+ way of changing shortcuts for menu entries. +Hover over the menu option with the mouse pointer and press the keyboard shortcut you want to bind it to. +To delete a keyboard assignment, press Backspace whilst over the menu entry. + + + If the keyboard shortcut is already in use you will not receive any notification that new action replaces the old action. + This is probably why most distributions have this facility disabled by default. + Thus you will need to enable Editable menu accelerators for your system. + Check the Desktop Menu and Toolbar Control or other User Interface preferences for this setting. + + + + + For Windows systems this can be done by adding the line gtk-can-change-accels=1 to %USERPROFILE%\.gtkrc-2.0 (create the file if it does not exist). + + +From &app; 1.6+ the keyboard configuration is automatically loaded and saved between sessions in the +
+
Tracks vs Routes In theory a route is path you are planning to follow and a track of where you have actually been. The GPX specification splits these into two separate catergories, although tracks contain everything route may have. @@ -1552,6 +1580,7 @@ However a forced refresh for the current view can be made via the Relo 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: + Bing Bird's Eye (Aerial) Maps (&appname; Version1.2+) OpenStreetMap (Mapquest) - This is the default (&appname; Version1.3+) @@ -1561,7 +1590,6 @@ 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. @@ -1571,6 +1599,7 @@ Inbuilt maps include various OpenStreetMa Some map types supported are for on disk tile formats: + On Disk OSM Tile Format @@ -1582,7 +1611,6 @@ Some map types supported are for on disk tile formats: Of course you need to have acquired or generated these tilesets yourself. -
Map Layer Properties @@ -1801,31 +1829,7 @@ Tracks are searched first in preference over waypoints.
-
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 @@ -2244,6 +2248,16 @@ Generally if you have a system with lots of memory it's recommended to increase
KML Export Units Allows setting the units used when saved as the KML file type, such as Metric or Statue units
+
GPX Track Order + + Other software may display tracks in a particular order (often the order saved into the file). + This allows you to control the order they are saved when exporting to a GPX file. + +
+
GPX Waypoint Symbols +Some GPS devices require waypoint symbols to be in a particular case. +E.g. On a Garmin Oregon 450 they must be in Title Case to be recognized. +
Image Viewer (Not Windows) Allows setting the program used to view images associated with Waypoints. By default this is set to xdg-open which should open the system's default image viewer, however this can be overridden with this setting. @@ -2257,6 +2271,10 @@ Generally if you have a system with lots of memory it's recommended to increase Some other user defined program
+
GPSBabel +This allows setting the specific location of GPSBabel. +&appname; will need to be restarted for this setting to take effect. +
OpenStreetMap Traces @@ -2302,6 +2320,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 + + + +
+
+
+ @@ -2885,6 +2925,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) @@ -2930,38 +2986,74 @@ Accept: */* The VikTmsMapSource allows to declare any TMS service. It supports the following properties (as per VikSlippyMapSource above): - id + id - label + label - hostname + hostname - url + url - check-file-server-time (optional) + 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): - id + id - label + label - hostname + hostname - url + url - check-file-server-time (optional) + check-file-server-time (optional) + + + zoom-min (optional) + + + zoom-max (optional) + + + lat-min (optional) + + + lat-max (optional) + + + lon-min (optional) + + + lon-max (optional) @@ -3118,6 +3210,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 @@ -3129,6 +3222,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. + + @@ -3235,22 +3342,22 @@ 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. +
+ -
Dependencies -gpsbabel -&appname; uses GPSBabel to convert data. - -unbuffer (optional) -&appname; uses unbuffer command to optimize conversion calls. - -gpsd (optional - but not <trademark>Windows</trademark>) -&appname; can use gpsd to get the current location. - -
+ + +