X-Git-Url: https://git.street.me.uk/andy/viking.git/blobdiff_plain/0df66d57a7784625fcb5f66147c45ed7450f2592..355fba114cb61cc3b9828c85f1341c46caf4a335:/src/vikviewport.h?ds=sidebyside diff --git a/src/vikviewport.h b/src/vikviewport.h index 7331a707..fb7b6356 100644 --- a/src/vikviewport.h +++ b/src/vikviewport.h @@ -25,25 +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_VIEWPORT_MAX_ZOOM 8192.0 +#define VIK_VIEWPORT_MAX_ZOOM 32768.0 #define VIK_VIEWPORT_MIN_ZOOM 0.125 /* 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; @@ -51,114 +55,61 @@ 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 ); - -void vik_viewport_clear ( VikViewport *vvp ); -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_centermark ( VikViewport *vvp ); -void vik_viewport_set_draw_centermark ( VikViewport *vvp, gboolean draw_centermark ); -gboolean vik_viewport_get_draw_centermark ( VikViewport *vvp ); +/* 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 ); -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_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_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 ); - -/* run this before drawing a line. vik_viewport_draw_line runs it for you */ -void a_viewport_clip_line ( gint *x1, gint *y1, gint *x2, gint *y2 ); - -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 ); +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 ); -/* 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_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 ); - -GdkFunction vik_gc_get_function ( GdkGC *gc ); - -void vik_viewport_pan_sync ( VikViewport *vvp, gint x_off, gint y_off ); +/* drawmode management */ typedef enum { VIK_VIEWPORT_DRAWMODE_UTM=0, VIK_VIEWPORT_DRAWMODE_EXPEDIA, - VIK_VIEWPORT_DRAWMODE_GOOGLE, - VIK_VIEWPORT_DRAWMODE_KH, VIK_VIEWPORT_DRAWMODE_MERCATOR, - VIK_VIEWPORT_NUM_DRAWMODES + VIK_VIEWPORT_NUM_DRAWMODES /*< skip >*/ } VikViewportDrawMode; -/* Do not forget to update vik_viewport_drawmode_name() if you modify 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 ); -void vik_viewport_corners_for_zonen ( VikViewport *vvp, int zone, VikCoord *ul, VikCoord *br ); + /* Do not forget to update vik_viewport_get_drawmode_name() if you modify VikViewportDrawMode */ -void vik_viewport_get_min_max_lat_lon ( VikViewport *vp, gdouble *min_lat, gdouble *max_lat, gdouble *min_lon, gdouble *max_lon ); -/* TRIGGERS */ +/* Triggers */ void vik_viewport_set_trigger ( VikViewport *vp, gpointer trigger ); gpointer vik_viewport_get_trigger ( VikViewport *vp ); void vik_viewport_snapshot_save ( VikViewport *vp ); @@ -167,6 +118,51 @@ 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 ); + +/* 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_centermark ( VikViewport *vvp ); +void vik_viewport_set_draw_centermark ( VikViewport *vvp, gboolean draw_centermark ); +gboolean vik_viewport_get_draw_centermark ( VikViewport *vvp ); + +/* Color/graphics context management */ +void vik_viewport_set_background_color ( VikViewport *vvp, const gchar *color ); +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_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 ); + +/* 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 ); + + + G_END_DECLS #endif