Parent Directory | Revision Log
Webpage work
1 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" |
2 | "http://www.w3.org/TR/html4/loose.dtd"> |
3 | <html> |
4 | <head><title>GPXView - Geocaching with Maemo</title> |
5 | <link type="text/css" rel="stylesheet" href="style.css"> |
6 | </head><body> |
7 | <h1>GPXView - Geocaching with Maemo</h1> |
8 | |
9 | This is a work in progress ... |
10 | |
11 | <h2>Main Menu</h2> |
12 | |
13 | The main menu can be reached from the main screen (and e.g. not |
14 | from the map screen). It exact contents vary with the state of the |
15 | main screen and e.g. some menu entries may only be visible if the |
16 | main screen is in "GPX list" mode.<p> |
17 | |
18 | <center> |
19 | <img src="images/menu.gif"><h5>The main menu</h5> |
20 | </center> |
21 | |
22 | <h3>Tools Menu</h3> |
23 | |
24 | The tools submenu is reached via the main menu. It can be used |
25 | to invoke various geocaching related tools. The tools act as |
26 | if they were seperate programs but are tightly integrated into |
27 | GPXView and typically import or export data to or from GPXView.<p> |
28 | |
29 | <center> |
30 | <img src="images/tools.gif" align="center"><br> |
31 | <h5>The tools submenu</h5> |
32 | </center> |
33 | |
34 | <h4>Geomath</h4> |
35 | |
36 | <center> |
37 | <img src="images/geomath.gif" align="center"><br> |
38 | <h5>The Geomath tool</h5> |
39 | </center> |
40 | |
41 | The geomath tool allows very basic geocoordinate calculations. |
42 | Two coordinates can be entered into it as well as a distance and |
43 | a direction angle.<p> |
44 | |
45 | Clicking the "Calculate" button calculates the distance between |
46 | the two given coordinates and projects the first coordinate (on the |
47 | screens left) by the given distance and direction. The resulting |
48 | projected coordinate is then be displayed in the bottom row.<p> |
49 | |
50 | The resulting coordinate can be used within GPXView from the |
51 | coordinate selector tool using the geocalc icon:<br> |
52 | |
53 | <center><img src="images/pos_geomath.png"></center> |
54 | |
55 | This icon also shows up in the map if a valid geomath result is present. |
56 | |
57 | <h5>Usage example: "Go 120m in 65°" from the given start coordinate</h5> |
58 | |
59 | The cache description tells you to walk a certain distance into a certain |
60 | direction from a given coordinate. First you select the caches main position |
61 | <img src="images/cache_type_traditional.png"> from the coordinate selector |
62 | tool <img src="images/pos_get.png">. The start coordinate should then be |
63 | displayed in the left column. Now enter the requested distance and direction |
64 | into the appropriate fields (on Maemo5 using the picker tools). When done |
65 | just click "Calculate" and the "projection" row will contain your target |
66 | coordinate. This coordinate can now be selected in the caches "goto" view |
67 | and is also being shown in the map. You can even re-select the projected |
68 | coordinate in the Geomath dialog for further processing and to e.g. walk |
69 | another distance in another direction. |
70 | |
71 | <h4>Geotext</h4> |
72 | |
73 | <center> |
74 | <img src="images/geotext.gif"><br> |
75 | <h5>The Geotext tool</h5> |
76 | </center> |
77 | |
78 | The geotext tool allows two simple text operations often required to solve |
79 | a geocache. Many geocaches ask you to calculate the letter sum of a certain |
80 | text or word. Just enter this word into geotext and the character sum |
81 | is being displayed while you type. Another common operation is the "shift" |
82 | letters. If you shift the letter "a" by one you get the next letter "b" (and |
83 | "z" becomes "a" again). If you shift by two "a" becomes "c" and so on. This |
84 | is the so-called cesar encryption. A special case is a shift by 13. This |
85 | encryption of shifting letters by 13 is named rot13 and is for example used |
86 | on the geocaching.com website to encrypt hints and spoilers. |
87 | |
88 | <h4>Precise Position</h4> |
89 | |
90 | <center> |
91 | <img src="images/precpos.gif"><br> |
92 | <h5>The Precise Position tool</h5> |
93 | </center> |
94 | |
95 | The Precise Position is more for the hider than for the seeker. It is |
96 | supposed to be used when standing still. It allows you to average the |
97 | current position over some longer period of time. The tool will also |
98 | show you graphically how far all the positions received so far are |
99 | apart to give you an impression how precise the position really |
100 | is. The more coordinates you get and the smaller the radius of the |
101 | circle containing them all is the more precise is the resulting |
102 | coordinate. You can then copy the resulting coordinate to the |
103 | clipboard for further processing in other applications. |
104 | |
105 | <h4>GeoToad</h4> |
106 | |
107 | GeoToad is not part of GPXView itself but has to be installed |
108 | seperately. GeoToad is written in the ruby language and as of this |
109 | writing has to be installed together with the ruby interpreter from |
110 | the extras-devel repository when using Maemo5.<p> |
111 | |
112 | <a href="http://code.google.com/p/geotoad/">GeoToad</a> allows you to |
113 | download geocache information directly from the <a |
114 | href="http://www.geocaching.com/">geocaching.com website</a>. In order |
115 | to comply with the terms of that site, GeoToad intentionally runs |
116 | rather slow to prevent to overload that site with automated requests.<p> |
117 | |
118 | To use GeoToad you first have to enter your account information (you |
119 | don't need a premioum account!), the location you want to get geocache |
120 | information from and the size of the area you are interested |
121 | in. Please, start with an area of ~1km (0.6 mi) radius. Otherwise the |
122 | download may take rather long. You also have to select a place to |
123 | store the resulting file. You can choose any location, but it's |
124 | preferred to use a memory card to save precious root file system space |
125 | on a mobile device like the N900.<p> |
126 | |
127 | <center> |
128 | <img src="images/geotoad_setup.gif"><br> |
129 | <h5>Setup of GeoToad</h5> |
130 | </center> |
131 | |
132 | GeoToad is then invoked using the parameters you just entered.<p> |
133 | |
134 | <center> |
135 | <img src="images/geotoad_run_1.gif"><br> |
136 | <h5>Running GeoToad</h5> |
137 | </center> |
138 | |
139 | After a few seconds the first information should be returned and |
140 | GeoToad starts reporting what it receives from geocaching.com.<p> |
141 | |
142 | <center> |
143 | <img src="images/geotoad_run_2.gif"><br> |
144 | <h5>Search results are coming in</h5> |
145 | </center> |
146 | |
147 | Once geotoad is done it reports some statistics about its work and |
148 | GPXView tells you that the GeoToad job is done. |
149 | |
150 | <center> |
151 | <img src="images/geotoad_run_3.gif"><br> |
152 | <h5>GeoToad download is done</h5> |
153 | </center> |
154 | |
155 | You can now close the window and return to the main screen. You'll find that |
156 | the download has been added to the list of GPX files. |
157 | |
158 | <center> |
159 | <img src="images/geotoad_result_1.gif"><br> |
160 | <h5>The resulting file</h5> |
161 | </center> |
162 | |
163 | You can now use this file like any other GPX file you might have downloaded |
164 | from geocaching.com or similar sites. |
165 | |
166 | <center> |
167 | <img src="images/geotoad_result_2.gif"><br> |
168 | <h5>Caches downloaded by GeoToad</h5> |
169 | </center> |
170 | |
171 | </body> |
172 | </html> |
173 |