tim/prune/readme.txt

   1 GpsPrune version 18.6
   2 =====================
   3
   4 GpsPrune is an application for viewing, editing and managing coordinate data from GPS systems,
   5 including format conversion, charting, 3d visualisation, audio and photo correlation, and online resource lookup.
   6 Full details can be found at https://gpsprune.activityworkshop.net/
   7
   8 GpsPrune is copyright 2006-2016 activityworkshop.net and distributed under the terms of the Gnu GPL version 2.
   9 You may freely use the software, and may help others to freely use it too.  For further information
  10 on your rights and how they are protected, see the included license.txt file.
  11
  12 GpsPrune comes without warranty and without guarantee - the authors cannot be held responsible
  13 for losses incurred through use of the program, however caused.
  14
  15
  16 Running
  17 =======
  18
  19 To run GpsPrune from the jar file, simply call it from a command prompt or shell:
  20    java -jar gpsprune_18.6.jar
  21
  22 If the jar file is saved in a different directory, you will need to include the path.
  23 Depending on your system settings, you may be able to click or double-click on the jar file
  24 in a file manager window to execute it.  A shortcut, menu item, alias, desktop icon
  25 or other link can of course be made should you wish.
  26
  27 To specify a language other than the default, use an additional parameter, eg:
  28    java -jar gpsprune_18.6.jar --lang=DE
  29
  30
  31 New with version 18.6
  32 =====================
  33 The following fix was made since version 18.5:
  34   - Change of URL for SRTM tiles, and recognise when downloaded file is too small to be valid
  35
  36 New with version 18.5
  37 =====================
  38 The following fixes and additions were made since version 18.4:
  39   - When points have no altitudes, send them to a GPS with altitude 0 (prevents weird values when reading back)
  40   - When points are not displayed on map, still colour the lines according to the selected scheme
  41   - When points all have crazy values, don't hang the profile chart
  42   - When images can't be fetched from the internet, don't delete expired cache images
  43   - Translation updates to es, uk, ru, cz
  44
  45 New with version 18.4
  46 =====================
  47 The following fixes and additions were made since version 18.3:
  48   - Updated GPSBabel format descriptions (thanks, Juergen!)
  49   - Removed calls to the retired opencaching.com site (thanks, Garmin!)
  50
  51 New with version 18.3
  52 =====================
  53 The following fixes and additions were made since version 18.2:
  54   - Fix for saving track names and descriptions containing ampersands in xml formats (thanks, Joe!)
  55   - Additional window icon sizes (thanks, Sebastic!)
  56   - Remember window size
  57
  58 New with version 18.2
  59 =====================
  60 The following fixes and additions were made since version 18.1:
  61   - Fix for saving point names containing ampersands in gpx, kml, kmz formats (thanks, Joe!)
  62   - Minor translation updates to nl, it, pl
  63
  64 New with version 18.1
  65 =====================
  66 The following fixes and additions were made since version 18:
  67   - Fix for duration rounding bug affecting sub-second timestamps
  68   - Wikipedia search now also includes galleries from wikimedia
  69   - Photo popup window now gets updated when the track selection changes
  70   - Small improvements to Ukrainian, Dutch translations
  71
  72 New with version 18
  73 ===================
  74 The following features were added since version 17:
  75   - New search options using opencaching.de and mapillary
  76   - New web options using peakfinder, geohack and panoramio
  77   - Autoplay function for automatically scrolling through the track
  78   - Marking uphill lift sections of skiing / snowboarding tracks
  79   - Configurable anti-aliasing for map view and profile view
  80   - Allow showing just the lines between track points but not the track points
  81
  82 New with version 17
  83 ===================
  84 The following features were added since version 16:
  85   - Colouring the track points according to various criteria (such as altitude,
  86     speed, segment, file) in both the regular map view and the image export
  87   - Marking points for deletion according to their date
  88   - Select the current segment
  89   - Adding an altitude tolerance to the climb and descent calculations
  90   - Sorting waypoints by name or by timestamp
  91
  92 New with version 16
  93 ===================
  94 The following features were added since version 15:
  95   - Extend povray output using terrain and/or map image
  96   - Extend java3d output using terrain and/or map image
  97   - Weather forecasts
  98   - Splitting a track into segments based on distance or time
  99   - Sewing track segments together
 100   - Function to download and save SRTM tiles
 101
 102 New with version 15
 103 ===================
 104 The following features were added since version 14:
 105   - Extend povray output using map image on base plane
 106   - Export an image of the map and track at a selected zoom level
 107   - Estimation of hiking times and learning of parameter values
 108   - Allow altitude / speed profile to show any arbitrary field
 109   - Accept files dragged and dropped onto the GpsPrune window
 110   - Take account of timezone if present in track timestamps
 111   - Allow timestamp exports in KML using gx extensions
 112   - GPSBabel filters
 113   - Improved wikipedia name lookup
 114   - Allow loading of speeds and vertical speeds from text files
 115
 116 New with version 14
 117 ===================
 118 The following features were added since version 13:
 119   - Dragging of existing points
 120   - Creation of new points by dragging the halfway point between two points
 121   - Nautical miles option including knots
 122   - Full range details dialog
 123   - Extension of interpolation function
 124   - Selecting points within a rectangle to delete
 125
 126 New with version 13
 127 ===================
 128 The following features were added since version 12:
 129   - Name change from Prune to GpsPrune
 130   - Handling of description field for waypoints
 131   - Opening of images from within kmz files, zip files and from http links
 132   - Compression using Douglas-Peucker algorithm
 133   - Option to save settings automatically on exit
 134   - Dialog to show the local tile cache, report sizes and allow deletion
 135     of tiles, either deleting whole tilesets or individual tiles older than
 136     a specified number of days
 137   - Checkbox on GPX export to specify UTF-8 rather than default system encoding
 138   - Importing of files through GPSBabel
 139   - List of recently used files in the menu
 140   - Display of bearing at which a photo was taken (display only)
 141   - Allow edit of custom map sources
 142   - Russian translation
 143
 144 New with version 12
 145 ===================
 146 The following features were added since version 11:
 147   - Options to load audio files, play them, connect to points and auto-correlate them
 148   - Extend Gpx export to include links to photos and audio files
 149   - Extend Gpx load to also load referenced photos, audio files
 150   - Function to search for places in Wikipedia by name
 151   - Function to search for places in Wikipedia near the current point
 152   - Function to download OSM data using the XAPI and save to osm file
 153   - New drawing mode to add points with one click each
 154   - Hungarian translations thanks to György
 155   - Korean translations thanks to HooAU
 156
 157 New with version 11
 158 ===================
 159 The following features were added since version 10:
 160   - Option to select which of the named tracks to load out of a gpx file or gps
 161   - Function to delete all values of a single field (eg all altitudes, all timestamps)
 162   - Export of 3d view to svg file
 163   - Function to upload current track to gpsies.com
 164   - Option to hide sidebars (left panel, right panel and lower panel) to just show map
 165   - Various bugfixes, especially with gpx export, track compression and scale bar
 166   - Dutch and Czech translations thanks to generous volunteers
 167
 168 New with version 10
 169 ===================
 170 The following features were added since version 9:
 171   - Function to lookup altitudes using SRTM data from the Space Shuttle
 172   - Choice between altitude profile and speed profile in main view
 173   - Caching of map tiles to disk for faster access
 174   - Offline mode where maps are only retrieved from disk
 175   - Storage of multiple custom map sources, not just one custom one
 176   - Use of maps with multiple layers (like maps-for-free)
 177   - Use of cloudmade maps
 178
 179 New with version 9
 180 ==================
 181 The following features were added since version 8:
 182   - Ability to paste coordinates (eg from wikipedia or geocaching sites) to create new points
 183   - Configurable colour settings
 184   - Function to convert waypoint names into timestamps
 185   - Function to reorganise and sort photos either by filename or time
 186   - Ability to load gzipped xml files
 187   - New "full range details" dialog including pace and average gradient
 188   - Preservation of unrecognised gpx tags by copying source xml
 189   - Improved photo handling and ability to rotate photos
 190   - Japanese, Portuguese and Turkish languages thanks to generous user input
 191
 192 New with version 8
 193 ==================
 194 The following features were added since version 7:
 195   - Loading of NMEA files (with suffix .nmea)
 196   - Loading of nearby tracks from gpsies.com
 197   - Function for finding waypoints by name
 198   - Language-sensitive keyboard shortcuts
 199   - Scale bar
 200   - Display of pace (time per km or time per mile)
 201   - Ability to display and save configuration settings
 202   - Configurable program paths and KMZ image sizes
 203   - Chinese language thanks to generous user input
 204
 205 New with version 7
 206 ==================
 207 The following features were added since version 6:
 208   - Loading of KMZ files and zipped GPX
 209   - Improved compression functions with four configurable algorithms
 210   - New function to call gpsbabel to send data directly to GPS receiver
 211   - Charting functions (eg altitude or speed against distance) using gnuplot
 212   - Map view can now use other OpenStreetMap images such as OpenCycleMap or any other tile server
 213   - New function to create an average position from a track section
 214   - Display of straight line distances between waypoints
 215
 216 New with version 6
 217 ==================
 218 The following features were added since version 5:
 219   - Map view using OpenStreetMap images is now integrated in the main window, with control for map transparency
 220   - Pov export has new option to use sphere sweeps for better appearance
 221   - New function to check online for a newer version of Prune
 222   - New function to take a section of track and cut/paste it to another position
 223   - New function to add or subtract a time offset from point timestamps
 224   - New function to call gpsbabel to load data directly from GPS receiver
 225   - Additional file filter options on load and save
 226   - Italian language thanks to generous user input
 227
 228 New with version 5
 229 ==================
 230 The following features were added since version 4:
 231   - New map window in the View menu, showing points overlaid on OpenStreetMap images
 232   - New function to launch a browser showing the area in either Google Maps or OpenStreetMap
 233   - Handling of track segments, including loading, saving and exporting, and preservation during edits and undos
 234   - New function to merge track segments for the current selection, to make one single segment
 235   - Display of current and average speed on details panel
 236   - Statusbar showing confirmation of actions
 237   - Much improved French texts thanks to generous user input
 238
 239 New with version 4
 240 ==================
 241 The following features were added since version 3:
 242   - Automatic correlation of photos with points based on timestamps
 243   - Manual disconnection of photos from points
 244   - Reading of photo thumbnails from exif data (speeds up photo loading)
 245   - Export to GPX format
 246   - KML and KMZ export now includes altitudes option for airborne tracks
 247   - Track points in map can be connected by lines
 248   - On loading a text file, fields are now guessed according to data or column headings
 249   - Polish language
 250
 251 New with version 3
 252 ==================
 253 The following features were added since version 2:
 254   - Loading of GPX and KML files
 255   - Loading of jpeg photos with or without coordinate data
 256   - Manual correlation of photos with points
 257   - Saving of coordinates in exif data of jpegs
 258   - Exporting to KMZ format including thumbnails of photos
 259   - Four-panel layout with toolbar
 260   - French language
 261
 262 New with version 2
 263 ==================
 264 The following features were added since version 1:
 265   - Display of data in 3d view using Java3D library
 266   - Export of 3d model to POV format for rendering by povray
 267   - Point edit dialog, waypoint name edit dialog
 268   - Waypoint list
 269   - Spanish language
 270
 271 Features of version 1
 272 =====================
 273 The following features were included in version 1:
 274   - Loading of text files, display in overhead and profile views
 275   - Display of track details such as distances, speeds
 276   - Deletion of points and ranges, and variable compression
 277   - Export to KML format
 278   - English, German and Swiss German languages
 279
 280
 281 Further information and updates
 282 ===============================
 283
 284 To obtain the source code (if it wasn't included in your jar file), or for further information,
 285 please visit the website:  http://gpsprune.activityworkshop.net/
 286
 287 You will find there user guides, screenshots and demo videos illustrating the major features.
 288 As GpsPrune is further developed, subsequent versions of the program will also be made freely
 289 available at this website.
 290
 291 You can also provide feedback on GpsPrune, and find out more about contributing to the development,
 292 especially with regard to language translations.