[gpxview] Diff of /www/index.html

Diff of /www/index.html

Parent Directory | Revision Log | View Patch Patch

-revision 275 by harbaum,
Wed May 19 15:09:39 2010 UTC
+revision 279 by harbaum,
Fri May 21 14:12:36 2010 UTC
 Line 12
  <center><h1>GPXView - Geocaching with Maemo</h1></center>
  <center>Till Harbaum <a href="mailto:till@harbaum.org">&lt;till@harbaum.org&gt;</a></center><p>
+ <center><a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=7400558"><img src="images/paypal.png" border="0"></a></center><p>
  GPXView is a <a href="http://geocaching.com">geocaching</a>
  application.  Its main purpose is to work with <a
  href="http://www.geocaching.com/pocket/">pocket queries</a> in GPX
-Line 25 
 based voice navigation and a built-in ma
+Line 27 
 based voice navigation and a built-in ma
  GPXView supports online download of geocaches using
  <a href="#geotoad">geotoad</a>. This even works without a premium
- account!
+ account!<p>
+ GPXView can guide you by <a href="#voicenav">voice</a> so you can
+ concentrate on your search while the device sits in your pocket.<p>
  <h2>Obtaining GPXView</h2>
-Line 45 
 The latest N810/N800 version is availabl
+Line 50 
 The latest N810/N800 version is availabl
  The N900 version is available from the extras repository and can be
  installed from the Navigation section in the Application Manager on
  that device. However, since there's a review process involved in
- getting software into the repective repositories and since the review
+ getting software into the respective repositories and since the review
  process for the N900 is rather slow, it may take some time for the
  latest version to show up on your device.<p>
  <center><img src="images/cachelist.gif"><h5>GPXView on N900</h5></center>
- There is no pre-packaged version for the Linux desktop. In order to install
+ There is no pre-packaged version for the Linux desktop. In order to
- GPXView on a desktop PC you'll have to download the <a href="http://repository.maemo.org/extras-devel/pool/diablo/free/source/g/gpxview/">source code</a>
+ install GPXView on a desktop PC you'll have to download the <a
- and compile and install it yourself.<p>
+ href="http://repository.maemo.org/extras-devel/pool/diablo/free/source/g/gpxview/">source code</a> and compile and install it yourself.<p>
  <center><img src="images/desktop.gif"><h5>GPXView on Ubuntu Linux</h5></center>
-Line 84 
 device like e.g. the memory card on your
+Line 89 
 device like e.g. the memory card on your
  in ZIP format from geocaching.com can be left compressed. GPXView will
  uncompress them automatically.<p>
+ You can copy the files onto the device via USB. But you might as well
+ just receive the files via Email directly on the device without any
+ PC involved.<p>
+ Finally you might use <a href="#geotoad">geotoad</a> to download cache
+ data directly.<p>
  <h3><a name="gpxlist">The GPX list view</a></h3>
  To import such files into GPXView you need to start GPXView and
-Line 93 
 session has two active GPX files and a c
+Line 105 
 session has two active GPX files and a c
  <center><img src="images/gpxlist.gif"><h5>GPX list</h5></center>
+ You can adjust details of this list and enable and disable selected
+ columns in the <a href="#settings">settings dialog</a>.<p>
  These GPX list will be loaded whenever you restart GPXView. Since
  these files may contain plenty caches, loading them may take a few
  seconds. While loading you'll see a progress bar.<p>
-Line 115 
 containing cache files are not imported
+Line 130 
 containing cache files are not imported
  the Search function and are not displayed on the map. To reenable a closed
  entry just select it.<p>
