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