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