"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY appname "Viking">
<!ENTITY app "<application>Viking</application>">
- <!ENTITY appversion "1.0">
- <!ENTITY manrevision "0.1">
- <!ENTITY date "October 2010">
+ <!ENTITY appversion "1.1">
+ <!ENTITY manrevision "0.2">
+ <!ENTITY date "January 2011">
]>
<!--
(Do not remove this comment block.)
</para>
</section>
+<section><title>Split By Number of Points</title>
+<para>
+Version1.2+: This operation will split a single track into segments by the number of points specified.
+This can be useful with devices which may have limits on the number of points it supports.
+</para>
+</section>
+
<section><title>Apply DEM data</title>
<para>
If any DEM data is loaded, this will apply the DEM data to give the track elevation data.
</section><!-- End DEM -->
+
+<section><title>Maps Layer</title>
+<para>
+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.
+</para>
+<para>
+Some maps are continually improving over time (e.g. OSM) 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 <guilabel>Reload All Onscreen Maps</guilabel> option.
+</para>
+<para>
+Inbuilt maps include various <ulink url="http://en.wikipedia.org/wiki/TerraServer-USA">Terraserver</ulink> (Primarily USA coverage) and <ulink url="http://en.wikipedia.org/wiki/OpenStreetMap">OpenStreetMap (OSM)</ulink> ones and more:
+</para>
+<itemizedlist>
+<listitem><para>Terraserver Topos</para></listitem>
+<listitem><para>Terraserver Aerials</para></listitem>
+<listitem><para>Terraserver Urban Areas</para></listitem>
+<listitem><para>OpenStreetMap (Osmarender)</para></listitem>
+<listitem><para>OpenStreetMap (Mapnik) - This is the default</para></listitem>
+<listitem><para>OpenStreetMap (Maplint)</para></listitem>
+<listitem><para>OpenStreetMap (Cycle)</para></listitem>
+<listitem><para>NASA BlueMarble</para></listitem>
+<listitem><para>SpotMap (&appname; Version1.1+)</para></listitem>
+</itemizedlist>
+
+<para>
+&appname; can be configured to handle additional maps. See <link linkend="extend_viking">Extending &appname;</link> for further detail.
+</para>
+
+<section><title>Layer Operations</title>
+<section><title>Download Missing Onscreen Maps</title>
+<para>
+This requests map tiles for areas of the viewport that do not currently have one.
+</para>
+</section>
+
+<section><title>Download New Onscreen Maps</title>
+<para>
+This requests map tiles only if the maps are older than the Tile Age preference.
+</para>
+</section>
+
+<section><title>Reload All Onscreen Maps</title>
+<para>
+Force a refresh of all visible map tiles.
+</para>
+</section>
+</section>
+
+
+</section><!-- End Maps -->
+
+<section><title>Aggregrate Layer</title>
+<para>
+This layer is a container layer to hold other layers. There is always an initial and controlling 'Top Layer' that can not be removed, although it can be renamed.
+</para>
+<para>
+This layer type is useful for grouping other layers, especially TrackWaypoint layers, in whatever categories are relevant to you: such as by activity, location or date.
+Here are some suggestions:
+<itemizedlist>
+<listitem><para>Hiking</para></listitem>
+<listitem><para>Mountain Biking</para></listitem>
+<listitem><para>Road Cycling</para></listitem>
+<listitem><para>Car Trips</para></listitem>
+<listitem><para>Sailing</para></listitem>
+<listitem><para>Holidays</para></listitem>
+<listitem><para>UK Points of Interest</para></listitem>
+<listitem><para>USA Points of Interest</para></listitem>
+<listitem><para>etc...</para></listitem>
+</itemizedlist>
+</para>
+<para>
+Thus one can have a list of all your tracks, but groups can be shown or not using the relevant layers visibility checkbox.
+</para>
+
+<para>
+This layer only has one operation: <guilabel>New Layer</guilabel>
+</para>
+
+<section><title>New Layer</title>
+<para>
+Add a new layer of the selected type.
+</para>
+</section>
+
+</section><!-- End Agg -->
+
+<section><title>GeoRef Layer</title>
+<para>
+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.
+</para>
+<section><title>Layer Operations</title>
+<section><title>Zoom to Fit Map</title>
+<para>
+Automatically set a zoom level to see the entire map coverage.
+</para>
+</section>
+
+<section><title>Goto Map Center</title>
+<para>
+Center the viewport on this map.
+</para>
+
+</section>
+<section><title>Export to World File</title>
+<para>
+Opens a file save dialog to save the scale and position information as a <ulink url="http://en.wikipedia.org/wiki/World_file">World File</ulink>.
+</para>
+</section>
+</section>
+
+</section><!-- End GeoRef -->
+
+<section><title>Coord Layer</title>
+<para>
+This layer is allows drawing of grid lines on the viewport.
+</para>
+</section><!-- End Coord -->
+
<section><title>Tools</title>
<para>
You can use the scroll wheel and the right-click to zoom and pan no matter what tool you are using.
</para>
</section>
-<section>
+<section id="extend_viking">
<title>Extending Viking</title>
<para>Currently, &app; has some extention points based on configuration files. The file format is heavily inspired by the GtkBuilder file format: you specify the class of the GObject to build and set its properties. Technically, it is a XML file containing a "objects" root element. Inside this element, you set a collection of "object".</para>
<section>
<title>Map Source</title>
<para>It is possible to add new map's sources. The file is <filename>~/.viking/maps.xml</filename>.</para>
- <para>An example of the file in the distribution <filename>doc/examples/maps.xml</filename>.</para>
+ <para>An example of the file is in the distribution <filename>doc/examples/maps.xml</filename>. Further examples and values are online in the <ulink url="http://sourceforge.net/apps/mediawiki/viking/index.php?title=Maps">Maps Wiki</ulink></para>
+
<para>The VikSlippyMapSource allows to declare any map's source working like OpenStreetMap. It supports the following properties:
<variablelist>
<varlistentry>
projects / andy / viking.git / blobdiff