src/tim/prune/readme.txt

   1 GpsPrune version 20.2
   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-2021 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_20.2.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_20.2.jar --lang=DE
  29
  30
  31 New with version 20.2
  32 =====================
  33 The following fixes and additions were made since version 20.1:
  34   - Fix for intermittent startup problems
  35   - Addition of Swedish (erikiiofph7)
  36   - Allow four digits for adding day offsets (fperrin)
  37
  38 New with version 20.1
  39 =====================
  40 The following fixes and additions were made since version 20:
  41   - Starting with an empty map (fperrin)
  42   - Reading and writing <cmt> tags from gpx files (Willy)
  43   - Add option to use GTK look-and-feel (fperrin)
  44   - Translation updates (Carlos, Tche333)
  45   - Solve issue #29/973910 regarding missing tile cache (Peter Gervai)
  46   - Remove "Download SRTM" function and just do it automatically
  47   - Tweak waypoint icons
  48   - Fix problem with a recently-used file which has disappeared
  49   - Fix problem with moving / renaming downloaded tile files
  50
  51 New with version 20
  52 ===================
  53 The following fixes and additions were made since version 19:
  54   - Add option to use Nimbus look-and-feel (wishlist 77)
  55   - Extend the marker waypoints function to include half the distance, half the climb and half the descent
  56   - Remove Ukrainian language
  57   - Add support for entering Pluscodes
  58   - Add way to copy point details or range details to clipboard (wishlist 76)
  59   - Project point using bearing and distance (wishlist 35)
  60   - Possibility to paste a list of coordinates instead of just one
  61   - Removal of Gpsies functions (both download and upload)
  62
  63 New with version 19
  64 ===================
  65 The following fixes and additions were made since version 18:
  66   - Wikipedia search now also includes galleries from wikimedia
  67   - Photo popup window now gets updated when the track selection changes
  68   - Function to add waypoints along the track at intervals of distance or time (eg every 5 km)
  69   - Optionally draw arrows on the track lines to show direction of travel
  70   - Waypoint rendering using icons (wishlist 71)
  71   - Allow user to select timezone in which timestamps are displayed (wishlist 61)
  72   - Provide call to geonames.org's OSM node search function, to find amenities (like bus stops) close to the current point
  73   - Debian and Ubuntu packages no longer rely on external libmetadata jar
  74   - Keyboard shortcut to access point edit dialog (part of Github issue #10)
  75   - Online services Inlinemap.net and Graphhopper.com (routing)
  76   - Cardinals in java3d view get billboard behaviour to always face camera (thanks, PeHar)
  77   - Lighting of 3d views from the northwest (thanks, PeHar)
  78   - Remember the name tag from a loaded gpx file, suggest it again for gpx export
  79
  80 New with version 18
  81 ===================
  82 The following features were added since version 17:
  83   - New search options using opencaching.de and mapillary
  84   - New web options using peakfinder, geohack and panoramio
  85   - Autoplay function for automatically scrolling through the track
  86   - Marking uphill lift sections of skiing / snowboarding tracks
  87   - Configurable anti-aliasing for map view and profile view
  88   - Allow showing just the lines between track points but not the track points
  89
  90 New with version 17
  91 ===================
  92 The following features were added since version 16:
  93   - Colouring the track points according to various criteria (such as altitude,
  94     speed, segment, file) in both the regular map view and the image export
  95   - Marking points for deletion according to their date
  96   - Select the current segment
  97   - Adding an altitude tolerance to the climb and descent calculations
  98   - Sorting waypoints by name or by timestamp
  99
 100 New with version 16
 101 ===================
 102 The following features were added since version 15:
 103   - Extend povray output using terrain and/or map image
 104   - Extend java3d output using terrain and/or map image
 105   - Weather forecasts
 106   - Splitting a track into segments based on distance or time
 107   - Sewing track segments together
 108   - Function to download and save SRTM tiles
 109
 110 New with version 15
 111 ===================
 112 The following features were added since version 14:
 113   - Extend povray output using map image on base plane
 114   - Export an image of the map and track at a selected zoom level
 115   - Estimation of hiking times and learning of parameter values
 116   - Allow altitude / speed profile to show any arbitrary field
 117   - Accept files dragged and dropped onto the GpsPrune window
 118   - Take account of timezone if present in track timestamps
 119   - Allow timestamp exports in KML using gx extensions
 120   - GPSBabel filters
 121   - Improved wikipedia name lookup
 122   - Allow loading of speeds and vertical speeds from text files
 123
 124 New with version 14
 125 ===================
 126 The following features were added since version 13:
 127   - Dragging of existing points
 128   - Creation of new points by dragging the halfway point between two points
 129   - Nautical miles option including knots
 130   - Full range details dialog
 131   - Extension of interpolation function
 132   - Selecting points within a rectangle to delete
 133
 134 New with version 13
 135 ===================
 136 The following features were added since version 12:
 137   - Name change from Prune to GpsPrune
 138   - Handling of description field for waypoints
 139   - Opening of images from within kmz files, zip files and from http links
 140   - Compression using Douglas-Peucker algorithm
 141   - Option to save settings automatically on exit
 142   - Dialog to show the local tile cache, report sizes and allow deletion
 143     of tiles, either deleting whole tilesets or individual tiles older than
 144     a specified number of days
 145   - Checkbox on GPX export to specify UTF-8 rather than default system encoding
 146   - Importing of files through GPSBabel
 147   - List of recently used files in the menu
 148   - Display of bearing at which a photo was taken (display only)
 149   - Allow edit of custom map sources
 150   - Russian translation
 151
 152 New with version 12
 153 ===================
 154 The following features were added since version 11:
 155   - Options to load audio files, play them, connect to points and auto-correlate them
 156   - Extend Gpx export to include links to photos and audio files
 157   - Extend Gpx load to also load referenced photos, audio files
 158   - Function to search for places in Wikipedia by name
 159   - Function to search for places in Wikipedia near the current point
 160   - Function to download OSM data using the XAPI and save to osm file
 161   - New drawing mode to add points with one click each
 162   - Hungarian translations thanks to György
 163   - Korean translations thanks to HooAU
 164
 165 New with version 11
 166 ===================
 167 The following features were added since version 10:
 168   - Option to select which of the named tracks to load out of a gpx file or gps
 169   - Function to delete all values of a single field (eg all altitudes, all timestamps)
 170   - Export of 3d view to svg file
 171   - Function to upload current track to gpsies.com
 172   - Option to hide sidebars (left panel, right panel and lower panel) to just show map
 173   - Various bugfixes, especially with gpx export, track compression and scale bar
 174   - Dutch and Czech translations thanks to generous volunteers
 175
 176 New with version 10
 177 ===================
 178 The following features were added since version 9:
 179   - Function to lookup altitudes using SRTM data from the Space Shuttle
 180   - Choice between altitude profile and speed profile in main view
 181   - Caching of map tiles to disk for faster access
 182   - Offline mode where maps are only retrieved from disk
 183   - Storage of multiple custom map sources, not just one custom one
 184   - Use of maps with multiple layers (like maps-for-free)
 185   - Use of cloudmade maps
 186
 187 New with version 9
 188 ==================
 189 The following features were added since version 8:
 190   - Ability to paste coordinates (eg from wikipedia or geocaching sites) to create new points
 191   - Configurable colour settings
 192   - Function to convert waypoint names into timestamps
 193   - Function to reorganise and sort photos either by filename or time
 194   - Ability to load gzipped xml files
 195   - New "full range details" dialog including pace and average gradient
 196   - Preservation of unrecognised gpx tags by copying source xml
 197   - Improved photo handling and ability to rotate photos
 198   - Japanese, Portuguese and Turkish languages thanks to generous user input
 199
 200 New with version 8
 201 ==================
 202 The following features were added since version 7:
 203   - Loading of NMEA files (with suffix .nmea)
 204   - Loading of nearby tracks from gpsies.com
 205   - Function for finding waypoints by name
 206   - Language-sensitive keyboard shortcuts
 207   - Scale bar
 208   - Display of pace (time per km or time per mile)
 209   - Ability to display and save configuration settings
 210   - Configurable program paths and KMZ image sizes
 211   - Chinese language thanks to generous user input
 212
 213 New with version 7
 214 ==================
 215 The following features were added since version 6:
 216   - Loading of KMZ files and zipped GPX
 217   - Improved compression functions with four configurable algorithms
 218   - New function to call gpsbabel to send data directly to GPS receiver
 219   - Charting functions (eg altitude or speed against distance) using gnuplot
 220   - Map view can now use other OpenStreetMap images such as OpenCycleMap or any other tile server
 221   - New function to create an average position from a track section
 222   - Display of straight line distances between waypoints
 223
 224 New with version 6
 225 ==================
 226 The following features were added since version 5:
 227   - Map view using OpenStreetMap images is now integrated in the main window, with control for map transparency
 228   - Pov export has new option to use sphere sweeps for better appearance
 229   - New function to check online for a newer version of Prune
 230   - New function to take a section of track and cut/paste it to another position
 231   - New function to add or subtract a time offset from point timestamps
 232   - New function to call gpsbabel to load data directly from GPS receiver
 233   - Additional file filter options on load and save
 234   - Italian language thanks to generous user input
 235
 236 New with version 5
 237 ==================
 238 The following features were added since version 4:
 239   - New map window in the View menu, showing points overlaid on OpenStreetMap images
 240   - New function to launch a browser showing the area in either Google Maps or OpenStreetMap
 241   - Handling of track segments, including loading, saving and exporting, and preservation during edits and undos
 242   - New function to merge track segments for the current selection, to make one single segment
 243   - Display of current and average speed on details panel
 244   - Statusbar showing confirmation of actions
 245   - Much improved French texts thanks to generous user input
 246
 247 New with version 4
 248 ==================
 249 The following features were added since version 3:
 250   - Automatic correlation of photos with points based on timestamps
 251   - Manual disconnection of photos from points
 252   - Reading of photo thumbnails from exif data (speeds up photo loading)
 253   - Export to GPX format
 254   - KML and KMZ export now includes altitudes option for airborne tracks
 255   - Track points in map can be connected by lines
 256   - On loading a text file, fields are now guessed according to data or column headings
 257   - Polish language
 258
 259 New with version 3
 260 ==================
 261 The following features were added since version 2:
 262   - Loading of GPX and KML files
 263   - Loading of jpeg photos with or without coordinate data
 264   - Manual correlation of photos with points
 265   - Saving of coordinates in exif data of jpegs
 266   - Exporting to KMZ format including thumbnails of photos
 267   - Four-panel layout with toolbar
 268   - French language
 269
 270 New with version 2
 271 ==================
 272 The following features were added since version 1:
 273   - Display of data in 3d view using Java3D library
 274   - Export of 3d model to POV format for rendering by povray
 275   - Point edit dialog, waypoint name edit dialog
 276   - Waypoint list
 277   - Spanish language
 278
 279 Features of version 1
 280 =====================
 281 The following features were included in version 1:
 282   - Loading of text files, display in overhead and profile views
 283   - Display of track details such as distances, speeds
 284   - Deletion of points and ranges, and variable compression
 285   - Export to KML format
 286   - English, German and Swiss German languages
 287
 288
 289 Further information and updates
 290 ===============================
 291
 292 To obtain the source code (if it wasn't included in your jar file), or for further information,
 293 please visit the website:  https://gpsprune.activityworkshop.net/
 294
 295 You will find there user guides, screenshots and demo videos illustrating the major features.
 296 As GpsPrune is further developed, subsequent versions of the program will also be made freely
 297 available at this website.
 298
 299 You can also provide feedback on GpsPrune, and find out more about contributing to the development,
 300 especially with regard to language translations.