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