X-Git-Url: https://git.street.me.uk/andy/viking.git/blobdiff_plain/90f15672ad2318d418dd6af4764dafdd168e67cd..a2d207d7200a11313bd98202a5be081bc92c70dc:/doc/viking.xml diff --git a/doc/viking.xml b/doc/viking.xml index f4777614..0f7689e7 100644 --- a/doc/viking.xml +++ b/doc/viking.xml @@ -30,7 +30,10 @@ and docbook-xsl in your Build-Depends control field. Ralf"> Meyer"> - 2008-05-02"> + 2013-04-08"> + + + 1"> @@ -44,7 +47,10 @@ and docbook-xsl in your Build-Depends control field. GPL"> ]> - + +&dhsource; &dhversion; + +
&dhemail; @@ -57,12 +63,17 @@ and docbook-xsl in your Build-Depends control field. 2010 Guilhem Bonnefille + + 2013 + Rob Norris + &dhdate; &dhucpackage; - &dhsection; + &dhsource; + &dhversion; &dhpackage; @@ -101,22 +112,19 @@ and docbook-xsl in your Build-Depends control field. DESCRIPTION - Viking is a free/open source program to manage GPS data. You can - import and plot tracks and waypoints, show OpenStreetMap (OSM) maps and/or - Terraserver maps under it, add coordinate lines, make new tracks - and waypoints, hide different things, etc. It is written in C - with the GTK+ 2 toolkit, available for Linux, other POSIX - operating systems, and Windows, and is licensed under the GNU GPL. + Viking is a program to manage GPS data. - Homepage: http://viking.sf.net + You can import and plot tracks, routes and waypoints, show OpenStreetMap (OSM) maps and/or + Terraserver maps under it, add coordinate lines, make new tracks, routes and waypoints, hide different things, etc. + It is written in C with the GTK+ 2 toolkit, available for Linux, other POSIX operating systems and Windows. - - This manual page was written for the &debian; distribution - because the original program does not have a manual page. + + Homepage: http://viking.sf.net + + + Viking is licensed under the GNU GPL. - - &dhpackage; is a program to manage GPS data @@ -201,6 +209,26 @@ and docbook-xsl in your Build-Depends control field. + The VikTmsMapSource allows to declare any TMS service. It supports the following properties: + + + id + this is an integer and should be unique as it used to identify the map source + + + label + the text displayed in the map's source selection dialog + + + hostname + the server's hostname (eg. "tile.openstreetmap.org") + + + url + the parametrized address of the tile, in the spirit of C printf format, with 3 "%d" fields for X, Y and Z (zoom level) (eg. "/%d/%d/%d.png") + + + The VikWmscMapSource allows to declare any WMS or WMS-C service. It supports the following properties: @@ -263,20 +291,74 @@ and docbook-xsl in your Build-Depends control field. External tools 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. + The VikWebtoolCenter allows to declare any Webtool using a logic based on center coordinates and zoom level value. The related properties are: - id - this is an integer and should be unique as it used to identify the tool + label + the text displayed in the menu entry + + + url + the parametrized URL to open, in the spirit of C printf format, with 2 "%s" and a "%d" fields for X, Y and Z (zoom level) (eg. "http://hostname/?lat=%s&lon=%s&zoom=%d") + + + + The VikWebtoolBounds allows to declare any Webtool using a logic based on bounds coordinates. + The related properties are: + + + label + the text displayed in the menu entry + + + url + the parametrized address of the tile, in the spirit of C printf format, with 4 "%s" fields for left, right, bottom and top (eg. "http://hostname:8111/load_and_zoom?left=%s&right=%s&bottom=%s&top=%s") + + + + + + Remote File Datasources + It is possible to add web references expected to return a file which can then be opened directly or converted via GPSBabel. + The file is ~/.viking/datasources.xml. + An example of the file is in the source distribution doc/examples/datasources.xml. + The VikWebtoolDatasource allows to declare any URL using logic based on coordinates. + The related properties are: + label the text displayed in the menu entry url - the parametrized address of the tile, in the spirit of C printf format, with 3 "%d" fields for X, Y and Z (zoom level) (eg. "http://hostname/%d/%d/%d.png") + + 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 order and meaning of these parameters is given by the url_format_code below + + + + url_format_code + + A string describing the parametrized URL substitution parameters, each character represents how to translate each term. + B = Bottom of the current view i.e. minimum latitude + L = Left of the current view i.e. minimum longitude + T = Top of the current view i.e. maximum latitude + R = Right of the current view i.e. maximum longitude + 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 + Thus for the url example above then the format code should be AO + + + + file_type + + This value is passed on for the -i parameter in interfacing with GPSBabel. + If it is not defined then the returned file is interpreted internally as a GPX file. + Possible values such as 'kml', 'mapsource' etc.. can be used. See GPSBabel File Formats for the full list. + @@ -308,12 +390,33 @@ and docbook-xsl in your Build-Depends control field. See previous section for details. + + ~/.viking/datasources.xml + + File containing definition of remote file datasources. + See previous section for details. + + ~/.viking/viking.prefs Preferences for &dhpackage;. + + ~/.viking/viking_layer_defaults.ini + + Layer default values for &dhpackage;. + + + + ~/.viking/viking.ini + + Values for &dhpackage; automatically saved between sessions. + Not generally intended to be manually edited. + However some finer control of default internal values can be set. + + ~/.viking/cookies.txt @@ -328,16 +431,41 @@ and docbook-xsl in your Build-Depends control field. + Extension files (maps.xml, + goto_tools.xml, + datasources.xml, + external_tools.xml) + are also searched in /etc/viking and + /usr/share/viking directories (or related in your system). + - SEE ALSO + ENVIRONMENT + + + + XDG_DATA_HOME + + Optional directory to look for extension files + (maps.xml, goto_tools.xml, + external_tools.xml). + + + + XDG_DATA_DIRS + + Path used to change the directories scanned for extension files + (maps.xml, goto_tools.xml, + external_tools.xml). + + + - viking-remote (1). AUTHOR - This manual page was written by &dhusername; &dhemail; for + This manual page was originally written by &dhusername; &dhemail; for the &debian; system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the &gnu; General Public License, Version 2 any @@ -350,4 +478,4 @@ and docbook-xsl in your Build-Depends control field. - +