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