1 /* -*- Mode: C; indent-tabs-mode: nil; c-basic-offset: 4; tab-width: 4 -*- */
2 /* vim:set et sw=4 ts=4 */
3 /*
4  * Copyright (C) 2013 John Stowers <john.stowers@gmail.com>
5  * Copyright (C) Marcus Bauer 2008 <marcus.bauer@gmail.com>
6  * Copyright (C) Till Harbaum 2009 <till@harbaum.org>
7  *
8  * This program is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU General Public License
10  * as published by the Free Software Foundation; either version 2
11  * of the License, or (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, see <http://www.gnu.org/licenses/>.
20  */
21 
22 #ifndef _OSM_GPS_MAP_WIDGET_H_
23 #define _OSM_GPS_MAP_WIDGET_H_
24 
25 #include <glib.h>
26 #include <glib-object.h>
27 #include <gtk/gtk.h>
28 #include <gdk-pixbuf/gdk-pixbuf.h>
29 #include <cairo.h>
30 
31 G_BEGIN_DECLS
32 
33 #define OSM_TYPE_GPS_MAP             (osm_gps_map_get_type ())
34 #define OSM_GPS_MAP(obj)             (G_TYPE_CHECK_INSTANCE_CAST ((obj), OSM_TYPE_GPS_MAP, OsmGpsMap))
35 #define OSM_GPS_MAP_CLASS(klass)     (G_TYPE_CHECK_CLASS_CAST ((klass), OSM_TYPE_GPS_MAP, OsmGpsMapClass))
36 #define OSM_IS_GPS_MAP(obj)          (G_TYPE_CHECK_INSTANCE_TYPE ((obj), OSM_TYPE_GPS_MAP))
37 #define OSM_IS_GPS_MAP_CLASS(klass)  (G_TYPE_CHECK_CLASS_TYPE ((klass), OSM_TYPE_GPS_MAP))
38 #define OSM_GPS_MAP_GET_CLASS(obj)   (G_TYPE_INSTANCE_GET_CLASS ((obj), OSM_TYPE_GPS_MAP, OsmGpsMapClass))
39 
40 typedef struct _OsmGpsMapClass OsmGpsMapClass;
41 typedef struct _OsmGpsMap OsmGpsMap;
42 typedef struct _OsmGpsMapPrivate OsmGpsMapPrivate;
43 
44 #include "osm-gps-map-layer.h"
45 #include "osm-gps-map-point.h"
46 #include "osm-gps-map-track.h"
47 #include "osm-gps-map-polygon.h"
48 #include "osm-gps-map-image.h"
49 
50 struct _OsmGpsMapClass
51 {
52     GtkDrawingAreaClass parent_class;
53 
54     void (*draw_gps_point) (OsmGpsMap *map, cairo_t *cr);
55 };
56 
57 struct _OsmGpsMap
58 {
59     GtkDrawingArea parent_instance;
60     OsmGpsMapPrivate *priv;
61 };
62 
63 typedef enum {
64     OSM_GPS_MAP_KEY_FULLSCREEN,
65     OSM_GPS_MAP_KEY_ZOOMIN,
66     OSM_GPS_MAP_KEY_ZOOMOUT,
67     OSM_GPS_MAP_KEY_UP,
68     OSM_GPS_MAP_KEY_DOWN,
69     OSM_GPS_MAP_KEY_LEFT,
70     OSM_GPS_MAP_KEY_RIGHT,
71     OSM_GPS_MAP_KEY_MAX
72 } OsmGpsMapKey_t;
73 
74 #define OSM_GPS_MAP_INVALID         (0.0/0.0)
75 #define OSM_GPS_MAP_CACHE_DISABLED  "none://"
76 #define OSM_GPS_MAP_CACHE_AUTO      "auto://"
77 #define OSM_GPS_MAP_CACHE_FRIENDLY  "friendly://"
78 
79 GType           osm_gps_map_get_type                    (void) G_GNUC_CONST;
80 
81 GtkWidget*      osm_gps_map_new                         (void);
82 
83 gchar*          osm_gps_map_get_default_cache_directory (void);
84 
85 void            osm_gps_map_download_maps               (OsmGpsMap *map, OsmGpsMapPoint *pt1, OsmGpsMapPoint *pt2, int zoom_start, int zoom_end);
86 void            osm_gps_map_download_cancel_all         (OsmGpsMap *map);
87 void            osm_gps_map_get_bbox                    (OsmGpsMap *map, OsmGpsMapPoint *pt1, OsmGpsMapPoint *pt2);
88 void            osm_gps_map_zoom_fit_bbox               (OsmGpsMap *map, float latitude1, float latitude2, float longitude1, float longitude2);
89 void            osm_gps_map_set_center_and_zoom         (OsmGpsMap *map, float latitude, float longitude, int zoom);
90 void            osm_gps_map_set_center                  (OsmGpsMap *map, float latitude, float longitude);
91 int             osm_gps_map_set_zoom                    (OsmGpsMap *map, int zoom);
92 void            osm_gps_map_set_zoom_offset             (OsmGpsMap *map, int zoom_offset);
93 int             osm_gps_map_zoom_in                     (OsmGpsMap *map);
94 int             osm_gps_map_zoom_out                    (OsmGpsMap *map);
95 void            osm_gps_map_scroll                      (OsmGpsMap *map, gint dx, gint dy);
96 float           osm_gps_map_get_scale                   (OsmGpsMap *map);
97 void            osm_gps_map_set_keyboard_shortcut       (OsmGpsMap *map, OsmGpsMapKey_t key, guint keyval);
98 void            osm_gps_map_track_add                   (OsmGpsMap *map, OsmGpsMapTrack *track);
99 void            osm_gps_map_track_remove_all            (OsmGpsMap *map);
100 gboolean        osm_gps_map_track_remove                (OsmGpsMap *map, OsmGpsMapTrack *track);
101 void            osm_gps_map_polygon_add                 (OsmGpsMap *map, OsmGpsMapPolygon *poly);
102 void            osm_gps_map_polygon_remove_all          (OsmGpsMap *map);
103 gboolean        osm_gps_map_polygon_remove                (OsmGpsMap *map, OsmGpsMapPolygon *poly);
104 void            osm_gps_map_gps_add                     (OsmGpsMap *map, float latitude, float longitude, float heading);
105 void            osm_gps_map_gps_clear                   (OsmGpsMap *map);
106 OsmGpsMapTrack *osm_gps_map_gps_get_track               (OsmGpsMap *map);
107 OsmGpsMapImage *osm_gps_map_image_add                   (OsmGpsMap *map, float latitude, float longitude, GdkPixbuf *image);
108 OsmGpsMapImage *osm_gps_map_image_add_z                 (OsmGpsMap *map, float latitude, float longitude, GdkPixbuf *image, gint zorder);
109 OsmGpsMapImage *osm_gps_map_image_add_with_alignment    (OsmGpsMap *map, float latitude, float longitude, GdkPixbuf *image, float xalign, float yalign);
110 OsmGpsMapImage *osm_gps_map_image_add_with_alignment_z  (OsmGpsMap *map, float latitude, float longitude, GdkPixbuf *image, float xalign, float yalign, gint zorder);
111 gboolean        osm_gps_map_image_remove                (OsmGpsMap *map, OsmGpsMapImage *image);
112 void            osm_gps_map_image_remove_all            (OsmGpsMap *map);
113 void            osm_gps_map_layer_add                   (OsmGpsMap *map, OsmGpsMapLayer *layer);
114 gboolean        osm_gps_map_layer_remove                (OsmGpsMap *map, OsmGpsMapLayer *layer);
115 void            osm_gps_map_layer_remove_all            (OsmGpsMap *map);
116 void            osm_gps_map_convert_screen_to_geographic(OsmGpsMap *map, gint pixel_x, gint pixel_y, OsmGpsMapPoint *pt);
117 void            osm_gps_map_convert_geographic_to_screen(OsmGpsMap *map, OsmGpsMapPoint *pt, gint *pixel_x, gint *pixel_y);
118 OsmGpsMapPoint *osm_gps_map_get_event_location          (OsmGpsMap *map, GdkEventButton *event);
119 gboolean        osm_gps_map_map_redraw                  (OsmGpsMap *map);
120 void            osm_gps_map_map_redraw_idle             (OsmGpsMap *map);
121 
122 G_END_DECLS
123 
124 #endif /* _OSM_GPS_MAP_WIDGET_H_ */
125 
126