Use g_mkdir instead of native mkdir
[viking/gosmore.git] / doc / GETTING-STARTED
blob350ed57a88549d67f5f7324fdc9ce1e4c9596cab
1 To quickly get started using Viking, follow these instructions.
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.)
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".
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.
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.
29 ----
31 TODO: some explanation of the layers, etc. is required.