From d09d8de870b6697c8a8b262e7e077b871a69b315 Mon Sep 17 00:00:00 2001 From: Matthew Barnes Date: Mon, 10 Dec 2012 08:09:59 -0500 Subject: Consolidate base utility libraries into libeutil. Evolution consists of entirely too many small utility libraries, which increases linking and loading time, places a burden on higher layers of the application (e.g. modules) which has to remember to link to all the small in-tree utility libraries, and makes it difficult to generate API documentation for these utility libraries in one Gtk-Doc module. Merge the following utility libraries under the umbrella of libeutil, and enforce a single-include policy on libeutil so we can reorganize the files as desired without disrupting its pseudo-public API. libemail-utils/libemail-utils.la libevolution-utils/libevolution-utils.la filter/libfilter.la widgets/e-timezone-dialog/libetimezonedialog.la widgets/menus/libmenus.la widgets/misc/libemiscwidgets.la widgets/table/libetable.la widgets/text/libetext.la This also merges libedataserverui from the Evolution-Data-Server module, since Evolution is its only consumer nowadays, and I'd like to make some improvements to those APIs without concern for backward-compatibility. And finally, start a Gtk-Doc module for libeutil. It's going to be a project just getting all the symbols _listed_ much less _documented_. But the skeletal structure is in place and I'm off to a good start. --- e-util/e-map.h | 155 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 155 insertions(+) create mode 100644 e-util/e-map.h (limited to 'e-util/e-map.h') diff --git a/e-util/e-map.h b/e-util/e-map.h new file mode 100644 index 0000000000..cb2923d3fb --- /dev/null +++ b/e-util/e-map.h @@ -0,0 +1,155 @@ +/* + * + * This program is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License as published by the Free Software Foundation; either + * version 2 of the License, or (at your option) version 3. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with the program; if not, see + * + * + * Authors: + * Hans Petter Jansson + * + * Copyright (C) 1999-2008 Novell, Inc. (www.novell.com) + * + */ + +#if !defined (__E_UTIL_H_INSIDE__) && !defined (LIBEUTIL_COMPILATION) +#error "Only should be included directly." +#endif + +#ifndef E_MAP_H +#define E_MAP_H + +#include + +/* Standard GObject macros */ +#define E_TYPE_MAP \ + (e_map_get_type ()) +#define E_MAP(obj) \ + (G_TYPE_CHECK_INSTANCE_CAST \ + ((obj), E_TYPE_MAP, EMap)) +#define E_MAP_CLASS(cls) \ + (G_TYPE_CHECK_CLASS_CAST \ + ((cls), E_TYPE_MAP, EMapClass)) +#define E_IS_MAP(obj) \ + (G_TYPE_CHECK_INSTANCE_TYPE \ + ((obj), E_TYPE_MAP)) +#define E_IS_MAP_CLASS(cls) \ + (G_TYPE_CHECK_CLASS_TYPE \ + ((cls), E_TYPE_MAP)) +#define E_MAP_GET_CLASS(obj) \ + (G_TYPE_INSTANCE_GET_CLASS \ + ((obj), E_TYPE_MAP, EMapClass)) + +G_BEGIN_DECLS + +typedef struct _EMap EMap; +typedef struct _EMapClass EMapClass; +typedef struct _EMapPrivate EMapPrivate; +typedef struct _EMapPoint EMapPoint; + +struct _EMap { + GtkWidget widget; + EMapPrivate *priv; +}; + +struct _EMapClass { + GtkWidgetClass parent_class; + + /* Notification signals */ + void (*zoom_fit) (EMap * view); + + /* GTK+ scrolling interface */ + void (*set_scroll_adjustments) (GtkWidget * widget, + GtkAdjustment * hadj, + GtkAdjustment * vadj); +}; + +/* The definition of Dot */ + +struct _EMapPoint { + gchar *name; /* Can be NULL */ + gdouble longitude, latitude; + guint32 rgba; + gpointer user_data; +}; + +/* --- Widget --- */ + +GType e_map_get_type (void); + +EMap *e_map_new (void); + +/* Stop doing redraws when map data changes (e.g. by modifying points) */ +void e_map_freeze (EMap *map); + +/* Do an immediate repaint, and start doing realtime repaints again */ +void e_map_thaw (EMap *map); + +/* --- Coordinate translation --- */ + +/* Translates window-relative coords to lat/long */ +void e_map_window_to_world (EMap *map, + gdouble win_x, gdouble win_y, + gdouble *world_longitude, gdouble *world_latitude); + +/* Translates lat/long to window-relative coordinates. Note that the + * returned coordinates can be negative or greater than the current size + * of the allocation area */ +void e_map_world_to_window (EMap *map, + gdouble world_longitude, gdouble world_latitude, + gdouble *win_x, gdouble *win_y); + +/* --- Zoom --- */ + +gdouble e_map_get_magnification (EMap *map); + +/* Pass TRUE if we want the smooth zoom hack */ +void e_map_set_smooth_zoom (EMap *map, gboolean state); + +/* TRUE if smooth zoom hack will be employed */ +gboolean e_map_get_smooth_zoom (EMap *map); + +/* NB: Function definition will change shortly */ +void e_map_zoom_to_location (EMap *map, gdouble longitude, gdouble latitude); + +/* Zoom to mag factor 1.0 */ +void e_map_zoom_out (EMap *map); + +/* --- Points --- */ + +EMapPoint *e_map_add_point (EMap *map, gchar *name, + gdouble longitude, gdouble latitude, + guint32 color_rgba); + +void e_map_remove_point (EMap *map, EMapPoint *point); + +void e_map_point_get_location (EMapPoint *point, + gdouble *longitude, gdouble *latitude); + +gchar *e_map_point_get_name (EMapPoint *point); + +guint32 e_map_point_get_color_rgba (EMapPoint *point); + +void e_map_point_set_color_rgba (EMap *map, EMapPoint *point, guint32 color_rgba); + +void e_map_point_set_data (EMapPoint *point, gpointer data); + +gpointer e_map_point_get_data (EMapPoint *point); + +gboolean e_map_point_is_in_view (EMap *map, EMapPoint *point); + +EMapPoint *e_map_get_closest_point (EMap *map, gdouble longitude, gdouble latitude, + gboolean in_view); + +G_END_DECLS + +#endif -- cgit v1.2.3