src/vikcoord.h

   1 /*
   2  * viking -- GPS Data and Topo Analyzer, Explorer, and Manager
   3  *
   4  * Copyright (C) 2003-2005, Evan Battaglia <gtoevan@gmx.net>
   5  *
   6  * This program is free software; you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation; either version 2 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * This program is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program; if not, write to the Free Software
  18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  19  *
  20  */
  21
  22 #ifndef _VIKING_VIKCOORD_H
  23 #define _VIKING_VIKCOORD_H
  24
  25 typedef gshort VikCoordMode;
  26 #define VIK_COORD_UTM 0
  27 #define VIK_COORD_LATLON 1
  28
  29 #define VIK_UTM(x) ((struct UTM *)(x))
  30 #define VIK_LATLON(x) ((struct LatLon *)(x))
  31
  32 typedef struct {
  33   gdouble north_south; /* northing or lat */
  34   gdouble east_west;   /* easting or lon */
  35   gchar utm_zone;
  36   gchar utm_letter;
  37
  38   VikCoordMode mode;
  39 } VikCoord;
  40 /* notice we can cast to either UTM or LatLon */
  41 /* possible more modes to come? xy? we'll leave that as an option */
  42
  43 VikCoord *vik_coord_new();
  44 void vik_coord_free(VikCoord *coord);
  45
  46 void vik_coord_convert(VikCoord *coord, VikCoordMode dest_mode);
  47 void vik_coord_copy_convert(const VikCoord *coord, VikCoordMode dest_mode, VikCoord *dest);
  48 gdouble vik_coord_diff(const VikCoord *c1, const VikCoord *c2);
  49
  50 void vik_coord_load_from_latlon ( VikCoord *coord, VikCoordMode mode, const struct LatLon *ll );
  51 void vik_coord_load_from_utm ( VikCoord *coord, VikCoordMode mode, const struct UTM *utm );
  52
  53 void vik_coord_to_latlon ( const VikCoord *coord, struct LatLon *dest );
  54 void vik_coord_to_utm ( const VikCoord *coord, struct UTM *dest );
  55
  56 gboolean vik_coord_equals ( const VikCoord *coord1, const VikCoord *coord2 );
  57
  58 /* all coord operations MUST BE ABSTRACTED!!! */
  59
  60 #endif