1 package tim.prune.config;
4 import java.io.FileInputStream;
5 import java.util.Properties;
7 import tim.prune.data.RecentFileList;
8 import tim.prune.data.UnitSet;
9 import tim.prune.data.UnitSetLibrary;
10 import tim.prune.gui.colour.ColourerFactory;
11 import tim.prune.gui.colour.PointColourer;
12 import tim.prune.gui.map.MapSourceLibrary;
16 * Abstract class to hold application-wide configuration
18 public abstract class Config
20 /** File from which Config was loaded */
21 private static File _configFile = null;
23 /** Hashtable containing all config values */
24 private static Properties _configValues = null;
25 /** Colour scheme object is also part of config */
26 private static ColourScheme _colourScheme = new ColourScheme();
27 /** Point colourer object, if any */
28 private static PointColourer _pointColourer = null;
29 /** Recently-used file list */
30 private static RecentFileList _recentFiles = new RecentFileList();
31 /** Current unit set */
32 private static UnitSet _unitSet = UnitSetLibrary.getUnitSet(null);
34 /** Default config file */
35 public static final File DEFAULT_CONFIG_FILE = new File(".pruneconfig");
36 public static final File HOME_CONFIG_FILE = new File(System.getProperty("user.home"), ".pruneconfig");
38 /** Key for track directory */
39 public static final String KEY_TRACK_DIR = "prune.trackdirectory";
40 /** Key for photo directory */
41 public static final String KEY_PHOTO_DIR = "prune.photodirectory";
42 /** Key for language code */
43 public static final String KEY_LANGUAGE_CODE = "prune.languagecode";
44 /** Key for language file */
45 public static final String KEY_LANGUAGE_FILE = "prune.languagefile";
46 /** Key for GPS device */
47 public static final String KEY_GPS_DEVICE = "prune.gpsdevice";
48 /** Key for GPS format */
49 public static final String KEY_GPS_FORMAT = "prune.gpsformat";
50 /** Key for GPSBabel filter string */
51 public static final String KEY_GPSBABEL_FILTER = "prune.gpsbabelfilter";
52 /** Key for GPSBabel import file format */
53 public static final String KEY_IMPORT_FILE_FORMAT = "prune.lastimportfileformat";
54 /** Key for Povray font */
55 public static final String KEY_POVRAY_FONT = "prune.povrayfont";
56 /** Key for the selected unit set */
57 public static final String KEY_UNITSET_KEY = "prune.unitsetkey";
58 /** Key for the selected coordinate display format */
59 public static final String KEY_COORD_DISPLAY_FORMAT = "prune.coorddisplay";
60 /** Key for index of map source */
61 public static final String KEY_MAPSOURCE_INDEX = "prune.mapsource";
62 /** Key for number of fixed map sources */
63 public static final String KEY_NUM_FIXED_MAPS = "prune.numfixedmapsources";
64 /** Key for String containing custom map sources */
65 public static final String KEY_MAPSOURCE_LIST = "prune.mapsourcelist";
66 /** Key for show map flag */
67 public static final String KEY_SHOW_MAP = "prune.showmap";
68 /** Key for window position */
69 public static final String KEY_WINDOW_BOUNDS = "prune.windowbounds";
70 /** Key for path to disk cache */
71 public static final String KEY_DISK_CACHE = "prune.diskcache";
72 /** Key for working online flag */
73 public static final String KEY_ONLINE_MODE = "prune.onlinemode";
74 /** Key for width of thumbnails in kmz */
75 public static final String KEY_KMZ_IMAGE_SIZE = "prune.kmzimagewidth";
76 /** Key for gpsbabel path */
77 public static final String KEY_GPSBABEL_PATH = "prune.gpsbabelpath";
78 /** Key for gnuplot path */
79 public static final String KEY_GNUPLOT_PATH = "prune.gnuplotpath";
80 /** Key for exiftool path */
81 public static final String KEY_EXIFTOOL_PATH = "prune.exiftoolpath";
82 /** Key for colour scheme */
83 public static final String KEY_COLOUR_SCHEME = "prune.colourscheme";
84 /** Key for point colourer */
85 public static final String KEY_POINT_COLOURER = "prune.pointcolourer";
86 /** Key for line width used for drawing */
87 public static final String KEY_LINE_WIDTH = "prune.linewidth";
88 /** Key for whether to use antialiasing or not */
89 public static final String KEY_ANTIALIAS = "prune.antialias";
90 /** Key for kml track colour */
91 public static final String KEY_KML_TRACK_COLOUR = "prune.kmltrackcolour";
92 /** Key for window style (name of look-and-feel) */
93 public static final String KEY_WINDOW_STYLE = "prune.windowstyle";
94 /** Key for autosaving settings */
95 public static final String KEY_AUTOSAVE_SETTINGS = "prune.autosavesettings";
96 /** Key for recently used files */
97 public static final String KEY_RECENT_FILES = "prune.recentfiles";
98 /** Key for estimation parameters */
99 public static final String KEY_ESTIMATION_PARAMS = "prune.estimationparams";
100 /** Key for 3D exaggeration factor */
101 public static final String KEY_HEIGHT_EXAGGERATION = "prune.heightexaggeration";
102 /** Key for terrain grid size */
103 public static final String KEY_TERRAIN_GRID_SIZE = "prune.terraingridsize";
104 /** Key for altitude tolerance */
105 public static final String KEY_ALTITUDE_TOLERANCE = "prune.altitudetolerance";
106 /** Key for waypoint icons to use */
107 public static final String KEY_WAYPOINT_ICONS = "prune.waypointicons";
108 /** Size of waypoint icons to use */
109 public static final String KEY_WAYPOINT_ICON_SIZE = "prune.waypointiconsize";
110 /** Id of selected timezone */
111 public static final String KEY_TIMEZONE_ID = "prune.timezoneid";
112 /** Last used latlon range */
113 public static final String KEY_LATLON_RANGE = "prune.latlonrange";
114 /** Username/password to the Earthdata server for SRTM 1-arcsecond tiles */
115 public static final String KEY_EARTHDATA_AUTH = "prune.earthdataauth";
118 /** Initialise the default properties */
121 _configValues = getDefaultProperties();
125 * Load the default configuration file
127 public static void loadDefaultFile()
129 if (DEFAULT_CONFIG_FILE.exists())
132 loadFile(DEFAULT_CONFIG_FILE);
135 catch (ConfigException ce) {} // ignore
137 if (HOME_CONFIG_FILE.exists())
140 loadFile(HOME_CONFIG_FILE);
142 catch (ConfigException ce) {} // ignore
148 * Load configuration from file
149 * @param inFile file to load
150 * @throws ConfigException if specified file couldn't be read
152 public static void loadFile(File inFile) throws ConfigException
154 // Start with default properties
155 Properties props = getDefaultProperties();
156 // Try to load the file into a properties object
157 boolean loadFailed = false;
158 FileInputStream fis = null;
161 fis = new FileInputStream(inFile);
164 catch (Exception e) {
168 if (fis != null) try {
171 catch (Exception e) {}
173 // Save all properties from file
174 _configValues.putAll(props);
175 _colourScheme.loadFromHex(_configValues.getProperty(KEY_COLOUR_SCHEME));
176 _pointColourer = ColourerFactory.createColourer(_configValues.getProperty(KEY_POINT_COLOURER));
177 _recentFiles = new RecentFileList(_configValues.getProperty(KEY_RECENT_FILES));
178 _unitSet = UnitSetLibrary.getUnitSet(_configValues.getProperty(KEY_UNITSET_KEY));
179 // Adjust map source index if necessary
181 // Reset coord display format
182 setConfigInt(KEY_COORD_DISPLAY_FORMAT, 0);
185 throw new ConfigException();
187 // Store location of successfully loaded config file
188 _configFile = inFile;
192 * @return Properties object containing default values
194 private static Properties getDefaultProperties()
196 Properties props = new Properties();
198 props.put(KEY_GPS_DEVICE, "usb:");
199 props.put(KEY_GPS_FORMAT, "garmin");
200 props.put(KEY_POVRAY_FONT, "crystal.ttf"); // alternative: DejaVuSans-Bold.ttf
201 props.put(KEY_SHOW_MAP, "0"); // hide by default
202 props.put(KEY_EXIFTOOL_PATH, "exiftool");
203 props.put(KEY_GNUPLOT_PATH, "gnuplot");
204 props.put(KEY_GPSBABEL_PATH, "gpsbabel");
205 props.put(KEY_IMPORT_FILE_FORMAT, "-1"); // no file format selected
206 props.put(KEY_KMZ_IMAGE_SIZE, "240");
207 props.put(KEY_ANTIALIAS, "1"); // antialias on by default
208 props.put(KEY_AUTOSAVE_SETTINGS, "0"); // autosave false by default
209 props.put(KEY_UNITSET_KEY, "unitset.kilometres"); // metric by default
210 props.put(KEY_COORD_DISPLAY_FORMAT, "0"); // original
211 props.put(KEY_HEIGHT_EXAGGERATION, "100"); // 100%, no exaggeration
212 props.put(KEY_TERRAIN_GRID_SIZE, "50");
213 props.put(KEY_ALTITUDE_TOLERANCE, "0"); // 0, all exact as before
214 props.put(KEY_WAYPOINT_ICON_SIZE, "1"); // medium size
219 * Adjust the index of the selected map
220 * (only required if config was loaded from a previous version of GpsPrune)
222 private static void adjustSelectedMap()
224 int sourceNum = getConfigInt(Config.KEY_MAPSOURCE_INDEX);
225 int prevNumFixed = getConfigInt(Config.KEY_NUM_FIXED_MAPS);
226 // Number of fixed maps not specified in version <=13, default to 6
227 if (prevNumFixed == 0) prevNumFixed = 6;
228 int currNumFixed = MapSourceLibrary.getNumFixedSources();
229 // Only need to do something if the number has changed
230 if (currNumFixed != prevNumFixed && (sourceNum >= prevNumFixed || sourceNum >= currNumFixed))
232 sourceNum += (currNumFixed - prevNumFixed);
233 setConfigInt(Config.KEY_MAPSOURCE_INDEX, sourceNum);
235 setConfigInt(Config.KEY_NUM_FIXED_MAPS, currNumFixed);
239 * @param inString String to parse
240 * @return int value of String, or 0 if unparseable
242 private static int parseInt(String inString)
246 val = Integer.parseInt(inString);
248 catch (Exception e) {} // ignore, value stays zero
253 * @return File from which config was loaded (or null)
255 public static File getConfigFile()
261 * Set the file to which config was saved
263 public static void setConfigFile(File inFile)
265 _configFile = inFile;
269 * @return config Properties object to allow all config values to be saved
271 public static Properties getAllConfig()
273 // Update recently-used files
274 _configValues.setProperty(KEY_RECENT_FILES, _recentFiles.getConfigString());
275 return _configValues;
279 * @return the current colour scheme
281 public static ColourScheme getColourScheme()
283 return _colourScheme;
287 * @return the current point colourer, if any
289 public static PointColourer getPointColourer()
291 return _pointColourer;
295 * @return list of recently used files
297 public static RecentFileList getRecentFileList()
303 * Store the given configuration setting
304 * @param inKey key (from constants)
305 * @param inValue value as string
307 public static void setConfigString(String inKey, String inValue)
309 if (inValue == null || inValue.equals("")) {
310 _configValues.remove(inKey);
313 _configValues.put(inKey, inValue);
318 * Store the given configuration setting
319 * @param inKey key (from constants)
320 * @param inValue value as boolean
322 public static void setConfigBoolean(String inKey, boolean inValue)
324 if (inKey != null && !inKey.equals(""))
326 _configValues.put(inKey, (inValue?"1":"0"));
331 * Store the given configuration setting
332 * @param inKey key (from constants)
333 * @param inValue value as int
335 public static void setConfigInt(String inKey, int inValue)
337 if (inKey != null && !inKey.equals(""))
339 _configValues.put(inKey, "" + inValue);
344 * Get the given configuration setting as a String
346 * @return configuration setting as a String
348 public static String getConfigString(String inKey)
350 return _configValues.getProperty(inKey);
354 * Get the given configuration setting as a boolean
356 * @return configuration setting as a boolean (default to true)
358 public static boolean getConfigBoolean(String inKey)
360 String val = _configValues.getProperty(inKey);
361 return (val == null || val.equals("1"));
365 * Get the given configuration setting as an int
367 * @return configuration setting as an int
369 public static int getConfigInt(String inKey)
371 return parseInt(_configValues.getProperty(inKey));
375 * Check whether the given key corresponds to a boolean property
376 * @param inKey key to check
377 * @return true if corresponding property is boolean
379 public static boolean isKeyBoolean(String inKey)
381 return inKey != null && (
382 inKey.equals(KEY_SHOW_MAP) || inKey.equals(KEY_AUTOSAVE_SETTINGS) || inKey.equals(KEY_ONLINE_MODE)
383 || inKey.equals(KEY_ANTIALIAS));
387 * Update the colour scheme property from the current settings
389 public static void updateColourScheme()
391 setConfigString(KEY_COLOUR_SCHEME, _colourScheme.toString());
395 * Update the point colourer from the given colourer
396 * @param inColourer point colourer object, or null
398 public static void updatePointColourer(PointColourer inColourer)
400 _pointColourer = inColourer;
401 setConfigString(KEY_POINT_COLOURER, ColourerFactory.pointColourerToString(_pointColourer));
405 * @return the current unit set
407 public static UnitSet getUnitSet() {
412 * @param inIndex index of unit set to select
414 public static void selectUnitSet(int inIndex)
416 _unitSet = UnitSetLibrary.getUnitSet(inIndex);
417 // Set name of set in config
418 setConfigString(KEY_UNITSET_KEY, _unitSet.getNameKey());