X-Git-Url: https://git.street.me.uk/andy/viking.git/blobdiff_plain/a59e6eb9014843906b3d13ced85b3e13fe25494a..de2fc9aa9e8db8e0258c8328161c6b5eda176a0a:/src/vikviewport.h diff --git a/src/vikviewport.h b/src/vikviewport.h index f0e84931..878ec818 100644 --- a/src/vikviewport.h +++ b/src/vikviewport.h @@ -29,8 +29,10 @@ #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)) @@ -44,6 +46,8 @@ G_BEGIN_DECLS #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,110 +55,114 @@ 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_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 ); + + +/* 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 +} 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 */ -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 ); +/* 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 ); +/* 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 ); -/* 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 ); +/* 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 ); -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_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 ); - -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 -} VikViewportDrawMode; -/* Do not forget to update vik_viewport_drawmode_name() if you modify VikViewportDrawMode */ - -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 ); G_END_DECLS