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

Parent Directory Parent Directory | Revision Log Revision Log

Revision 87 - (show annotations)
Mon Aug 31 12:01:28 2009 UTC (14 years, 8 months ago) by harbaum
File MIME type: text/plain
File size: 6303 byte(s) 
Map source list
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_MAPS_FOR_FREE,
70 OSM_GPS_MAP_SOURCE_GOOGLE_STREET,
71 OSM_GPS_MAP_SOURCE_GOOGLE_SATELLITE,
72 OSM_GPS_MAP_SOURCE_GOOGLE_HYBRID,
73 OSM_GPS_MAP_SOURCE_VIRTUAL_EARTH_STREET,
74 OSM_GPS_MAP_SOURCE_VIRTUAL_EARTH_SATELLITE,
75 OSM_GPS_MAP_SOURCE_VIRTUAL_EARTH_HYBRID,
76 OSM_GPS_MAP_SOURCE_YAHOO_STREET,
77 OSM_GPS_MAP_SOURCE_YAHOO_SATELLITE,
78 OSM_GPS_MAP_SOURCE_YAHOO_HYBRID
79 } OsmGpsMapSource_t;
80
81 #define OSM_GPS_MAP_SOURCE_LAST (OSM_GPS_MAP_SOURCE_YAHOO_HYBRID)
82
83 typedef struct {
84 gint x, y, w, h;
85 } OsmGpsMapRect_t;
86
87 typedef enum {
88 OSD_NONE = 0,
89 OSD_BG,
90 OSD_UP,
91 OSD_DOWN,
92 OSD_LEFT,
93 OSD_RIGHT,
94 OSD_IN,
95 OSD_OUT,
96 OSD_CUSTOM // first custom buttom
97 } osd_button_t;
98
99 typedef void (*OsmGpsMapOsdCallback)(osd_button_t but, gpointer data);
100 #define OSM_GPS_MAP_OSD_CALLBACK(f) ((OsmGpsMapOsdCallback) (f))
101
102 /* the osd structure mainly contains various callbacks */
103 /* required to draw and update the OSD */
104 typedef struct osm_gps_map_osd_s {
105 GtkWidget *widget; // the main map widget (to get its stlye info)
106
107 void(*render)(struct osm_gps_map_osd_s *);
108 void(*draw)(struct osm_gps_map_osd_s *, GdkDrawable *);
109 osd_button_t(*check)(struct osm_gps_map_osd_s *,gint, gint); /* check if x/y lies within OSD */
110 gboolean(*busy)(struct osm_gps_map_osd_s *);
111 void(*free)(struct osm_gps_map_osd_s *);
112
113 OsmGpsMapOsdCallback cb;
114 gpointer data;
115
116 gpointer priv;
117 } osm_gps_map_osd_t;
118
119 typedef void (*OsmGpsMapBalloonCallback)(cairo_t *, OsmGpsMapRect_t *rect,
120 gpointer data);
121 #define OSM_GPS_MAP_BALLOON_CALLBACK(f) ((OsmGpsMapBalloonCallback) (f))
122
123 GType osm_gps_map_get_type (void) G_GNUC_CONST;
124
125 const char* osm_gps_map_source_get_friendly_name(OsmGpsMapSource_t source);
126 const char* osm_gps_map_source_get_repo_uri(OsmGpsMapSource_t source);
127 const char *osm_gps_map_source_get_image_format(OsmGpsMapSource_t source);
128 int osm_gps_map_source_get_min_zoom(OsmGpsMapSource_t source);
129 int osm_gps_map_source_get_max_zoom(OsmGpsMapSource_t source);
130
131 void osm_gps_map_download_maps (OsmGpsMap *map, coord_t *pt1, coord_t *pt2, int zoom_start, int zoom_end);
132 void osm_gps_map_get_bbox (OsmGpsMap *map, coord_t *pt1, coord_t *pt2);
133 void osm_gps_map_set_mapcenter (OsmGpsMap *map, float latitude, float longitude, int zoom);
134 void osm_gps_map_set_center (OsmGpsMap *map, float latitude, float longitude);
135 int osm_gps_map_set_zoom (OsmGpsMap *map, int zoom);
136 void osm_gps_map_add_track (OsmGpsMap *map, GSList *track);
137 void osm_gps_map_clear_tracks (OsmGpsMap *map);
138 void osm_gps_map_add_image (OsmGpsMap *map, float latitude, float longitude, GdkPixbuf *image);
139 gboolean osm_gps_map_remove_image (OsmGpsMap *map, GdkPixbuf *image);
140 void osm_gps_map_clear_images (OsmGpsMap *map);
141 void osm_gps_map_draw_gps (OsmGpsMap *map, float latitude, float longitude, float heading);
142 void osm_gps_map_clear_gps (OsmGpsMap *map);
143 coord_t osm_gps_map_get_co_ordinates (OsmGpsMap *map, int pixel_x, int pixel_y);
144 GtkWidget * osm_gps_map_new(void);
145 void osm_gps_map_screen_to_geographic (OsmGpsMap *map,
146 gint pixel_x, gint pixel_y,
147 gfloat *latitude, gfloat *longitude);
148 void osm_gps_map_geographic_to_screen (OsmGpsMap *map,
149 gfloat latitude, gfloat longitude,
150 gint *pixel_x, gint *pixel_y);
151 void osm_gps_map_scroll (OsmGpsMap *map, gint dx, gint dy);
152 float osm_gps_map_get_scale(OsmGpsMap *map);
153 #ifdef ENABLE_BALLOON
154 void osm_gps_map_draw_balloon (OsmGpsMap *map, float latitude, float longitude, OsmGpsMapBalloonCallback cb, gpointer data);
155 void osm_gps_map_clear_balloon (OsmGpsMap *map);
156 #endif
157 #ifdef ENABLE_OSD
158 void osm_gps_map_register_osd(OsmGpsMap *map, osm_gps_map_osd_t *osd);
159 void osm_gps_map_redraw (OsmGpsMap *map);
160 osm_gps_map_osd_t *osm_gps_map_osd_get(OsmGpsMap *map);
161 void osm_gps_map_repaint (OsmGpsMap *map);
162 #endif
163
164
165 G_END_DECLS
166
167 #endif /* _OSM_GPS_MAP_H_ */