Contents of /trunk/src/osm-gps-map.h

Parent Directory Parent Directory | Revision Log Revision Log

Revision 136 - (show annotations)
Mon Oct 19 13:02:41 2009 UTC (14 years, 7 months ago) by harbaum
File MIME type: text/plain
File size: 6921 byte(s) 
Balloon callback extensions
1 /* -*- Mode: C; indent-tabs-mode: nil; c-basic-offset: 4; tab-width: 4 -*- */
2 /* vim:set et sw=4 ts=4 cino=t0,(0: */
3 /*
4 * osm-gps-map.h
5 * Copyright (C) Marcus Bauer 2008 <marcus.bauer@gmail.com>
6 * Copyright (C) John Stowers 2009 <john.stowers@gmail.com>
7 *
8 * Contributions by
9 * Everaldo Canuto 2009 <everaldo.canuto@gmail.com>
10 *
11 * osm-gps-map.c is free software: you can redistribute it and/or modify it
12 * under the terms of the GNU General Public License as published by the
13 * Free Software Foundation, either version 3 of the License, or
14 * (at your option) any later version.
15 *
16 * osm-gps-map.c is distributed in the hope that it will be useful, but
17 * WITHOUT ANY WARRANTY; without even the implied warranty of
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
19 * See the GNU General Public License for more details.
20 *
21 * You should have received a copy of the GNU General Public License along
22 * with this program. If not, see <http://www.gnu.org/licenses/>.
23 */
24
25 #ifndef _OSM_GPS_MAP_H_
26 #define _OSM_GPS_MAP_H_
27
28 #include "config.h"
29
30 #include <glib.h>
31 #include <glib-object.h>
32 #include <gtk/gtk.h>
33 #include <gdk-pixbuf/gdk-pixbuf.h>
34
35 G_BEGIN_DECLS
36
37 #define OSM_TYPE_GPS_MAP (osm_gps_map_get_type ())
38 #define OSM_GPS_MAP(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), OSM_TYPE_GPS_MAP, OsmGpsMap))
39 #define OSM_GPS_MAP_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), OSM_TYPE_GPS_MAP, OsmGpsMapClass))
40 #define OSM_IS_GPS_MAP(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), OSM_TYPE_GPS_MAP))
41 #define OSM_IS_GPS_MAP_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), OSM_TYPE_GPS_MAP))
42 #define OSM_GPS_MAP_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), OSM_TYPE_GPS_MAP, OsmGpsMapClass))
43
44 typedef struct _OsmGpsMapClass OsmGpsMapClass;
45 typedef struct _OsmGpsMap OsmGpsMap;
46 typedef struct _OsmGpsMapPrivate OsmGpsMapPrivate;
47
48 struct _OsmGpsMapClass
49 {
50 GtkDrawingAreaClass parent_class;
51 };
52
53 struct _OsmGpsMap
54 {
55 GtkDrawingArea parent_instance;
56 OsmGpsMapPrivate *priv;
57 };
58
59 typedef struct {
60 float rlat;
61 float rlon;
62 } coord_t;
63
64 typedef enum {
65 OSM_GPS_MAP_SOURCE_NULL,
66 OSM_GPS_MAP_SOURCE_OPENSTREETMAP,
67 OSM_GPS_MAP_SOURCE_OPENSTREETMAP_RENDERER,
68 OSM_GPS_MAP_SOURCE_OPENCYCLEMAP,
69 OSM_GPS_MAP_SOURCE_GOOGLE_STREET,
70 OSM_GPS_MAP_SOURCE_VIRTUAL_EARTH_STREET,
71 OSM_GPS_MAP_SOURCE_VIRTUAL_EARTH_SATELLITE,
72 OSM_GPS_MAP_SOURCE_VIRTUAL_EARTH_HYBRID,
73
74 /* entries below are currently unusable */
75 OSM_GPS_MAP_SOURCE_OSMC_TRAILS, /* only germany */
76 OSM_GPS_MAP_SOURCE_MAPS_FOR_FREE, /* not enough details */
77 OSM_GPS_MAP_SOURCE_GOOGLE_HYBRID, /* disabled by google */
78 OSM_GPS_MAP_SOURCE_GOOGLE_SATELLITE, /* disabled by google */
79 OSM_GPS_MAP_SOURCE_YAHOO_STREET, /* no implemented yet */
80 OSM_GPS_MAP_SOURCE_YAHOO_SATELLITE, /* no implemented yet */
81 OSM_GPS_MAP_SOURCE_YAHOO_HYBRID /* no implemented yet */
82 } OsmGpsMapSource_t;
83
84 #define OSM_GPS_MAP_SOURCE_LAST (OSM_GPS_MAP_SOURCE_VIRTUAL_EARTH_HYBRID)
85
86 #define OSM_GPS_MAP_INVALID (0.0/0.0)
87
88 typedef struct {
89 gint x, y, w, h;
90 } OsmGpsMapRect_t;
91
92 typedef enum {
93 OSD_NONE = 0,
94 OSD_BG,
95 OSD_UP,
96 OSD_DOWN,
97 OSD_LEFT,
98 OSD_RIGHT,
99 OSD_IN,
100 OSD_OUT,
101 OSD_CUSTOM // first custom buttom
102 } osd_button_t;
103
104 typedef void (*OsmGpsMapOsdCallback)(osd_button_t but, gpointer data);
105 #define OSM_GPS_MAP_OSD_CALLBACK(f) ((OsmGpsMapOsdCallback) (f))
106
107 /* the osd structure mainly contains various callbacks */
108 /* required to draw and update the OSD */
109 typedef struct osm_gps_map_osd_s {
110 GtkWidget *widget; // the main map widget (to get its stlye info)
111
112 void(*render)(struct osm_gps_map_osd_s *);
113 void(*draw)(struct osm_gps_map_osd_s *, GdkDrawable *);
114 osd_button_t(*check)(struct osm_gps_map_osd_s *,gboolean,gint, gint); /* check if x/y lies within OSD */
115 gboolean(*busy)(struct osm_gps_map_osd_s *);
116 void(*free)(struct osm_gps_map_osd_s *);
117
118 OsmGpsMapOsdCallback cb;
119 gpointer data;
120
121 gpointer priv;
122 } osm_gps_map_osd_t;
123
124 typedef enum {
125 OSM_GPS_MAP_BALLOON_EVENT_TYPE_DRAW,
126 OSM_GPS_MAP_BALLOON_EVENT_TYPE_CLICK,
127 OSM_GPS_MAP_BALLOON_EVENT_TYPE_REMOVED,
128 } osm_gps_map_balloon_event_type_t;
129
130 typedef struct {
131 osm_gps_map_balloon_event_type_t type;
132 union {
133 struct {
134 OsmGpsMapRect_t *rect;
135 cairo_t *cr;
136 } draw;
137
138 struct {
139 int x, y;
140 gboolean down;
141 } click;
142 } data;
143 } osm_gps_map_balloon_event_t;
144
145 typedef void (*OsmGpsMapBalloonCallback)(osm_gps_map_balloon_event_t *event, gpointer data);
146 #define OSM_GPS_MAP_BALLOON_CALLBACK(f) ((OsmGpsMapBalloonCallback) (f))
147
148 GType osm_gps_map_get_type (void) G_GNUC_CONST;
149
150 const char* osm_gps_map_source_get_friendly_name(OsmGpsMapSource_t source);
151 const char* osm_gps_map_source_get_repo_uri(OsmGpsMapSource_t source);
152 const char *osm_gps_map_source_get_image_format(OsmGpsMapSource_t source);
153 int osm_gps_map_source_get_min_zoom(OsmGpsMapSource_t source);
154 int osm_gps_map_source_get_max_zoom(OsmGpsMapSource_t source);
155
156 void osm_gps_map_download_maps (OsmGpsMap *map, coord_t *pt1, coord_t *pt2, int zoom_start, int zoom_end);
157 void osm_gps_map_get_bbox (OsmGpsMap *map, coord_t *pt1, coord_t *pt2);
158 void osm_gps_map_set_mapcenter (OsmGpsMap *map, float latitude, float longitude, int zoom);
159 void osm_gps_map_set_center (OsmGpsMap *map, float latitude, float longitude);
160 int osm_gps_map_set_zoom (OsmGpsMap *map, int zoom);
161 void osm_gps_map_add_track (OsmGpsMap *map, GSList *track);
162 void osm_gps_map_clear_tracks (OsmGpsMap *map);
163 void osm_gps_map_add_image (OsmGpsMap *map, float latitude, float longitude, GdkPixbuf *image);
164 gboolean osm_gps_map_remove_image (OsmGpsMap *map, GdkPixbuf *image);
165 void osm_gps_map_clear_images (OsmGpsMap *map);
166 void osm_gps_map_draw_gps (OsmGpsMap *map, float latitude, float longitude, float heading);
167 void osm_gps_map_clear_gps (OsmGpsMap *map);
168 coord_t osm_gps_map_get_co_ordinates (OsmGpsMap *map, int pixel_x, int pixel_y);
169 GtkWidget * osm_gps_map_new(void);
170 void osm_gps_map_screen_to_geographic (OsmGpsMap *map,
171 gint pixel_x, gint pixel_y,
172 gfloat *latitude, gfloat *longitude);
173 void osm_gps_map_geographic_to_screen (OsmGpsMap *map,
174 gfloat latitude, gfloat longitude,
175 gint *pixel_x, gint *pixel_y);
176 void osm_gps_map_scroll (OsmGpsMap *map, gint dx, gint dy);
177 float osm_gps_map_get_scale(OsmGpsMap *map);
178 #ifdef ENABLE_OSD
179 void osm_gps_map_register_osd(OsmGpsMap *map, osm_gps_map_osd_t *osd);
180 void osm_gps_map_redraw (OsmGpsMap *map);
181 osm_gps_map_osd_t *osm_gps_map_osd_get(OsmGpsMap *map);
182 void osm_gps_map_repaint (OsmGpsMap *map);
183 coord_t *osm_gps_map_get_gps (OsmGpsMap *map);
184 #endif
185
186
187 G_END_DECLS
188
189 #endif /* _OSM_GPS_MAP_H_ */