X-Git-Url: https://git.street.me.uk/andy/viking.git/blobdiff_plain/acaf7113fffde4a6a6f6c0d57a4eea27e1024a31..0925261ec4dde3b142e88a2e8ad5dfb74195d619:/src/vikviewport.h?ds=sidebyside diff --git a/src/vikviewport.h b/src/vikviewport.h index b3202c3b..27f291da 100644 --- a/src/vikviewport.h +++ b/src/vikviewport.h @@ -25,23 +25,29 @@ #include #include -#include +#include + +#include "vikcoord.h" + G_BEGIN_DECLS + #define VIK_VIEWPORT_TYPE (vik_viewport_get_type ()) #define VIK_VIEWPORT(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), VIK_VIEWPORT_TYPE, VikViewport)) #define VIK_VIEWPORT_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), VIK_VIEWPORT_TYPE, VikViewportClass)) -#define IS_VIK_VIEWPORT(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), VIK_VIEWPORT_TYPE)) -#define IS_VIK_VIEWPORT_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), VIK_VIEWPORT_TYPE)) +#define VIK_IS_VIEWPORT(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), VIK_VIEWPORT_TYPE)) +#define VIK_IS_VIEWPORT_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), VIK_VIEWPORT_TYPE)) -#define VIK_VIEWPORT_MAX_ZOOM 8192.0 -#define VIK_VIEWPORT_MIN_ZOOM 0.125 +#define VIK_VIEWPORT_MAX_ZOOM 32768.0 +#define VIK_VIEWPORT_MIN_ZOOM (1 / 32.0) /* used for coord to screen etc, screen to coord */ #define VIK_VIEWPORT_UTM_WRONG_ZONE -9999999 #define VIK_VIEWPORT_OFF_SCREEN_DOUBLE -9999999.9 + +/* Glib type inheritance and initialization */ typedef struct _VikViewport VikViewport; typedef struct _VikViewportClass VikViewportClass; @@ -49,94 +55,132 @@ struct _VikViewportClass { GtkDrawingAreaClass drawing_area_class; }; - GType vik_viewport_get_type (); -VikViewport *vik_viewport_new (); -void vik_viewport_configure_manually ( VikViewport *vvp, gint width, guint height ); -/* for off-screen viewports */ -gboolean vik_viewport_configure ( VikViewport *vp ); +/* Viking initialization */ +VikViewport *vik_viewport_new (); +void vik_viewport_configure_manually ( VikViewport *vvp, gint width, guint height ); /* for off-screen viewports */ +gboolean vik_viewport_configure ( VikViewport *vp ); -void vik_viewport_clear ( VikViewport *vvp ); -void vik_viewport_draw_scale ( VikViewport *vvp ); - -GdkPixmap *vik_viewport_get_pixmap ( VikViewport *vvp ); +/* coordinate transformations */ +void vik_viewport_screen_to_coord ( VikViewport *vvp, int x, int y, VikCoord *coord ); +void vik_viewport_coord_to_screen ( VikViewport *vvp, const VikCoord *coord, int *x, int *y ); -void vik_viewport_sync ( VikViewport *vvp ); +/* viewport scale */ void vik_viewport_set_ympp ( VikViewport *vvp, gdouble ympp ); void vik_viewport_set_xmpp ( VikViewport *vvp, gdouble xmpp ); gdouble vik_viewport_get_ympp ( VikViewport *vvp ); gdouble vik_viewport_get_xmpp ( VikViewport *vvp ); - - void vik_viewport_set_zoom ( VikViewport *vvp, gdouble mpp ); gdouble vik_viewport_get_zoom ( VikViewport *vvp ); void vik_viewport_zoom_in ( VikViewport *vvp ); void vik_viewport_zoom_out ( VikViewport *vvp ); -const VikCoord *vik_viewport_get_center ( VikViewport *vvp ); +/* viewport position */ +const VikCoord *vik_viewport_get_center ( VikViewport *vvp ); void vik_viewport_set_center_coord ( VikViewport *vvp, const VikCoord *coord ); void vik_viewport_set_center_screen ( VikViewport *vvp, int x, int y ); void vik_viewport_center_for_zonen ( VikViewport *vvp, struct UTM *center, int zone); gchar vik_viewport_leftmost_zone ( VikViewport *vvp ); gchar vik_viewport_rightmost_zone ( VikViewport *vvp ); +void vik_viewport_set_center_utm ( VikViewport *vvp, const struct UTM *utm ); +void vik_viewport_set_center_latlon ( VikViewport *vvp, const struct LatLon *ll ); +void vik_viewport_corners_for_zonen ( VikViewport *vvp, int zone, VikCoord *ul, VikCoord *br ); +void vik_viewport_get_min_max_lat_lon ( VikViewport *vp, gdouble *min_lat, gdouble *max_lat, gdouble *min_lon, gdouble *max_lon ); -void vik_viewport_screen_to_coord ( VikViewport *vvp, int x, int y, VikCoord *coord ); -void vik_viewport_coord_to_screen ( VikViewport *vvp, const VikCoord *coord, int *x, int *y ); +/* drawmode management */ +typedef enum { + VIK_VIEWPORT_DRAWMODE_UTM=0, + VIK_VIEWPORT_DRAWMODE_EXPEDIA, + VIK_VIEWPORT_DRAWMODE_MERCATOR, + VIK_VIEWPORT_DRAWMODE_LATLON, + VIK_VIEWPORT_NUM_DRAWMODES /*< skip >*/ +} VikViewportDrawMode; + +VikCoordMode vik_viewport_get_coord_mode ( const VikViewport *vvp ); +gboolean vik_viewport_is_one_zone ( VikViewport *vvp ); +const gchar *vik_viewport_get_drawmode_name(VikViewport *vv, VikViewportDrawMode mode); +void vik_viewport_set_drawmode ( VikViewport *vvp, VikViewportDrawMode drawmode ); +VikViewportDrawMode vik_viewport_get_drawmode ( VikViewport *vvp ); + /* Do not forget to update vik_viewport_get_drawmode_name() if you modify VikViewportDrawMode */ + + +/* Triggers */ +void vik_viewport_set_trigger ( VikViewport *vp, gpointer trigger ); +gpointer vik_viewport_get_trigger ( VikViewport *vp ); +void vik_viewport_snapshot_save ( VikViewport *vp ); +void vik_viewport_snapshot_load ( VikViewport *vp ); +void vik_viewport_set_half_drawn(VikViewport *vp, gboolean half_drawn); +gboolean vik_viewport_get_half_drawn( VikViewport *vp ); + + +/*************************************************************************************************** + * Drawing-related operations + ***************************************************************************************************/ + +/* Viewport buffer management/drawing to screen */ +GdkPixmap *vik_viewport_get_pixmap ( VikViewport *vvp ); /* get pointer to drawing buffer */ +void vik_viewport_sync ( VikViewport *vvp ); /* draw buffer to window */ +void vik_viewport_pan_sync ( VikViewport *vvp, gint x_off, gint y_off ); +void vik_viewport_clear ( VikViewport *vvp ); void vik_viewport_draw_pixbuf_with_alpha ( VikViewport *vvp, GdkPixbuf *pixbuf, gint alpha, gint src_x, gint src_y, gint dest_x, gint dest_y, gint w, gint h ); void vik_viewport_draw_pixbuf ( VikViewport *vvp, GdkPixbuf *pixbuf, gint src_x, gint src_y, gint dest_x, gint dest_y, gint w, gint h ); - - gint vik_viewport_get_width ( VikViewport *vvp ); gint vik_viewport_get_height ( VikViewport *vvp ); -GdkGC *vik_viewport_new_gc ( VikViewport *vvp, const gchar *colorname, gint thickness ); +void vik_viewport_reset_copyrights ( VikViewport *vp ); +void vik_viewport_add_copyright ( VikViewport *vp, const gchar *copyright ); -void vik_viewport_draw_line ( VikViewport *vvp, GdkGC *gc, gint x1, gint y1, gint x2, gint y2 ); -void vik_viewport_draw_rectangle ( VikViewport *vvp, GdkGC *gc, gboolean filled, gint x1, gint y1, gint x2, gint y2 ); -void vik_viewport_draw_string ( VikViewport *vvp, GdkFont *font, GdkGC *gc, gint x1, gint y1, const gchar *string ); -GdkGC *vik_viewport_new_gc_from_color ( VikViewport *vvp, GdkColor *color, gint thickness ); -void vik_viewport_draw_arc ( VikViewport *vvp, GdkGC *gc, gboolean filled, gint x, gint y, gint width, gint height, gint angle1, gint angle2 ); -void vik_viewport_draw_polygon ( VikViewport *vvp, GdkGC *gc, gboolean filled, GdkPoint *points, gint npoints ); - -void vik_viewport_set_center_utm ( VikViewport *vvp, const struct UTM *utm ); -void vik_viewport_set_center_latlon ( VikViewport *vvp, const struct LatLon *ll ); - -/* you must set drawmode to set coord_mode */ -VikCoordMode vik_viewport_get_coord_mode ( const VikViewport *vvp ); - -gboolean vik_viewport_is_one_zone ( VikViewport *vvp ); +void vik_viewport_reset_logos ( VikViewport *vp ); +void vik_viewport_add_logo ( VikViewport *vp, const GdkPixbuf *logo ); +/* Viewport features */ +void vik_viewport_draw_scale ( VikViewport *vvp ); +void vik_viewport_set_draw_scale ( VikViewport *vvp, gboolean draw_scale ); +gboolean vik_viewport_get_draw_scale ( VikViewport *vvp ); +void vik_viewport_draw_copyright ( VikViewport *vvp ); +void vik_viewport_draw_centermark ( VikViewport *vvp ); +void vik_viewport_set_draw_centermark ( VikViewport *vvp, gboolean draw_centermark ); +gboolean vik_viewport_get_draw_centermark ( VikViewport *vvp ); +void vik_viewport_draw_logo ( VikViewport *vvp ); +void vik_viewport_set_draw_highlight ( VikViewport *vvp, gboolean draw_highlight ); +gboolean vik_viewport_get_draw_highlight ( VikViewport *vvp ); + +/* Color/graphics context management */ void vik_viewport_set_background_color ( VikViewport *vvp, const gchar *color ); -/* pointer to static storage -- may change -- use quickly! */ const gchar *vik_viewport_get_background_color ( VikViewport *vvp ); GdkColor *vik_viewport_get_background_gdkcolor ( VikViewport *vvp ); void vik_viewport_set_background_gdkcolor ( VikViewport *vvp, GdkColor * ); - -void vik_viewport_draw_layout ( VikViewport *vvp, GdkGC *gc, gint x, gint y, PangoLayout *layout ); - -/* warning: could be slow, don't obsessively use following function. */ -void vik_gc_get_fg_color ( GdkGC *gc, GdkColor *dest ); - +void vik_gc_get_fg_color ( GdkGC *gc, GdkColor *dest ); /* warning: could be slow, don't use obsessively */ +GdkGC *vik_viewport_new_gc ( VikViewport *vvp, const gchar *colorname, gint thickness ); +GdkGC *vik_viewport_new_gc_from_color ( VikViewport *vvp, GdkColor *color, gint thickness ); GdkFunction vik_gc_get_function ( GdkGC *gc ); -void vik_viewport_pan_sync ( VikViewport *vvp, gint x_off, gint y_off ); - -typedef enum { VIK_VIEWPORT_DRAWMODE_UTM=0, VIK_VIEWPORT_DRAWMODE_EXPEDIA, - VIK_VIEWPORT_DRAWMODE_GOOGLE, VIK_VIEWPORT_DRAWMODE_KH, VIK_VIEWPORT_DRAWMODE_MERCATOR } VikViewportDrawMode; +void vik_viewport_set_highlight_color ( VikViewport *vvp, const gchar *color ); +const gchar *vik_viewport_get_highlight_color ( VikViewport *vvp ); +GdkColor *vik_viewport_get_highlight_gdkcolor ( VikViewport *vvp ); +void vik_viewport_set_highlight_gdkcolor ( VikViewport *vvp, GdkColor * ); +GdkGC* vik_viewport_get_gc_highlight ( VikViewport *vvp ); +void vik_viewport_set_highlight_thickness ( VikViewport *vvp, gint thickness ); +/* Drawing primitives */ +void a_viewport_clip_line ( gint *x1, gint *y1, gint *x2, gint *y2 ); /* run this before drawing a line. vik_viewport_draw_line runs it for you */ +void vik_viewport_draw_line ( VikViewport *vvp, GdkGC *gc, gint x1, gint y1, gint x2, gint y2 ); +void vik_viewport_draw_rectangle ( VikViewport *vvp, GdkGC *gc, gboolean filled, gint x1, gint y1, gint x2, gint y2 ); +void vik_viewport_draw_string ( VikViewport *vvp, GdkFont *font, GdkGC *gc, gint x1, gint y1, const gchar *string ); +void vik_viewport_draw_arc ( VikViewport *vvp, GdkGC *gc, gboolean filled, gint x, gint y, gint width, gint height, gint angle1, gint angle2 ); +void vik_viewport_draw_polygon ( VikViewport *vvp, GdkGC *gc, gboolean filled, GdkPoint *points, gint npoints ); +void vik_viewport_draw_layout ( VikViewport *vvp, GdkGC *gc, gint x, gint y, PangoLayout *layout ); -void vik_viewport_set_drawmode ( VikViewport *vvp, VikViewportDrawMode drawmode ); -VikViewportDrawMode vik_viewport_get_drawmode ( VikViewport *vvp ); -void vik_viewport_corners_for_zonen ( VikViewport *vvp, int zone, VikCoord *ul, VikCoord *br ); - +/* Utilities */ +void vik_viewport_compute_bearing ( VikViewport *vp, gint x1, gint y1, gint x2, gint y2, gdouble *angle, gdouble *baseangle ); G_END_DECLS