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

Parent Directory Parent Directory | Revision Log Revision Log

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