2 * viking -- GPS Data and Topo Analyzer, Explorer, and Manager
4 * Copyright (C) 2003-2005, Evan Battaglia <gtoevan@gmx.net>
6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22 #ifndef _VIKING_VIEWPORT_H
23 #define _VIKING_VIEWPORT_H
24 /* Requires <gtk/gtk.h> or glib, and coords.h*/
27 #include <glib-object.h>
28 #include <gtk/gtkdrawingarea.h>
34 #define VIK_VIEWPORT_TYPE (vik_viewport_get_type ())
35 #define VIK_VIEWPORT(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), VIK_VIEWPORT_TYPE, VikViewport))
36 #define VIK_VIEWPORT_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), VIK_VIEWPORT_TYPE, VikViewportClass))
37 #define IS_VIK_VIEWPORT(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), VIK_VIEWPORT_TYPE))
38 #define IS_VIK_VIEWPORT_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), VIK_VIEWPORT_TYPE))
40 #define VIK_VIEWPORT_MAX_ZOOM 8192.0
41 #define VIK_VIEWPORT_MIN_ZOOM 0.125
43 /* used for coord to screen etc, screen to coord */
44 #define VIK_VIEWPORT_UTM_WRONG_ZONE -9999999
45 #define VIK_VIEWPORT_OFF_SCREEN_DOUBLE -9999999.9
47 typedef struct _VikViewport VikViewport
;
48 typedef struct _VikViewportClass VikViewportClass
;
50 struct _VikViewportClass
52 GtkDrawingAreaClass drawing_area_class
;
55 GType
vik_viewport_get_type ();
57 VikViewport
*vik_viewport_new ();
59 void vik_viewport_configure_manually ( VikViewport
*vvp
, gint width
, guint height
);
60 /* for off-screen viewports */
61 gboolean
vik_viewport_configure ( VikViewport
*vp
);
64 void vik_viewport_clear ( VikViewport
*vvp
);
65 void vik_viewport_draw_scale ( VikViewport
*vvp
);
66 void vik_viewport_set_draw_scale ( VikViewport
*vvp
, gboolean draw_scale
);
67 gboolean
vik_viewport_get_draw_scale ( VikViewport
*vvp
);
68 void vik_viewport_draw_centermark ( VikViewport
*vvp
);
69 void vik_viewport_set_draw_centermark ( VikViewport
*vvp
, gboolean draw_centermark
);
70 gboolean
vik_viewport_get_draw_centermark ( VikViewport
*vvp
);
73 GdkPixmap
*vik_viewport_get_pixmap ( VikViewport
*vvp
);
75 void vik_viewport_sync ( VikViewport
*vvp
);
77 void vik_viewport_set_ympp ( VikViewport
*vvp
, gdouble ympp
);
78 void vik_viewport_set_xmpp ( VikViewport
*vvp
, gdouble xmpp
);
79 gdouble
vik_viewport_get_ympp ( VikViewport
*vvp
);
80 gdouble
vik_viewport_get_xmpp ( VikViewport
*vvp
);
83 void vik_viewport_set_zoom ( VikViewport
*vvp
, gdouble mpp
);
84 gdouble
vik_viewport_get_zoom ( VikViewport
*vvp
);
85 void vik_viewport_zoom_in ( VikViewport
*vvp
);
86 void vik_viewport_zoom_out ( VikViewport
*vvp
);
88 const VikCoord
*vik_viewport_get_center ( VikViewport
*vvp
);
90 void vik_viewport_set_center_coord ( VikViewport
*vvp
, const VikCoord
*coord
);
91 void vik_viewport_set_center_screen ( VikViewport
*vvp
, int x
, int y
);
92 void vik_viewport_center_for_zonen ( VikViewport
*vvp
, struct UTM
*center
, int zone
);
93 gchar
vik_viewport_leftmost_zone ( VikViewport
*vvp
);
94 gchar
vik_viewport_rightmost_zone ( VikViewport
*vvp
);
96 void vik_viewport_screen_to_coord ( VikViewport
*vvp
, int x
, int y
, VikCoord
*coord
);
97 void vik_viewport_coord_to_screen ( VikViewport
*vvp
, const VikCoord
*coord
, int *x
, int *y
);
99 void vik_viewport_draw_pixbuf_with_alpha ( VikViewport
*vvp
, GdkPixbuf
*pixbuf
, gint alpha
,
100 gint src_x
, gint src_y
, gint dest_x
, gint dest_y
, gint w
, gint h
);
101 void vik_viewport_draw_pixbuf ( VikViewport
*vvp
, GdkPixbuf
*pixbuf
, gint src_x
, gint src_y
,
102 gint dest_x
, gint dest_y
, gint w
, gint h
);
105 gint
vik_viewport_get_width ( VikViewport
*vvp
);
106 gint
vik_viewport_get_height ( VikViewport
*vvp
);
108 GdkGC
*vik_viewport_new_gc ( VikViewport
*vvp
, const gchar
*colorname
, gint thickness
);
110 /* run this before drawing a line. vik_viewport_draw_line runs it for you */
111 void a_viewport_clip_line ( gint
*x1
, gint
*y1
, gint
*x2
, gint
*y2
);
113 void vik_viewport_draw_line ( VikViewport
*vvp
, GdkGC
*gc
, gint x1
, gint y1
, gint x2
, gint y2
);
114 void vik_viewport_draw_rectangle ( VikViewport
*vvp
, GdkGC
*gc
, gboolean filled
, gint x1
, gint y1
, gint x2
, gint y2
);
115 void vik_viewport_draw_string ( VikViewport
*vvp
, GdkFont
*font
, GdkGC
*gc
, gint x1
, gint y1
, const gchar
*string
);
116 GdkGC
*vik_viewport_new_gc_from_color ( VikViewport
*vvp
, GdkColor
*color
, gint thickness
);
117 void vik_viewport_draw_arc ( VikViewport
*vvp
, GdkGC
*gc
, gboolean filled
, gint x
, gint y
, gint width
, gint height
, gint angle1
, gint angle2
);
118 void vik_viewport_draw_polygon ( VikViewport
*vvp
, GdkGC
*gc
, gboolean filled
, GdkPoint
*points
, gint npoints
);
120 void vik_viewport_set_center_utm ( VikViewport
*vvp
, const struct UTM
*utm
);
121 void vik_viewport_set_center_latlon ( VikViewport
*vvp
, const struct LatLon
*ll
);
123 /* you must set drawmode to set coord_mode */
124 VikCoordMode
vik_viewport_get_coord_mode ( const VikViewport
*vvp
);
126 gboolean
vik_viewport_is_one_zone ( VikViewport
*vvp
);
128 void vik_viewport_set_background_color ( VikViewport
*vvp
, const gchar
*color
);
129 /* pointer to static storage -- may change -- use quickly! */
130 const gchar
*vik_viewport_get_background_color ( VikViewport
*vvp
);
131 GdkColor
*vik_viewport_get_background_gdkcolor ( VikViewport
*vvp
);
132 void vik_viewport_set_background_gdkcolor ( VikViewport
*vvp
, GdkColor
* );
134 void vik_viewport_draw_layout ( VikViewport
*vvp
, GdkGC
*gc
, gint x
, gint y
, PangoLayout
*layout
);
136 /* warning: could be slow, don't obsessively use following function. */
137 void vik_gc_get_fg_color ( GdkGC
*gc
, GdkColor
*dest
);
139 GdkFunction
vik_gc_get_function ( GdkGC
*gc
);
141 void vik_viewport_pan_sync ( VikViewport
*vvp
, gint x_off
, gint y_off
);
144 VIK_VIEWPORT_DRAWMODE_UTM
=0,
145 VIK_VIEWPORT_DRAWMODE_EXPEDIA
,
146 VIK_VIEWPORT_DRAWMODE_GOOGLE
,
147 VIK_VIEWPORT_DRAWMODE_KH
,
148 VIK_VIEWPORT_DRAWMODE_MERCATOR
,
149 VIK_VIEWPORT_NUM_DRAWMODES
150 } VikViewportDrawMode
;
151 /* Do not forget to update vik_viewport_drawmode_name() if you modify VikViewportDrawMode */
153 const gchar
*vik_viewport_get_drawmode_name(VikViewport
*vv
, VikViewportDrawMode mode
);
155 void vik_viewport_set_drawmode ( VikViewport
*vvp
, VikViewportDrawMode drawmode
);
156 VikViewportDrawMode
vik_viewport_get_drawmode ( VikViewport
*vvp
);
157 void vik_viewport_corners_for_zonen ( VikViewport
*vvp
, int zone
, VikCoord
*ul
, VikCoord
*br
);