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

Parent Directory Parent Directory | Revision Log Revision Log

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