+ <h4>Importing entire directories</h4>
+ GPX files derived from pocket queries usually contain many geocaches
+ and it makes sense to maintain them as one big object in the main
+ view. But some GPX files only contain a single geocache and you might
+ have many of those seperate files stored on your device. To cope with
+ such a collection of single GPX files, GPXView provides the "Import
+ directory" feature. This collects all GPX files from a given directory
+ and treats them like one big GPX file.<p>
+ <h3><a name="cachelist">The cache list view</a></h3>
+ When you select a GPX file in the <a href="#gpxlist">GPX list
+ view</a>, you'll be forwarded to the cache list view. This view lists
+ all geocaches of the selected GPX file sorted by distance from your
+ current GPS coordinate.<p>
+ <center><img src="images/cachelist.gif">
+ <h5>The cache list view</h5></center>
+ You can adjust details of this list and enable and disable selected
+ columns in the <a href="#settings">settings dialog</a>.<p>
+ Little markers at the cache icon will give you additional info
+ about the cache:
+ <ul>
+ <li><img src="images/cache_type_ovl_found.png"> indicates that a cache has been marked as "found" by you or has a log from you in the GPX file
+ <li><img src="images/cache_type_ovl_mine.png"> indicates that a cache has been placed by you
+ <li><img src="images/cache_type_ovl_override.png"> indicates that you've overridden the coordinate of that cache
+ <li><img src="images/cache_type_ovl_note.png"> indicates that you've entered notes into the note tab of the cache view
+ </ul>
+ The cache list also tells you how far in which direction a cache
+ is. This of course changes when your position changes. GPXView can
+ thus update the cachelist periodically. This can be adjusted in the
+ <a href="#settings">settings</a>.<p>
+ <h2><a name="cacheview">The cache view</a></h2>
+ Selecting a cache in the <a href="#cachelist">cache list</a> will
+ forward you to the main screen of the cache view.<p>
+ If the <a href="#map">map window</a> is open at the time you select
+ a cache, then the map switches into navigation mode and e.g. a compass
+ rose will be displayed for the selected cache.<p>
+ <h3><a name="cachemain">Cache main view</a></h2>
+ The main view gives you a quick overview of the most important
+ aspects of a geocache. Among this information is the difficulty
+ and the terrain rating and of course the main coordinate.<p>
+ <center><img src="images/cache_main.gif">
+ <h5>Cache main view</h5></center>
+ This coordinate is displayed striked out if it was overridden on the
+ <a href="#cachegoto">goto page</a>. You'll also find various
+ informantion placed on buttons which are linked to the internet
+ browser. The waypoint id button will e.g. open the caches description
+ in the web browser.<p>
+ <h3><a name="cachedesc">Cache description view</a></h2>
+ The cache description usually contains the main part of the cache.
+ It's the important part when solving multi caches or mystery caches.
+ This description often comes in HTML format as it may contain all
+ kind of text formatting, tables, images etc ...<p>
+ <center><img src="images/cache_desc.gif">
+ <h5>Cache description view</h5></center>
+ Images are usually not part of the GPS file itself. Instead the
+ description text is in HTML format and contains references to
+ the actual images stored somewhere on the internet. When being
+ asked to display such a description, GPXView downloads the images
+ and stores them internally for further usage. So once you had a
+ working internet connection while reading a cache description
+ and the images successfully got loaded everything is stored on
+ device. And the images are available to you afterwards in the field
+ even without internet connection.<p>
+ <h3><a name="cachehint">Cache hint view</a></h2>
+ The hint is displayed in the typical encrypted form. Just click
+ the encrypt and decrypt buttons to toggle between the encrypted
+ and decrypted display,<p>
+ <center><img src="images/cache_hint.gif">
+ <h5>Cache hint view</h5></center>
+ In some cases (e.g. in GPX files from opencaching.com) the hints
+ are tagged as html text or actually are encoded in html. In this
+ case GPXView is unable to encrypt the text. The hint tab will then
+ just display the decoded plain text.<p>
+ <h3><a name="cachelog">Cache log view</a></h2>
+ Pocket query in GPX format usually contains the last 5 logs. If you
+ have found this cache and logged it, your log is included regardless
+ how recent it is. GPXView uses this fact to determine whether you
+ found a cache. In order to make this feature work, your username must
+ be specified in the <a href="#settings">settings</a>.<p>
+ <center><img src="images/cache_logs.gif">
+ <h5>Cache log view</h5></center>
+ If the geocaching id of the cache is known, GPXView is able to
+ create a browser button on top of the log view. Clicking this button
+ will open the browser with the appropriate log page for convenient
+ logging.<p>
+ <h3><a name="cachewpts">Cache waypoints view</a></h2>
+ Some caches contain additional waypoints. These are only included
+ in GPX files if they actually contain a valid coordinate (unlike e.g.
+ the stages of a multi cache which don't come with valid coordinates
+ as you are supposed to determine the coordinates yourself).<p>
+ <center><img src="images/cache_wpts.gif">
+ <h5>Cache waypoints view</h5></center>
+ When the selected cache has waypoints, these are also displayed
+ on the <a href="#map">map</a>.<p>
+ <h3><a name="cachetbs">Cache travelbug view</a></h2>
+ <a href="http://www.geocaching.com/track/">Travelbug or geocoin</a>
+ information stored in the GPX file is also parsed.<p>
+ <center><img src="images/cache_tbs.gif">
+ <h5>Cache travelbug view</h5></center>
+ If GPXView is able to create a valid internet link for a travelbug
+ or goicoin the id will be displayed on a button. Clicking that
+ button will open the browser with the travelbugs homepage.<p>
+ <h3><a name="cachenotes">Cache notes view</a></h2>
+ The notes view is special in a way that it does not display
+ informantion from the GPX file. Instead it's meant to store
+ information that you enter manually. You might e.g. use the notes
+ page to solve a mystery cache or store your findings while solving
+ a multi cache.<p>
+ <center><img src="images/cache_notes.gif">
+ <h5>Cache notes view</h5></center>
+ <a name="overwritten">The cache notes page contains a <a
+ href="#coordinate_tool">coordinate tool</a>.</a> An alternative
+ ("new") coordinate entered here (e.g. a solved mystery position or a
+ multi cache state). This can be used to overwrite the original one if
+ the "override" checkbox is enabled. This overridden coordinate will
+ then always be used instead of the original one.Icons derived from the
+ overridden cache position are overlayed by the <img
+ src="images/cache_type_ovl_overwritten.gif"> marker.<p>
+ You can also mark the cache as "found" here. Found caches can then be
+ found in the <a href="#search">search dialog</a> or exported in
+ the <a href="#export_garmin_fnote">garmin field notes</a> or
+ <a href="#export_garmin_wpt">garmin waypoints</a>.<p>
+ All user generated content on this page is stored permanently on
+ the device. This data is <b>not</b> stored inside the GPX files.
+ You may at any time update or replace GPX files without affecting
+ the contents of the notes pages.<p>
+ <h3><a name="cachegoto">Cache goto view</a></h2>
+ The goto view helps you navigating to a geocache. It contains a compass
+ rose that is adjusted to your walking direction (the compass damping may
+ need adjustment in the <a href="#settings">settings</a>). Furthermore
+ the compass needle always points to the geocache.<p>
+ <center><img src="images/cache_goto.gif">
+ <h5>Cache goto view</h5></center>
+ Due to a lack of a real magnetic compass, GPXView needs to use the
+ GPS signal to determine your heading. This only works while you are
+ moving. And it works better if you are miving fast and in a straight
+ line. These conditions are usually not given when approaching the
+ cache on the last few meters. Once you are moving too slow for the
+ heading detection to work reliably, you can lock the compass in place
+ by tapping it. You'll then need some other means to determine where
+ north it. As long as you still know this, you can adjust the device
+ accordingly and the compass needle will still point to the geocache.<p>
+ <a name="voicenav">Another advanced feature is the voice
+ navigation</a>.  The small speaker icon <img src="images/speaker.png">
+ allows you to enable an accoustic distance announcement. This way you
+ don't need to look at the device all the time and the device will keep
+ you informed about the distance to the cache.<p>
  <h2><a name="coordinate_tool">Coordinate tool</a></h2>
  Whenever GPXView deals with coordinates it will use the coordinate
