]> gitweb.fperrin.net Git - GpsPrune.git/blob - tim/prune/readme.txt
a66883fa2fbd202203cfd10e0230968d94a6cf0d
[GpsPrune.git] / tim / prune / readme.txt
1 GpsPrune version 13.4
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-2012 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_13.4.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_13.4.jar --lang=DE
29
30
31 New with version 13.4
32 =====================
33 The following features were added since version 13.3:
34   - Fix for empty settings
35   - Fix for file suffixes of cached tiles
36   - Removed Osma source as tiles@home has been discontinued
37
38 New with version 13.3
39 =====================
40 The following features were added since version 13.2:
41   - Completion of Italian translations
42   - Fix for exporting track names to version 1.1 gpx files
43   - Changed OpenCycleMap url
44   - Added diagnostics if unrecognised command-line parameter wasn't a valid file
45   - Improve error handling when tile downloading fails
46   - Fix for editing a cloudmade source
47
48 New with version 13.2
49 =====================
50 The following features were added since version 13.1:
51   - Russian translation
52   - Fix for loading kml with placemarks with multiple coordinate lists
53   - Fix for exporting descriptions to version 1.1 gpx files
54
55 New with version 13.1
56 =====================
57 The following features were added since version 13:
58   - Allow loading of photos and audio using relative paths from the gpx/kml file
59   - Cosmetic fixes to make the map controls more visible
60   - Allow osm-style map sources to use gifs or jpgs as well as pngs
61   - Allow edit of custom map sources
62   - Addition of a few more built-in map sources, such as hikebikemap and openseamap
63
64 New with version 13
65 ===================
66 The following features were added since version 12:
67   - Name change from Prune to GpsPrune
68   - Handling of description field for waypoints
69   - Opening of images from within kmz files, zip files and from http links
70   - Compression using Douglas-Peucker algorithm
71   - Option to save settings automatically on exit
72   - Dialog to show the local tile cache, report sizes and allow deletion
73     of tiles, either deleting whole tilesets or individual tiles older than
74     a specified number of days
75   - Checkbox on GPX export to specify UTF-8 rather than default system encoding
76   - Importing of files through GPSBabel
77   - List of recently used files in the menu
78   - Display of bearing at which a photo was taken (display only)
79
80 New with version 12
81 ===================
82 The following features were added since version 11:
83   - Options to load audio files, play them, connect to points and auto-correlate them
84   - Extend Gpx export to include links to photos and audio files
85   - Extend Gpx load to also load referenced photos, audio files
86   - Function to search for places in Wikipedia by name
87   - Function to search for places in Wikipedia near the current point
88   - Function to download OSM data using the XAPI and save to osm file
89   - New drawing mode to add points with one click each
90   - Hungarian translations thanks to György
91   - Korean translations thanks to HooAU
92
93 New with version 11
94 ===================
95
96 The following features were added since version 10:
97   - Option to select which of the named tracks to load out of a gpx file or gps
98   - Function to delete all values of a single field (eg all altitudes, all timestamps)
99   - Export of 3d view to svg file
100   - Function to upload current track to gpsies.com
101   - Option to hide sidebars (left panel, right panel and lower panel) to just show map
102   - Various bugfixes, especially with gpx export, track compression and scale bar
103   - Dutch and Czech translations thanks to generous volunteers
104
105 New with version 10
106 ===================
107
108 The following features were added since version 9:
109   - Function to lookup altitudes using SRTM data from the Space Shuttle
110   - Choice between altitude profile and speed profile in main view
111   - Caching of map tiles to disk for faster access
112   - Offline mode where maps are only retrieved from disk
113   - Storage of multiple custom map sources, not just one custom one
114   - Use of maps with multiple layers (like maps-for-free)
115   - Use of cloudmade maps
116
117 New with version 9
118 ==================
119
120 The following features were added since version 8:
121   - Ability to paste coordinates (eg from wikipedia or geocaching sites) to create new points
122   - Configurable colour settings
123   - Function to convert waypoint names into timestamps
124   - Function to reorganise and sort photos either by filename or time
125   - Ability to load gzipped xml files
126   - New "full range details" dialog including pace and average gradient
127   - Preservation of unrecognised gpx tags by copying source xml
128   - Improved photo handling and ability to rotate photos
129   - Japanese, Portuguese and Turkish languages thanks to generous user input
130
131 New with version 8
132 ==================
133
134 The following features were added since version 7:
135   - Loading of NMEA files (with suffix .nmea)
136   - Loading of nearby tracks from gpsies.com
137   - Function for finding waypoints by name
138   - Language-sensitive keyboard shortcuts
139   - Scale bar
140   - Display of pace (time per km or time per mile)
141   - Ability to display and save configuration settings
142   - Configurable program paths and KMZ image sizes
143   - Chinese language thanks to generous user input
144
145 New with version 7
146 ==================
147
148 The following features were added since version 6:
149   - Loading of KMZ files and zipped GPX
150   - Improved compression functions with four configurable algorithms
151   - New function to call gpsbabel to send data directly to GPS receiver
152   - Charting functions (eg altitude or speed against distance) using gnuplot
153   - Map view can now use other OpenStreetMap images such as OpenCycleMap or any other tile server
154   - New function to create an average position from a track section
155   - Display of straight line distances between waypoints
156
157 New with version 6
158 ==================
159
160 The following features were added since version 5:
161   - Map view using OpenStreetMap images is now integrated in the main window, with control for map transparency
162   - Pov export has new option to use sphere sweeps for better appearance
163   - New function to check online for a newer version of Prune
164   - New function to take a section of track and cut/paste it to another position
165   - New function to add or subtract a time offset from point timestamps
166   - New function to call gpsbabel to load data directly from GPS receiver
167   - Additional file filter options on load and save
168   - Italian language thanks to generous user input
169
170 New with version 5
171 ==================
172
173 The following features were added since version 4.1:
174   - New map window in the View menu, showing points overlaid on OpenStreetMap images
175   - New function to launch a browser showing the area in either Google Maps or OpenStreetMap
176   - Handling of track segments, including loading, saving and exporting, and preservation during edits and undos
177   - New function to merge track segments for the current selection, to make one single segment
178   - Display of current and average speed on details panel
179   - Statusbar showing confirmation of actions
180   - Much improved French texts thanks to generous user input
181
182 New with version 4
183 ==================
184
185 The following features were added since version 3:
186   - Automatic correlation of photos with points based on timestamps
187   - Manual disconnection of photos from points
188   - Reading of photo thumbnails from exif data (speeds up photo loading)
189   - Export to GPX format
190   - KML and KMZ export now includes altitudes option for airborne tracks
191   - Track points in map can be connected by lines
192   - On loading a text file, fields are now guessed according to data or column headings
193   - Polish language
194
195 New with version 3
196 ==================
197
198 The following features were added since version 2:
199   - Loading of GPX and KML files
200   - Loading of jpeg photos with or without coordinate data
201   - Manual correlation of photos with points
202   - Saving of coordinates in exif data of jpegs
203   - Exporting to KMZ format including thumbnails of photos
204   - Four-panel layout with toolbar
205   - French language
206
207 New with version 2
208 ==================
209
210 The following features were added since version 1:
211   - Display of data in 3d view using Java3D library
212   - Export of 3d model to POV format for rendering by povray
213   - Point edit dialog, waypoint name edit dialog
214   - Waypoint list
215   - Spanish language
216
217 Features of version 1
218 =====================
219
220 The following features were included in version 1:
221   - Loading of text files, display in overhead and profile views
222   - Display of track details such as distances, speeds
223   - Deletion of points and ranges, and variable compression
224   - Export to KML format
225   - English, German and Swiss German languages
226
227
228 Further information and updates
229 ===============================
230
231 To obtain the source code (if it wasn't included in your jar file), or for further information,
232 please visit the website:  http://activityworkshop.net/
233
234 You will find there user guides, screenshots and demo videos illustrating the major features.
235 As GpsPrune is further developed, subsequent versions of the program will also be made freely
236 available at this website.
237
238 You can also provide feedback on GpsPrune, and find out more about contributing to the development,
239 especially with regard to language translations.