[andy/viking.git] / doc / GETTING-STARTED

To quickly get started using Viking, follow these instructions.

1) Get some data from your GPS device. There are a couple ways to do this.
You can use gpspoint or you can use another program and translate it with
my version GPSBabel with gpspoint write support (or use the GPSBabel program
itself to download and translate at once.)

2) Open up viking and use File -> Open GPS Data to open the gpspoint file.
Viking will try to change its viewing area to the center of the layer (file)
but sometimes if you have waypoints and tracks which are very far apart you 
won't see anything. If this is the case, expand the layer (on the Layers 
Panel to the left), then expand "Waypoints", find a waypoint and right-click 
on it and click "Goto".

3) Now add a map layer ( Layers -> New Map Layer ), choose a suitable cache 
directory where you would like to store your tracks and click OK. Zoom to a 
comfortable level (I suggest 4 mpp) by clicking the left and right mouse 
buttons on the gray area where your tracks are. Now from the menu choose 
Tools -> Map Download, Click where you would like to download a map. 
Regardless of what tool you are using, the middle mouse button always pans.

4) You will notice the maps are being drawn on top of the tracks, which is 
probably not what you want. Look at the Layers Panel to the left. Notice how 
the layer named "Map" is ABOVE your TrackWaypoint layer that your GPS data is 
in. This means that it will be drawn last, or on top of the other layers. 
Select the Map layer from the list and click the down arrow button beneath 
the list. Your tracks will now be drawn over the map.

----

TODO: some explanation of the layers, etc. is required.
Commit	Line	Data
50a14534 EB	1	To quickly get started using Viking, follow these instructions.
	2
	3	1) Get some data from your GPS device. There are a couple ways to do this.
	4	You can use gpspoint or you can use another program and translate it with
	5	my version GPSBabel with gpspoint write support (or use the GPSBabel program
	6	itself to download and translate at once.)
	7
	8	2) Open up viking and use File -> Open GPS Data to open the gpspoint file.
	9	Viking will try to change its viewing area to the center of the layer (file)
	10	but sometimes if you have waypoints and tracks which are very far apart you
	11	won't see anything. If this is the case, expand the layer (on the Layers
	12	Panel to the left), then expand "Waypoints", find a waypoint and right-click
	13	on it and click "Goto".
	14
	15	3) Now add a map layer ( Layers -> New Map Layer ), choose a suitable cache
	16	directory where you would like to store your tracks and click OK. Zoom to a
	17	comfortable level (I suggest 4 mpp) by clicking the left and right mouse
	18	buttons on the gray area where your tracks are. Now from the menu choose
	19	Tools -> Map Download, Click where you would like to download a map.
	20	Regardless of what tool you are using, the middle mouse button always pans.
	21
	22	4) You will notice the maps are being drawn on top of the tracks, which is
	23	probably not what you want. Look at the Layers Panel to the left. Notice how
	24	the layer named "Map" is ABOVE your TrackWaypoint layer that your GPS data is
	25	in. This means that it will be drawn last, or on top of the other layers.
	26	Select the Map layer from the list and click the down arrow button beneath
	27	the list. Your tracks will now be drawn over the map.
	28
	29	----
	30
	31	TODO: some explanation of the layers, etc. is required.