-Line 135 
 buttons.</a><p>
+Line 343 
 buttons.</a><p>
  <h5>The coordinate picker</h5></center>
  The coordinate picker is designed for finger friendlyness and allows
- you to enter coordinates without using a keyboard. Similar picker
+ you to enter coordinates without using a keyboard.<p>
- also exist for distances<p>
- <center><img src="images/distance_picker.gif">
- <h5>The distance picker</h5></center>
- and directions (angles).<p>
- <center><img src="images/direction_picker.gif">
- <h5>The direction picker</h5></center>
  You can also import one of the various coordinates GPXView already
  knows. In order to do this you just habe to click the coordinate
-Line 163 
 Possible sources include:
+Line 362 
 Possible sources include:
  <li><img src="images/pos_wpt.png"> Additional waypoints stored in the <a href="#settings">settings</a>
  <li><img src="images/pos_map.png"> The current <a href="#map">map</a> position
  <li><img src="images/pos_geomath.png"> The current <a href="#geomath">geomath projection</a>
- <li><img src="images/cache_type_traditional.png">, <img src="images/cache_type_multi.png">, ... The current caches coordinate and the <a href="#overwritten">overwritten one</a> if present
+ <li><img src="images/cache_type_traditional.png">, <img src="images/cache_type_multi.png">, ... The current caches coordinate and the <a href="#overwritten">overridden one</a> if present
- <li><img src="images/wpt_parking.png">, <img src="images/wpt_refpoint.png">, ... The current caches <a href="#waypoints">waypoints</a> if present
+ <li><img src="images/wpt_parking.png">, <img src="images/wpt_refpoint.png">, ... The current caches <a href="#cachewpts">waypoints</a> if present
  </ul>
  In some occasions also a export button <img src="images/pos_set.png"> is present. This button opens the coordinate export tool.<p>
