src/globals.c

   1 /*
   2  * viking -- GPS Data and Topo Analyzer, Explorer, and Manager
   3  *
   4  * Copyright (C) 2003-2005, Evan Battaglia <gtoevan@gmx.net>
   5  * Copyright (C) 2008, Guilhem Bonnefille <guilhem.bonnefille@gmail.com>
   6  * Copyright (C) 2010-2013, Rob Norris <rw_norris@hotmail.com>
   7  *
   8  * This program is free software; you can redistribute it and/or modify
   9  * it under the terms of the GNU General Public License as published by
  10  * the Free Software Foundation; either version 2 of the License, or
  11  * (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with this program; if not, write to the Free Software
  20  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  21  *
  22  */
  23 #ifdef HAVE_CONFIG_H
  24 #include "config.h"
  25 #endif
  26 #ifdef HAVE_STDLIB_H
  27 #include <stdlib.h>
  28 #endif
  29
  30 #include <glib/gi18n.h>
  31
  32 #include "globals.h"
  33 #include "preferences.h"
  34 #include "math.h"
  35 #include "dir.h"
  36
  37 gboolean vik_debug = FALSE;
  38 gboolean vik_verbose = FALSE;
  39 gboolean vik_version = FALSE;
  40
  41 /**
  42  * viking_version_to_number:
  43  * @version:  The string of the Viking version.
  44  *            This should be in the form of N.N.N.N, where the 3rd + 4th numbers are optional
  45  *            Often you'll want to pass in VIKING_VERSION
  46  *
  47  * Returns: a single number useful for comparison
  48  */
  49 gint viking_version_to_number ( gchar *version )
  50 {
  51   // Basic method, probably can be improved
  52   gint version_number = 0;
  53   gchar** parts = g_strsplit ( version, ".", 0 );
  54   gint part_num = 0;
  55   gchar *part = parts[part_num];
  56   // Allow upto 4 parts to the version number
  57   while ( part && part_num < 4 ) {
  58     // Allow each part to have upto 100
  59     version_number = version_number + ( atol(part) * pow(100, 3-part_num) );
  60     part_num++;
  61     part = parts[part_num];
  62   }
  63   g_strfreev ( parts );
  64   return version_number;
  65 }
  66
  67 static gchar * params_degree_formats[] = {"DDD", "DMM", "DMS", NULL};
  68 static gchar * params_units_distance[] = {"Kilometres", "Miles", NULL};
  69 static gchar * params_units_speed[] = {"km/h", "mph", "m/s", "knots", NULL};
  70 static gchar * params_units_height[] = {"Metres", "Feet", NULL};
  71 static VikLayerParamScale params_scales_lat[] = { {-90.0, 90.0, 0.05, 2} };
  72 static VikLayerParamScale params_scales_long[] = { {-180.0, 180.0, 0.05, 2} };
  73 static gchar * params_vik_fileref[] = {N_("Absolute"), N_("Relative"), NULL};
  74
  75 static VikLayerParam general_prefs[] = {
  76   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_NAMESPACE "degree_format", VIK_LAYER_PARAM_UINT, VIK_LAYER_GROUP_NONE, N_("Degree format:"), VIK_LAYER_WIDGET_COMBOBOX, params_degree_formats, NULL, NULL, NULL, NULL },
  77   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_NAMESPACE "units_distance", VIK_LAYER_PARAM_UINT, VIK_LAYER_GROUP_NONE, N_("Distance units:"), VIK_LAYER_WIDGET_COMBOBOX, params_units_distance, NULL, NULL, NULL, NULL },
  78   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_NAMESPACE "units_speed", VIK_LAYER_PARAM_UINT, VIK_LAYER_GROUP_NONE, N_("Speed units:"), VIK_LAYER_WIDGET_COMBOBOX, params_units_speed, NULL, NULL, NULL, NULL },
  79   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_NAMESPACE "units_height", VIK_LAYER_PARAM_UINT, VIK_LAYER_GROUP_NONE, N_("Height units:"), VIK_LAYER_WIDGET_COMBOBOX, params_units_height, NULL, NULL, NULL, NULL },
  80   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_NAMESPACE "use_large_waypoint_icons", VIK_LAYER_PARAM_BOOLEAN, VIK_LAYER_GROUP_NONE, N_("Use large waypoint icons:"), VIK_LAYER_WIDGET_CHECKBUTTON, NULL, NULL, NULL, NULL, NULL },
  81   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_NAMESPACE "default_latitude", VIK_LAYER_PARAM_DOUBLE, VIK_LAYER_GROUP_NONE, N_("Default latitude:"), VIK_LAYER_WIDGET_SPINBUTTON, params_scales_lat, NULL, NULL, NULL, NULL },
  82   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_NAMESPACE "default_longitude", VIK_LAYER_PARAM_DOUBLE, VIK_LAYER_GROUP_NONE, N_("Default longitude:"), VIK_LAYER_WIDGET_SPINBUTTON, params_scales_long, NULL, NULL, NULL, NULL },
  83 };
  84
  85 /* External/Export Options */
  86
  87 static gchar * params_kml_export_units[] = {"Metric", "Statute", "Nautical", NULL};
  88 static gchar * params_gpx_export_trk_sort[] = {N_("Alphabetical"), N_("Time"), N_("Creation"), NULL };
  89 static gchar * params_gpx_export_wpt_symbols[] = {N_("Title Case"), N_("Lowercase"), NULL};
  90
  91 static VikLayerParam io_prefs[] = {
  92   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_IO_NAMESPACE "kml_export_units", VIK_LAYER_PARAM_UINT, VIK_LAYER_GROUP_NONE, N_("KML File Export Units:"), VIK_LAYER_WIDGET_COMBOBOX, params_kml_export_units, NULL, NULL, NULL, NULL, NULL },
  93   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_IO_NAMESPACE "gpx_export_track_sort", VIK_LAYER_PARAM_UINT, VIK_LAYER_GROUP_NONE, N_("GPX Track Order:"), VIK_LAYER_WIDGET_COMBOBOX, params_gpx_export_trk_sort, NULL, NULL, NULL, NULL, NULL },
  94   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_IO_NAMESPACE "gpx_export_wpt_sym_names", VIK_LAYER_PARAM_UINT, VIK_LAYER_GROUP_NONE, N_("GPX Waypoint Symbols:"), VIK_LAYER_WIDGET_COMBOBOX, params_gpx_export_wpt_symbols, NULL,
  95       N_("Save GPX Waypoint Symbol names in the specified case. May be useful for compatibility with various devices"), NULL, NULL, NULL },
  96 };
  97
  98 #ifndef WINDOWS
  99 static VikLayerParam io_prefs_non_windows[] = {
 100   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_IO_NAMESPACE "image_viewer", VIK_LAYER_PARAM_STRING, VIK_LAYER_GROUP_NONE, N_("Image Viewer:"), VIK_LAYER_WIDGET_FILEENTRY, NULL, NULL, NULL, NULL, NULL },
 101 };
 102 #endif
 103
 104 static VikLayerParam io_prefs_external_gpx[] = {
 105   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_IO_NAMESPACE "external_gpx_1", VIK_LAYER_PARAM_STRING, VIK_LAYER_GROUP_NONE, N_("External GPX Program 1:"), VIK_LAYER_WIDGET_FILEENTRY, NULL, NULL, NULL, NULL, NULL },
 106   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_IO_NAMESPACE "external_gpx_2", VIK_LAYER_PARAM_STRING, VIK_LAYER_GROUP_NONE, N_("External GPX Program 2:"), VIK_LAYER_WIDGET_FILEENTRY, NULL, NULL, NULL, NULL, NULL },
 107 };
 108
 109 static VikLayerParam prefs_advanced[] = {
 110   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_ADVANCED_NAMESPACE "save_file_reference_mode", VIK_LAYER_PARAM_UINT, VIK_LAYER_GROUP_NONE, N_("Save File Reference Mode:"), VIK_LAYER_WIDGET_COMBOBOX, params_vik_fileref, NULL,
 111     N_("When saving a Viking .vik file, this determines how the directory paths of filenames are written."), NULL, NULL, NULL },
 112   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_ADVANCED_NAMESPACE "create_track_tooltip", VIK_LAYER_PARAM_BOOLEAN, VIK_LAYER_GROUP_NONE, N_("Show Tooltip during Track Creation:"), VIK_LAYER_WIDGET_CHECKBUTTON, NULL, NULL, NULL, NULL, NULL },
 113 };
 114
 115 static gchar * params_startup_methods[] = {N_("Home Location"), N_("Last Location"), N_("Specified File"), N_("Auto Location"), NULL};
 116
 117 static VikLayerParam startup_prefs[] = {
 118   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_STARTUP_NAMESPACE "restore_window_state", VIK_LAYER_PARAM_BOOLEAN, VIK_LAYER_GROUP_NONE, N_("Restore Window Setup:"), VIK_LAYER_WIDGET_CHECKBUTTON, NULL, NULL,
 119     N_("Restore window size and layout"), NULL, NULL, NULL},
 120   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_STARTUP_NAMESPACE "add_default_map_layer", VIK_LAYER_PARAM_BOOLEAN, VIK_LAYER_GROUP_NONE, N_("Add a Default Map Layer:"), VIK_LAYER_WIDGET_CHECKBUTTON, NULL, NULL,
 121     N_("The default map layer added is defined by the Layer Defaults. Use the menu Edit->Layer Defaults->Map... to change the map type and other values."), NULL, NULL, NULL},
 122   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_STARTUP_NAMESPACE "startup_method", VIK_LAYER_PARAM_UINT, VIK_LAYER_GROUP_NONE, N_("Startup Method:"), VIK_LAYER_WIDGET_COMBOBOX, params_startup_methods, NULL, NULL, NULL, NULL, NULL },
 123   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_STARTUP_NAMESPACE "startup_file", VIK_LAYER_PARAM_STRING, VIK_LAYER_GROUP_NONE, N_("Startup File:"), VIK_LAYER_WIDGET_FILEENTRY, NULL, NULL,
 124     N_("The default file to load on startup. Only applies when the startup method is set to 'Specified File'"), NULL, NULL, NULL },
 125   { VIK_LAYER_NUM_TYPES, VIKING_PREFERENCES_STARTUP_NAMESPACE "check_version", VIK_LAYER_PARAM_BOOLEAN, VIK_LAYER_GROUP_NONE, N_("Check For New Version:"), VIK_LAYER_WIDGET_CHECKBUTTON, NULL, NULL,
 126     N_("Periodically check to see if a new version of Viking is available"), NULL, NULL, NULL },
 127 };
 128 /* End of Options static stuff */
 129
 130 /**
 131  * Detect when Viking is run for the very first time
 132  * Call this very early in the startup sequence to ensure subsequent correct results
 133  * The return value is cached, since later on the test will no longer be true
 134  */
 135 gboolean a_vik_very_first_run ()
 136 {
 137   static gboolean vik_very_first_run_known = FALSE;
 138   static gboolean vik_very_first_run = FALSE;
 139
 140   // use cached result if available
 141   if ( vik_very_first_run_known )
 142     return vik_very_first_run;
 143
 144   gchar *dir = a_get_viking_dir_no_create();
 145   // NB: will need extra logic if default dir gets changed e.g. from ~/.viking to ~/.config/viking
 146   if ( dir ) {
 147     // If directory exists - Viking has been run before
 148     vik_very_first_run = ! g_file_test ( dir, G_FILE_TEST_EXISTS );
 149     g_free ( dir );
 150   }
 151   else
 152     vik_very_first_run = TRUE;
 153   vik_very_first_run_known = TRUE;
 154
 155   return vik_very_first_run;
 156 }
 157
 158 void a_vik_preferences_init ()
 159 {
 160   g_debug ( "VIKING VERSION as number: %d", viking_version_to_number (VIKING_VERSION) );
 161
 162   // Defaults for the options are setup here
 163   a_preferences_register_group ( VIKING_PREFERENCES_GROUP_KEY, _("General") );
 164
 165   VikLayerParamData tmp;
 166   tmp.u = VIK_DEGREE_FORMAT_DMS;
 167   a_preferences_register(&general_prefs[0], tmp, VIKING_PREFERENCES_GROUP_KEY);
 168
 169   tmp.u = VIK_UNITS_DISTANCE_KILOMETRES;
 170   a_preferences_register(&general_prefs[1], tmp, VIKING_PREFERENCES_GROUP_KEY);
 171
 172   tmp.u = VIK_UNITS_SPEED_KILOMETRES_PER_HOUR;
 173   a_preferences_register(&general_prefs[2], tmp, VIKING_PREFERENCES_GROUP_KEY);
 174
 175   tmp.u = VIK_UNITS_HEIGHT_METRES;
 176   a_preferences_register(&general_prefs[3], tmp, VIKING_PREFERENCES_GROUP_KEY);
 177
 178   tmp.b = TRUE;
 179   a_preferences_register(&general_prefs[4], tmp, VIKING_PREFERENCES_GROUP_KEY);
 180
 181   /* Maintain the default location to New York */
 182   tmp.d = 40.714490;
 183   a_preferences_register(&general_prefs[5], tmp, VIKING_PREFERENCES_GROUP_KEY);
 184   tmp.d = -74.007130;
 185   a_preferences_register(&general_prefs[6], tmp, VIKING_PREFERENCES_GROUP_KEY);
 186
 187   // New Tab
 188   a_preferences_register_group ( VIKING_PREFERENCES_STARTUP_GROUP_KEY, _("Startup") );
 189
 190   tmp.b = FALSE;
 191   a_preferences_register(&startup_prefs[0], tmp, VIKING_PREFERENCES_STARTUP_GROUP_KEY);
 192
 193   tmp.b = FALSE;
 194   a_preferences_register(&startup_prefs[1], tmp, VIKING_PREFERENCES_STARTUP_GROUP_KEY);
 195
 196   tmp.u = VIK_STARTUP_METHOD_HOME_LOCATION;
 197   a_preferences_register(&startup_prefs[2], tmp, VIKING_PREFERENCES_STARTUP_GROUP_KEY);
 198
 199   tmp.s = "";
 200   a_preferences_register(&startup_prefs[3], tmp, VIKING_PREFERENCES_STARTUP_GROUP_KEY);
 201
 202   tmp.b = FALSE;
 203   a_preferences_register(&startup_prefs[4], tmp, VIKING_PREFERENCES_STARTUP_GROUP_KEY);
 204
 205   // New Tab
 206   a_preferences_register_group ( VIKING_PREFERENCES_IO_GROUP_KEY, _("Export/External") );
 207
 208   tmp.u = VIK_KML_EXPORT_UNITS_METRIC;
 209   a_preferences_register(&io_prefs[0], tmp, VIKING_PREFERENCES_IO_GROUP_KEY);
 210
 211   tmp.u = VIK_GPX_EXPORT_TRK_SORT_TIME;
 212   a_preferences_register(&io_prefs[1], tmp, VIKING_PREFERENCES_IO_GROUP_KEY);
 213
 214   tmp.b = VIK_GPX_EXPORT_WPT_SYM_NAME_TITLECASE;
 215   a_preferences_register(&io_prefs[2], tmp, VIKING_PREFERENCES_IO_GROUP_KEY);
 216
 217 #ifndef WINDOWS
 218   tmp.s = "xdg-open";
 219   a_preferences_register(&io_prefs_non_windows[0], tmp, VIKING_PREFERENCES_IO_GROUP_KEY);
 220 #endif
 221
 222   // JOSM for OSM editing around a GPX track
 223   tmp.s = "josm";
 224   a_preferences_register(&io_prefs_external_gpx[0], tmp, VIKING_PREFERENCES_IO_GROUP_KEY);
 225   // Add a second external program - another OSM editor by default
 226   tmp.s = "merkaartor";
 227   a_preferences_register(&io_prefs_external_gpx[1], tmp, VIKING_PREFERENCES_IO_GROUP_KEY);
 228
 229   // 'Advanced' Properties
 230   a_preferences_register_group ( VIKING_PREFERENCES_ADVANCED_GROUP_KEY, _("Advanced") );
 231
 232   tmp.u = VIK_FILE_REF_FORMAT_ABSOLUTE;
 233   a_preferences_register(&prefs_advanced[0], tmp, VIKING_PREFERENCES_ADVANCED_GROUP_KEY);
 234
 235   tmp.b = TRUE;
 236   a_preferences_register(&prefs_advanced[1], tmp, VIKING_PREFERENCES_ADVANCED_GROUP_KEY);
 237 }
 238
 239 vik_degree_format_t a_vik_get_degree_format ( )
 240 {
 241   vik_degree_format_t format;
 242   format = a_preferences_get(VIKING_PREFERENCES_NAMESPACE "degree_format")->u;
 243   return format;
 244 }
 245
 246 vik_units_distance_t a_vik_get_units_distance ( )
 247 {
 248   vik_units_distance_t units;
 249   units = a_preferences_get(VIKING_PREFERENCES_NAMESPACE "units_distance")->u;
 250   return units;
 251 }
 252
 253 vik_units_speed_t a_vik_get_units_speed ( )
 254 {
 255   vik_units_speed_t units;
 256   units = a_preferences_get(VIKING_PREFERENCES_NAMESPACE "units_speed")->u;
 257   return units;
 258 }
 259
 260 vik_units_height_t a_vik_get_units_height ( )
 261 {
 262   vik_units_height_t units;
 263   units = a_preferences_get(VIKING_PREFERENCES_NAMESPACE "units_height")->u;
 264   return units;
 265 }
 266
 267 gboolean a_vik_get_use_large_waypoint_icons ( )
 268 {
 269   gboolean use_large_waypoint_icons;
 270   use_large_waypoint_icons = a_preferences_get(VIKING_PREFERENCES_NAMESPACE "use_large_waypoint_icons")->b;
 271   return use_large_waypoint_icons;
 272 }
 273
 274 gdouble a_vik_get_default_lat ( )
 275 {
 276   gdouble data;
 277   data = a_preferences_get(VIKING_PREFERENCES_NAMESPACE "default_latitude")->d;
 278   return data;
 279 }
 280
 281 gdouble a_vik_get_default_long ( )
 282 {
 283   gdouble data;
 284   data = a_preferences_get(VIKING_PREFERENCES_NAMESPACE "default_longitude")->d;
 285   return data;
 286 }
 287
 288 /* External/Export Options */
 289
 290 vik_kml_export_units_t a_vik_get_kml_export_units ( )
 291 {
 292   vik_kml_export_units_t units;
 293   units = a_preferences_get(VIKING_PREFERENCES_IO_NAMESPACE "kml_export_units")->u;
 294   return units;
 295 }
 296
 297 vik_gpx_export_trk_sort_t a_vik_get_gpx_export_trk_sort ( )
 298 {
 299   vik_gpx_export_trk_sort_t sort;
 300   sort = a_preferences_get(VIKING_PREFERENCES_IO_NAMESPACE "gpx_export_track_sort")->u;
 301   return sort;
 302 }
 303
 304 vik_gpx_export_wpt_sym_name_t a_vik_gpx_export_wpt_sym_name ( )
 305 {
 306   gboolean val;
 307   val = a_preferences_get(VIKING_PREFERENCES_IO_NAMESPACE "gpx_export_wpt_sym_names")->b;
 308   return val;
 309 }
 310
 311 #ifndef WINDOWS
 312 const gchar* a_vik_get_image_viewer ( )
 313 {
 314   return a_preferences_get(VIKING_PREFERENCES_IO_NAMESPACE "image_viewer")->s;
 315 }
 316 #endif
 317
 318 const gchar* a_vik_get_external_gpx_program_1 ( )
 319 {
 320   return a_preferences_get(VIKING_PREFERENCES_IO_NAMESPACE "external_gpx_1")->s;
 321 }
 322
 323 const gchar* a_vik_get_external_gpx_program_2 ( )
 324 {
 325   return a_preferences_get(VIKING_PREFERENCES_IO_NAMESPACE "external_gpx_2")->s;
 326 }
 327
 328 vik_file_ref_format_t a_vik_get_file_ref_format ( )
 329 {
 330   vik_file_ref_format_t format;
 331   format = a_preferences_get(VIKING_PREFERENCES_ADVANCED_NAMESPACE "save_file_reference_mode")->u;
 332   return format;
 333 }
 334
 335 gboolean a_vik_get_create_track_tooltip ( )
 336 {
 337   return a_preferences_get(VIKING_PREFERENCES_ADVANCED_NAMESPACE "create_track_tooltip")->b;
 338 }
 339
 340 // Startup Options
 341 gboolean a_vik_get_restore_window_state ( )
 342 {
 343   gboolean data;
 344   data = a_preferences_get(VIKING_PREFERENCES_STARTUP_NAMESPACE "restore_window_state")->b;
 345   return data;
 346 }
 347
 348 gboolean a_vik_get_add_default_map_layer ( )
 349 {
 350   gboolean data;
 351   data = a_preferences_get(VIKING_PREFERENCES_STARTUP_NAMESPACE "add_default_map_layer")->b;
 352   return data;
 353 }
 354
 355 vik_startup_method_t a_vik_get_startup_method ( )
 356 {
 357   vik_startup_method_t data;
 358   data = a_preferences_get(VIKING_PREFERENCES_STARTUP_NAMESPACE "startup_method")->u;
 359   return data;
 360 }
 361
 362 const gchar *a_vik_get_startup_file ( )
 363 {
 364   return a_preferences_get(VIKING_PREFERENCES_STARTUP_NAMESPACE "startup_file")->s;
 365 }
 366
 367 gboolean a_vik_get_check_version ( )
 368 {
 369   return a_preferences_get(VIKING_PREFERENCES_STARTUP_NAMESPACE "check_version")->b;
 370 }