]> gitweb.fperrin.net Git - GpsPrune.git/blob - tim/prune/readme.txt
ccdc8cbebdf35897e79bba10fef58279183b5c0a
[GpsPrune.git] / tim / prune / readme.txt
1 Prune version 12
2 ================
3
4 Prune 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/prune/
7
8 Prune is copyright 2006-2010 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 Prune comes without warranty and without guarantee - the authors cannot be held responsible for
13 losses incurred through use of the program, however caused.
14
15
16 Running
17 =======
18
19 To run Prune from the jar file, simply call it from a command prompt or shell:
20    java -jar prune_12.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 prune_12.jar --lang=DE
29
30 New with version 12
31 ===================
32 The following features were added since version 11:
33   - Options to load audio files, play them, connect to points and auto-correlate them
34   - Extend Gpx export to include links to photos and audio files
35   - Extend Gpx load to also load referenced photos, audio files
36   - Function to search for places in Wikipedia by name
37   - Function to search for places in Wikipedia near the current point
38   - Function to download OSM data using the XAPI and save to osm file
39   - New drawing mode to add points with one click each
40   - Hungarian translations thanks to György
41   - Korean translations thanks to HooAU
42
43 New with version 11
44 ===================
45
46 The following features were added since version 10:
47   - Option to select which of the named tracks to load out of a gpx file or gps
48   - Function to delete all values of a single field (eg all altitudes, all timestamps)
49   - Export of 3d view to svg file
50   - Function to upload current track to gpsies.com
51   - Option to hide sidebars (left panel, right panel and lower panel) to just show map
52   - Various bugfixes, especially with gpx export, track compression and scale bar
53   - Dutch and Czech translations thanks to generous volunteers
54
55 New with version 10
56 ===================
57
58 The following features were added since version 9:
59   - Function to lookup altitudes using SRTM data from the Space Shuttle
60   - Choice between altitude profile and speed profile in main view
61   - Caching of map tiles to disk for faster access
62   - Offline mode where maps are only retrieved from disk
63   - Storage of multiple custom map sources, not just one custom one
64   - Use of maps with multiple layers (like maps-for-free)
65   - Use of cloudmade maps
66
67 New with version 9
68 ==================
69
70 The following features were added since version 8:
71   - Ability to paste coordinates (eg from wikipedia or geocaching sites) to create new points
72   - Configurable colour settings
73   - Function to convert waypoint names into timestamps
74   - Function to reorganise and sort photos either by filename or time
75   - Ability to load gzipped xml files
76   - New "full range details" dialog including pace and average gradient
77   - Preservation of unrecognised gpx tags by copying source xml
78   - Improved photo handling and ability to rotate photos
79   - Japanese, Portuguese and Turkish languages thanks to generous user input
80
81 New with version 8
82 ==================
83
84 The following features were added since version 7:
85   - Loading of NMEA files (with suffix .nmea)
86   - Loading of nearby tracks from gpsies.com
87   - Function for finding waypoints by name
88   - Language-sensitive keyboard shortcuts
89   - Scale bar
90   - Display of pace (time per km or time per mile)
91   - Ability to display and save configuration settings
92   - Configurable program paths and KMZ image sizes
93   - Chinese language thanks to generous user input
94
95 New with version 7
96 ==================
97
98 The following features were added since version 6:
99   - Loading of KMZ files and zipped GPX
100   - Improved compression functions with four configurable algorithms
101   - New function to call gpsbabel to send data directly to GPS receiver
102   - Charting functions (eg altitude or speed against distance) using gnuplot
103   - Map view can now use other OpenStreetMap images such as OpenCycleMap or any other tile server
104   - New function to create an average position from a track section
105   - Display of straight line distances between waypoints
106
107 New with version 6
108 ==================
109
110 The following features were added since version 5:
111   - Map view using OpenStreetMap images is now integrated in the main window, with control for map transparency
112   - Pov export has new option to use sphere sweeps for better appearance
113   - New function to check online for a newer version of Prune
114   - New function to take a section of track and cut/paste it to another position
115   - New function to add or subtract a time offset from point timestamps
116   - New function to call gpsbabel to load data directly from GPS receiver
117   - Additional file filter options on load and save
118   - Italian language thanks to generous user input
119
120 New with version 5
121 ==================
122
123 The following features were added since version 4.1:
124   - New map window in the View menu, showing points overlaid on OpenStreetMap images
125   - New function to launch a browser showing the area in either Google Maps or OpenStreetMap
126   - Handling of track segments, including loading, saving and exporting, and preservation during edits and undos
127   - New function to merge track segments for the current selection, to make one single segment
128   - Display of current and average speed on details panel
129   - Statusbar showing confirmation of actions
130   - Much improved French texts thanks to generous user input
131
132 New with version 4
133 ==================
134
135 The following features were added since version 3:
136   - Automatic correlation of photos with points based on timestamps
137   - Manual disconnection of photos from points
138   - Reading of photo thumbnails from exif data (speeds up photo loading)
139   - Export to GPX format
140   - KML and KMZ export now includes altitudes option for airborne tracks
141   - Track points in map can be connected by lines
142   - On loading a text file, fields are now guessed according to data or column headings
143   - Polish language
144
145 New with version 3
146 ==================
147
148 The following features were added since version 2:
149   - Loading of GPX and KML files
150   - Loading of jpeg photos with or without coordinate data
151   - Manual correlation of photos with points
152   - Saving of coordinates in exif data of jpegs
153   - Exporting to KMZ format including thumbnails of photos
154   - Four-panel layout with toolbar
155   - French language
156
157 New with version 2
158 ==================
159
160 The following features were added since version 1:
161   - Display of data in 3d view using Java3D library
162   - Export of 3d model to POV format for rendering by povray
163   - Point edit dialog, waypoint name edit dialog
164   - Waypoint list
165   - Spanish language
166
167 Features of version 1
168 =====================
169
170 The following features were included in version 1:
171   - Loading of text files, display in overhead and profile views
172   - Display of track details such as distances, speeds
173   - Deletion of points and ranges, and variable compression
174   - Export to KML format
175   - English, German and Swiss German languages
176
177
178 Further information and updates
179 ===============================
180
181 To obtain the source code (if it wasn't included in your jar file), or for further information,
182 please visit the website:  http://activityworkshop.net/
183
184 You will find there user guides, screenshots and demo videos illustrating the major features.
185 As Prune is further developed, subsequent versions of the program will also be made freely
186 available at this website.
187
188 You can also provide feedback on Prune, and find out more about contributing to the development,
189 especially with regard to language translations.