-Line 180 
 Up to three choices may be present here:
+Line 379 
 Up to three choices may be present here:
  <li><img src="images/clipboard.png"> Copy the coordinate to the clipboard
  </ul>
+ <a name="distance_picker">Similar pickers also exist for distances<p>
+ <center><img src="images/distance_picker.gif">
+ <h5>The distance picker</h5></center></a>
+ <a name="direction_picker">and directions (angles).<p>
+ <center><img src="images/direction_picker.gif">
+ <h5>The direction picker</h5></center></a>
  <h2>Main Menu</h2>
  The main menu can be reached from the main screen (and e.g. not
-Line 189 
 main screen is in "GPX list" mode.<p>
+Line 398 
 main screen is in "GPX list" mode.<p>
  <center><img src="images/menu.gif"><h5>The main menu</h5></center>
+ <h3><a name="about">About</a></h3>
+ The first thing selectable from the menu is the about dialog. The main
+ about screen will tell you version and comppile time. This is the way
+ to check whether you have the latest version of GPSView running.<p>
+ <center><img src="images/about_main.gif"><h5>Main about view</h5></center>
+ GPXView comes free of charge. You can install it on any device you want.
+ If you think you want to show your appreciation, you are welcome to
+ make a <a href="https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=7400558">little donation via paypal</a>.<p>
+ <center><img src="images/about_donate.gif"><h5>Donations are appreciated</h5></center>
+ You may also actively contribute to the project by reporting bugs or
+ filing feature requests.<p>
+ <center><img src="images/about_bugs.gif"><h5>You can contribute</h5></center>
  <h3><a name="settings">Settings</a></h3>
  The settings dialog contains various global settings. Any change
-Line 266 
 disabled.<p>
+Line 494 
 disabled.<p>
  <h4>Cache compass damping</h4>
- The compass in the caches <a href="#goto">goto view</a> uses
+ The compass in the caches <a href="#cachegoto">goto view</a> uses
  track information from the GPS signal to determine the
  heading in order to re-create the functionality of a
  magnetic compass. Depending on the precision of the GPS
-Line 287 
 already displayed by default.<p>
+Line 515 
 already displayed by default.<p>
  <h4>Disable screen saver in goto view</h4>
- Since the <a href="#goto">goto view</a> can be used to navigate to the
+ Since the <a href="#cachegoto">goto view</a> can be used to navigate to the
  cache, it may be handy to keep the screen on all the time.  Be aware
  that this may drain your battery if you leave the device for a longer
  period in this mode with the goto view active.<p>
- <h3>Tools Submenu</h3>
+ <h3><a name="export">Export</a></h3>
+ GPXView can export data for use with other devices or applications.
+ <center><img src="images/export.gif"><h5>Export</h5></center>
+ The export submenu lets you select the application you want to export data
+ to.<p>
+ <center><img src="images/export_mmpoi.gif"><h5>Export to Maemo Mapper POI</h5></center>
+ <a
+ href="http://maemo.org/downloads/product/OS2008/maemo-mapper/">Maemo
+ Mapper</a> is a popular mapping solution for maemo. GPXView can export
+ geocache locations as points of interest (POI) directly into a
+ database as use by Maemo Mapper. Selecting this database in Maemo
+ Mapper will make it display geocaches locations in its map. Since the
+ database export is rather slow, you might limit the radius around your
+ current GPS position, You can also prevent caches to be exported that
+ you already found or that are disabled or archived to further reduce
+ the number of exported caches.<p>
+ <a name="export_garmin_fnote">
+ <center><img src="images/export_garmin_fnote.gif"><h5>Export garmin field notes</h5></center>
+ GPXView is able to export so-called <a
+ href="http://www.geocaching.com/my/fieldnotes.aspx">Garmin field
+ notes</a>. These are files containing information about all caches you
+ have marked as found. Also the text from the notes page of each found
+ cache is included. You can upload the resulting file via the <a
+ href="http://www.geocaching.com/my/uploadfieldnotes.aspx">upload page
+ at geocaching.com</a>. Afterwards you can conveniently log all the
+ caches.<p></a>
+ <a name="export_garmin_wpt">
+ <center><img src="images/export_garmin_wpt.gif"><h5>Export Garmin waypoints</h5></center>
+ GPXView can export waypoints of <a href="#overwritten">overridden
+ coordinates</a> into a file suitable for use on garmin handheld gps
+ devices (tested with Garmin Colorado and Garmin Oregon devices). This
+ way you can transfer the coordintes of solved mystery caches or stages
+ of a multi cache to those Garmin handhelds.<p>
+ </a>
+ <h3><a name="search">Search</a></h3>
+ The number of geocaches stored on your device may grow very fast. The
+ search feature allows you to search through all of the currently
+ active GPX files and to search for particular text fragements in the
+ caches name, description etc.<p>
+ <center><img src="images/search.gif"><h5>The search dialog</h5></center>
+ You can also search for caches that you found within the last few
+ days.  This may be handy when logging at home and is meant to help you
+ remember which geocaches you've found recently.<p>
+ <h3><a name="tools">Tools Submenu</a></h3>
  The tools submenu is reached via the main menu. It can be used to
  invoke various geocaching related tools. The tools act as if they were
-Line 303 
 typically import or export data to or fr
+Line 588 
 typically import or export data to or fr
  <h4><name="geomath">Geomath</a></h4>
- <center><img src="images/geomath.gif"><h5>The Geomath tool</h5></center>
+ The geomath tool allows very basic geocoordinate calculations.  Two <a
+ href="#coordinate_tool">coordinates</a> can be entered as well as a <a
+ href="#distance_picker">distance</a> and a <a
+ href="#direction_picker">direction</a>.<p>
- The geomath tool allows very basic geocoordinate calculations.
+ <center><img src="images/geomath.gif"><h5>The Geomath tool</h5></center>
- Two coordinates can be entered into it as well as a distance and
- a direction angle.<p>
  Clicking the "Calculate" button calculates the distance between
  the two given coordinates and projects the first coordinate (on the
-Line 336 
 to e.g. walk another distance in another
+Line 622 
 to e.g. walk another distance in another
  <h4>Geotext</h4>
- <center><img src="images/geotext.gif"><h5>The Geotext tool</h5></center>
  The geotext tool allows two simple text operations often required to solve
  a geocache. Many geocaches ask you to calculate the letter sum of a certain
- text or word. Just enter this word into geotext and the character sum
+ text or word.<p>
+ <center><img src="images/geotext.gif"><h5>The Geotext tool</h5></center>
+ Just enter this word into geotext and the character sum
  is being displayed while you type. Another common operation is the "shift"
  letters. If you shift the letter "a" by one you get the next letter "b" (and
  "z" becomes "a" again). If you shift by two "a" becomes "c" and so on. This
-Line 350 
 on the geocaching.com website to encrypt
+Line 638 
 on the geocaching.com website to encrypt
  <h4>Precise Position</h4>
+ The Precise Position is more for the hider than for the seeker. It is
+ supposed to be used when standing still. It allows you to average the
+ current position over some longer period of time.<p>
  <center><img src="images/precise_position.gif">
  <h5>The Precise Position tool</h5></center>
- The Precise Position is more for the hider than for the seeker. It is
+  The tool will also
- supposed to be used when standing still. It allows you to average the
- current position over some longer period of time. The tool will also
  show you graphically how far all the positions received so far are
  apart to give you an impression how precise the position really
  is. The more coordinates you get and the smaller the radius of the

 Legend:



Removed from v.275
 


changed lines


 
Added in v.279
 Legend:



Removed from v.275
 


changed lines


 
Added in v.279
-Removed from v.275
+Added in v.279