* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
+/**
+ * SECTION:gis-viewer
+ * @short_description: Virtual globe base class
+ *
+ * #GisViewer is the base class for the virtual globe widget. It handles
+ * everything not directly related to drawing the globe. Plugins and
+ * applications using the viewer should normally talk to the viewer and not care
+ * how it is implemented.
+ */
+
#include <config.h>
#include <math.h>
#include <gtk/gtk.h>
* Helpers *
***********/
/* Misc helpers */
-static void _gis_viewer_fix_location(GisViewer *self)
+static void _gis_viewer_fix_location(GisViewer *viewer)
{
- while (self->location[0] < -90) self->location[0] += 180;
- while (self->location[0] > 90) self->location[0] -= 180;
- while (self->location[1] < -180) self->location[1] += 360;
- while (self->location[1] > 180) self->location[1] -= 360;
- self->location[2] = ABS(self->location[2]);
+ while (viewer->location[0] < -90) viewer->location[0] += 180;
+ while (viewer->location[0] > 90) viewer->location[0] -= 180;
+ while (viewer->location[1] < -180) viewer->location[1] += 360;
+ while (viewer->location[1] > 180) viewer->location[1] -= 360;
+ viewer->location[2] = ABS(viewer->location[2]);
}
/* Signal helpers */
-static void _gis_viewer_emit_location_changed(GisViewer *self)
+static void _gis_viewer_emit_location_changed(GisViewer *viewer)
{
- g_signal_emit(self, signals[SIG_LOCATION_CHANGED], 0,
- self->location[0],
- self->location[1],
- self->location[2]);
+ g_signal_emit(viewer, signals[SIG_LOCATION_CHANGED], 0,
+ viewer->location[0],
+ viewer->location[1],
+ viewer->location[2]);
}
-static void _gis_viewer_emit_rotation_changed(GisViewer *self)
+static void _gis_viewer_emit_rotation_changed(GisViewer *viewer)
{
- g_signal_emit(self, signals[SIG_ROTATION_CHANGED], 0,
- self->rotation[0],
- self->rotation[1],
- self->rotation[2]);
+ g_signal_emit(viewer, signals[SIG_ROTATION_CHANGED], 0,
+ viewer->rotation[0],
+ viewer->rotation[1],
+ viewer->rotation[2]);
}
-static void _gis_viewer_emit_time_changed(GisViewer *self)
+static void _gis_viewer_emit_time_changed(GisViewer *viewer)
{
- g_signal_emit(self, signals[SIG_TIME_CHANGED], 0,
- self->time);
+ g_signal_emit(viewer, signals[SIG_TIME_CHANGED], 0,
+ viewer->time);
}
-static void _gis_viewer_emit_refresh(GisViewer *self)
+static void _gis_viewer_emit_refresh(GisViewer *viewer)
{
- g_signal_emit(self, signals[SIG_REFRESH], 0);
+ g_signal_emit(viewer, signals[SIG_REFRESH], 0);
}
-static void _gis_viewer_emit_offline(GisViewer *self)
+static void _gis_viewer_emit_offline(GisViewer *viewer)
{
- g_signal_emit(self, signals[SIG_OFFLINE], 0,
- self->offline);
+ g_signal_emit(viewer, signals[SIG_OFFLINE], 0,
+ viewer->offline);
}
/*************
* Callbacks *
*************/
-static gboolean on_key_press(GisViewer *self, GdkEventKey *event, gpointer _)
+static gboolean on_key_press(GisViewer *viewer, GdkEventKey *event, gpointer _)
{
g_debug("GisViewer: on_key_press - key=%x, state=%x, plus=%x",
event->keyval, event->state, GDK_plus);
double lat, lon, elev, pan;
- gis_viewer_get_location(self, &lat, &lon, &elev);
+ gis_viewer_get_location(viewer, &lat, &lon, &elev);
pan = MIN(elev/(EARTH_R/2), 30);
guint kv = event->keyval;
gdk_threads_leave();
- if (kv == GDK_Left || kv == GDK_h) gis_viewer_pan(self, 0, -pan, 0);
- else if (kv == GDK_Down || kv == GDK_j) gis_viewer_pan(self, -pan, 0, 0);
- else if (kv == GDK_Up || kv == GDK_k) gis_viewer_pan(self, pan, 0, 0);
- else if (kv == GDK_Right || kv == GDK_l) gis_viewer_pan(self, 0, pan, 0);
- else if (kv == GDK_minus || kv == GDK_o) gis_viewer_zoom(self, 10./9);
- else if (kv == GDK_plus || kv == GDK_i) gis_viewer_zoom(self, 9./10);
- else if (kv == GDK_H) gis_viewer_rotate(self, 0, 0, -2);
- else if (kv == GDK_J) gis_viewer_rotate(self, 2, 0, 0);
- else if (kv == GDK_K) gis_viewer_rotate(self, -2, 0, 0);
- else if (kv == GDK_L) gis_viewer_rotate(self, 0, 0, 2);
+ if (kv == GDK_Left || kv == GDK_h) gis_viewer_pan(viewer, 0, -pan, 0);
+ else if (kv == GDK_Down || kv == GDK_j) gis_viewer_pan(viewer, -pan, 0, 0);
+ else if (kv == GDK_Up || kv == GDK_k) gis_viewer_pan(viewer, pan, 0, 0);
+ else if (kv == GDK_Right || kv == GDK_l) gis_viewer_pan(viewer, 0, pan, 0);
+ else if (kv == GDK_minus || kv == GDK_o) gis_viewer_zoom(viewer, 10./9);
+ else if (kv == GDK_plus || kv == GDK_i) gis_viewer_zoom(viewer, 9./10);
+ else if (kv == GDK_H) gis_viewer_rotate(viewer, 0, 0, -2);
+ else if (kv == GDK_J) gis_viewer_rotate(viewer, 2, 0, 0);
+ else if (kv == GDK_K) gis_viewer_rotate(viewer, -2, 0, 0);
+ else if (kv == GDK_L) gis_viewer_rotate(viewer, 0, 0, 2);
return FALSE;
}
GIS_DRAG_TILT,
};
-static gboolean on_button_press(GisViewer *self, GdkEventButton *event, gpointer _)
+static gboolean on_button_press(GisViewer *viewer, GdkEventButton *event, gpointer _)
{
g_debug("GisViewer: on_button_press - %d", event->button);
- gtk_widget_grab_focus(GTK_WIDGET(self));
+ gtk_widget_grab_focus(GTK_WIDGET(viewer));
switch (event->button) {
- case 1: self->drag_mode = GIS_DRAG_PAN; break;
- case 2: self->drag_mode = GIS_DRAG_ZOOM; break;
- case 3: self->drag_mode = GIS_DRAG_TILT; break;
- defualt: self->drag_mode = GIS_DRAG_NONE; break;
+ case 1: viewer->drag_mode = GIS_DRAG_PAN; break;
+ case 2: viewer->drag_mode = GIS_DRAG_ZOOM; break;
+ case 3: viewer->drag_mode = GIS_DRAG_TILT; break;
+ defualt: viewer->drag_mode = GIS_DRAG_NONE; break;
}
- self->drag_x = event->x;
- self->drag_y = event->y;
+ viewer->drag_x = event->x;
+ viewer->drag_y = event->y;
return FALSE;
}
-static gboolean on_button_release(GisViewer *self, GdkEventButton *event, gpointer _)
+static gboolean on_button_release(GisViewer *viewer, GdkEventButton *event, gpointer _)
{
g_debug("GisViewer: on_button_release");
- self->drag_mode = GIS_DRAG_NONE;
+ viewer->drag_mode = GIS_DRAG_NONE;
return FALSE;
}
-static gboolean on_motion_notify(GisViewer *self, GdkEventMotion *event, gpointer _)
+static gboolean on_motion_notify(GisViewer *viewer, GdkEventMotion *event, gpointer _)
{
- gdouble x_dist = self->drag_x - event->x;
- gdouble y_dist = self->drag_y - event->y;
+ gdouble x_dist = viewer->drag_x - event->x;
+ gdouble y_dist = viewer->drag_y - event->y;
gdouble lat, lon, elev, scale;
- gis_viewer_get_location(GIS_VIEWER(self), &lat, &lon, &elev);
+ gis_viewer_get_location(GIS_VIEWER(viewer), &lat, &lon, &elev);
scale = elev/EARTH_R/15;
- switch (self->drag_mode) {
+ switch (viewer->drag_mode) {
case GIS_DRAG_PAN:
- gis_viewer_pan(self, -y_dist*scale, x_dist*scale, 0);
+ gis_viewer_pan(viewer, -y_dist*scale, x_dist*scale, 0);
break;
case GIS_DRAG_ZOOM:
- gis_viewer_zoom(self, pow(2, -y_dist/500));
+ gis_viewer_zoom(viewer, pow(2, -y_dist/500));
break;
case GIS_DRAG_TILT:
- gis_viewer_rotate(self, y_dist/10, 0, x_dist/10);
+ gis_viewer_rotate(viewer, y_dist/10, 0, x_dist/10);
break;
}
- self->drag_x = event->x;
- self->drag_y = event->y;
+ viewer->drag_x = event->x;
+ viewer->drag_y = event->y;
return FALSE;
}
-static void on_view_changed(GisViewer *self,
+static void on_view_changed(GisViewer *viewer,
gdouble _1, gdouble _2, gdouble _3)
{
- gtk_widget_queue_draw(GTK_WIDGET(self));
+ gtk_widget_queue_draw(GTK_WIDGET(viewer));
}
/***********
* Methods *
***********/
-void gis_viewer_setup(GisViewer *self, GisPlugins *plugins, GisPrefs *prefs)
+/**
+ * gis_viewer_setup:
+ * @viewer: the viewer
+ * @plugins: a plugins store
+ * @prefs: a prefs store
+ *
+ * This should be called by objects which implement GisViewer somewhere in their
+ * constructor.
+ */
+void gis_viewer_setup(GisViewer *viewer, GisPlugins *plugins, GisPrefs *prefs)
{
- self->plugins = plugins;
- self->prefs = prefs;
- self->offline = gis_prefs_get_boolean(prefs, "gis/offline", NULL);
+ viewer->plugins = plugins;
+ viewer->prefs = prefs;
+ viewer->offline = gis_prefs_get_boolean(prefs, "gis/offline", NULL);
}
-void gis_viewer_set_time(GisViewer *self, const char *time)
+/**
+ * gis_viewer_set_time:
+ * @viewer: the viewer
+ * @time: the time to set the view to
+ *
+ * Set the current time for the view
+ */
+void gis_viewer_set_time(GisViewer *viewer, const char *time)
{
- g_assert(GIS_IS_VIEWER(self));
+ g_assert(GIS_IS_VIEWER(viewer));
g_debug("GisViewer: set_time - time=%s", time);
- g_free(self->time);
- self->time = g_strdup(time);
- _gis_viewer_emit_time_changed(self);
+ g_free(viewer->time);
+ viewer->time = g_strdup(time);
+ _gis_viewer_emit_time_changed(viewer);
}
-gchar *gis_viewer_get_time(GisViewer *self)
+/**
+ * gis_viewer_get_time:
+ * @viewer: the viewer
+ *
+ * Get the time that is being viewed
+ *
+ * Returns: the current time
+ */
+gchar *gis_viewer_get_time(GisViewer *viewer)
{
- g_assert(GIS_IS_VIEWER(self));
+ g_assert(GIS_IS_VIEWER(viewer));
g_debug("GisViewer: get_time");
- return self->time;
+ return viewer->time;
}
-void gis_viewer_set_location(GisViewer *self, gdouble lat, gdouble lon, gdouble elev)
+/**
+ * gis_viewer_set_location:
+ * @viewer: the viewer
+ * @lat: the new latitude
+ * @lon: the new longitude
+ * @elev: the new elevation
+ *
+ * Set the location for the camera
+ */
+void gis_viewer_set_location(GisViewer *viewer, gdouble lat, gdouble lon, gdouble elev)
{
- g_assert(GIS_IS_VIEWER(self));
+ g_assert(GIS_IS_VIEWER(viewer));
g_debug("GisViewer: set_location");
- self->location[0] = lat;
- self->location[1] = lon;
- self->location[2] = elev;
- _gis_viewer_fix_location(self);
- _gis_viewer_emit_location_changed(self);
-}
-
-void gis_viewer_get_location(GisViewer *self, gdouble *lat, gdouble *lon, gdouble *elev)
+ viewer->location[0] = lat;
+ viewer->location[1] = lon;
+ viewer->location[2] = elev;
+ _gis_viewer_fix_location(viewer);
+ _gis_viewer_emit_location_changed(viewer);
+}
+
+/**
+ * gis_viewer_get_location:
+ * @viewer: the viewer
+ * @lat: the location to store the latitude
+ * @lon: the location to store the longitude
+ * @elev: the location to store the elevation
+ *
+ * Get the location of the camera
+ */
+void gis_viewer_get_location(GisViewer *viewer, gdouble *lat, gdouble *lon, gdouble *elev)
{
- g_assert(GIS_IS_VIEWER(self));
+ g_assert(GIS_IS_VIEWER(viewer));
//g_debug("GisViewer: get_location");
- *lat = self->location[0];
- *lon = self->location[1];
- *elev = self->location[2];
+ *lat = viewer->location[0];
+ *lon = viewer->location[1];
+ *elev = viewer->location[2];
}
-void gis_viewer_pan(GisViewer *self, gdouble lat, gdouble lon, gdouble elev)
-{
- g_assert(GIS_IS_VIEWER(self));
- g_debug("GisViewer: pan - lat=%8.3f, lon=%8.3f, elev=%8.3f", lat, lon, elev);
- self->location[0] += lat;
- self->location[1] += lon;
- self->location[2] += elev;
- _gis_viewer_fix_location(self);
- _gis_viewer_emit_location_changed(self);
-}
-
-void gis_viewer_zoom(GisViewer *self, gdouble scale)
+/**
+ * gis_viewer_pan:
+ * @viewer: the viewer
+ * @forward: distance to move forward in meters
+ * @right: distance to move right in meters
+ * @up: distance to move up in meters
+ *
+ * Pan the location by a number of meters long the surface.
+ *
+ * Bugs: the distances are not in meters
+ * Bugs: panning does not move in strait lines
+ */
+void gis_viewer_pan(GisViewer *viewer, gdouble forward, gdouble sideways, gdouble up)
+{
+ g_assert(GIS_IS_VIEWER(viewer));
+ g_debug("GisViewer: pan - forward=%8.3f, sideways=%8.3f, up=%8.3f",
+ forward, sideways, up);
+ gdouble dist = sqrt(forward*forward + sideways*sideways);
+ gdouble angle1 = deg2rad(viewer->rotation[2]);
+ gdouble angle2 = atan2(sideways, forward);
+ gdouble angle = angle1 + angle2;
+ g_message("pan: dist=%f, angle=%f+%f=%f move=%f,%f",
+ dist, angle1, angle2, angle,
+ dist*cos(angle),
+ dist*sin(angle));
+ /* This isn't accurate, but it's usable */
+ viewer->location[0] += dist*cos(angle);
+ viewer->location[1] += dist*sin(angle);
+ viewer->location[2] += up;
+ _gis_viewer_fix_location(viewer);
+ _gis_viewer_emit_location_changed(viewer);
+}
+
+/**
+ * gis_viewer_zoom:
+ * @viewer: the viewer
+ * @scale: the scale to multiple the elevation by
+ *
+ * Multiple the elevation by a scale.
+ */
+void gis_viewer_zoom(GisViewer *viewer, gdouble scale)
{
- g_assert(GIS_IS_VIEWER(self));
+ g_assert(GIS_IS_VIEWER(viewer));
g_debug("GisViewer: zoom");
- self->location[2] *= scale;
- _gis_viewer_emit_location_changed(self);
+ viewer->location[2] *= scale;
+ _gis_viewer_emit_location_changed(viewer);
}
-void gis_viewer_set_rotation(GisViewer *self, gdouble x, gdouble y, gdouble z)
+/**
+ * gis_viewer_set_rotation:
+ * @viewer: the viewer
+ * @x: rotation new around the x axes
+ * @y: rotation new around the y axes
+ * @z: rotation new around the z axes
+ *
+ * Set the rotations in degrees around the x, y, and z axes.
+ */
+void gis_viewer_set_rotation(GisViewer *viewer, gdouble x, gdouble y, gdouble z)
{
- g_assert(GIS_IS_VIEWER(self));
+ g_assert(GIS_IS_VIEWER(viewer));
g_debug("GisViewer: set_rotation");
- self->rotation[0] = x;
- self->rotation[1] = y;
- self->rotation[2] = z;
- _gis_viewer_emit_rotation_changed(self);
-}
-
-void gis_viewer_get_rotation(GisViewer *self, gdouble *x, gdouble *y, gdouble *z)
+ viewer->rotation[0] = x;
+ viewer->rotation[1] = y;
+ viewer->rotation[2] = z;
+ _gis_viewer_emit_rotation_changed(viewer);
+}
+
+/**
+ * gis_viewer_get_rotation:
+ * @viewer: the viewer
+ * @x: rotation around the x axes
+ * @y: rotation around the y axes
+ * @z: rotation around the z axes
+ *
+ * Get the rotations in degrees around the x, y, and z axes.
+ */
+void gis_viewer_get_rotation(GisViewer *viewer, gdouble *x, gdouble *y, gdouble *z)
{
- g_assert(GIS_IS_VIEWER(self));
+ g_assert(GIS_IS_VIEWER(viewer));
g_debug("GisViewer: get_rotation");
- *x = self->rotation[0];
- *y = self->rotation[1];
- *z = self->rotation[2];
+ *x = viewer->rotation[0];
+ *y = viewer->rotation[1];
+ *z = viewer->rotation[2];
}
-void gis_viewer_rotate(GisViewer *self, gdouble x, gdouble y, gdouble z)
+/**
+ * gis_viewer_rotate:
+ * @viewer: the viewer
+ * @x: rotation around the x axes
+ * @y: rotation around the y axes
+ * @z: rotation around the z axes
+ *
+ * Add to the rotation around the x, y, and z axes.
+ */
+void gis_viewer_rotate(GisViewer *viewer, gdouble x, gdouble y, gdouble z)
{
- g_assert(GIS_IS_VIEWER(self));
+ g_assert(GIS_IS_VIEWER(viewer));
g_debug("GisViewer: rotate - x=%.0f, y=%.0f, z=%.0f", x, y, z);
- self->rotation[0] += x;
- self->rotation[1] += y;
- self->rotation[2] += z;
- _gis_viewer_emit_rotation_changed(self);
+ viewer->rotation[0] += x;
+ viewer->rotation[1] += y;
+ viewer->rotation[2] += z;
+ _gis_viewer_emit_rotation_changed(viewer);
}
-void gis_viewer_refresh(GisViewer *self)
+/**
+ * gis_viewer_refresh:
+ * @viewer: the viewer
+ *
+ * Trigger the refresh signal. This will cause any remote data to be checked for
+ * updates.
+ */
+void gis_viewer_refresh(GisViewer *viewer)
{
g_debug("GisViewer: refresh");
- _gis_viewer_emit_refresh(self);
+ _gis_viewer_emit_refresh(viewer);
}
-void gis_viewer_set_offline(GisViewer *self, gboolean offline)
+/**
+ * gis_viewer_set_offline:
+ * @viewer: the viewer
+ * @offline: %TRUE to enter offline mode
+ *
+ * Set the offline mode. If @offline is %TRUE, only locally cached data will be
+ * used.
+ */
+void gis_viewer_set_offline(GisViewer *viewer, gboolean offline)
{
- g_assert(GIS_IS_VIEWER(self));
+ g_assert(GIS_IS_VIEWER(viewer));
g_debug("GisViewer: set_offline - %d", offline);
- gis_prefs_set_boolean(self->prefs, "gis/offline", offline);
- self->offline = offline;
- _gis_viewer_emit_offline(self);
-}
-
-gboolean gis_viewer_get_offline(GisViewer *self)
-{
- g_assert(GIS_IS_VIEWER(self));
- g_debug("GisViewer: get_offline - %d", self->offline);
- return self->offline;
+ gis_prefs_set_boolean(viewer->prefs, "gis/offline", offline);
+ viewer->offline = offline;
+ _gis_viewer_emit_offline(viewer);
}
-/* To be implemented by subclasses */
-void gis_viewer_center_position(GisViewer *self,
+/**
+ * gis_viewer_get_offline:
+ * @viewer: the viewer
+ *
+ * Check if the viewer is in offline mode.
+ *
+ * Returns: %TRUE if the viewer is in offline mode.
+ */
+gboolean gis_viewer_get_offline(GisViewer *viewer)
+{
+ g_assert(GIS_IS_VIEWER(viewer));
+ g_debug("GisViewer: get_offline - %d", viewer->offline);
+ return viewer->offline;
+}
+
+/***********************************
+ * To be implemented by subclasses *
+ ***********************************/
+/**
+ * gis_viewer_center_position:
+ * @viewer: the viewer
+ * @lat: the latitude
+ * @lon: the longitude
+ * @elev: the elevation
+ *
+ * Center the viewer on a point. This can be used before drawing operations to
+ * center the items a particular location.
+ */
+void gis_viewer_center_position(GisViewer *viewer,
gdouble lat, gdouble lon, gdouble elev)
{
- GisViewerClass *klass = GIS_VIEWER_GET_CLASS(self);
+ GisViewerClass *klass = GIS_VIEWER_GET_CLASS(viewer);
if (!klass->center_position)
g_warning("GisViewer: center_position - Unimplemented");
- klass->center_position(self, lat, lon, elev);
-}
-
-void gis_viewer_project(GisViewer *self,
+ klass->center_position(viewer, lat, lon, elev);
+}
+
+/**
+ * gis_viewer_project:
+ * @viewer: the viewer
+ * @lat: the latitude
+ * @lon: the latitude
+ * @elev: the latitude
+ * @px: the project x coordinate
+ * @py: the project y coordinate
+ * @pz: the project z coordinate
+ *
+ * Project a latitude, longitude, elevation point to to x, y, and z coordinates
+ * in screen space. Useful for drawing orthographic data over a particular point
+ * in space. E.g. #GisMarker.
+ */
+void gis_viewer_project(GisViewer *viewer,
gdouble lat, gdouble lon, gdouble elev,
gdouble *px, gdouble *py, gdouble *pz)
{
- GisViewerClass *klass = GIS_VIEWER_GET_CLASS(self);
+ GisViewerClass *klass = GIS_VIEWER_GET_CLASS(viewer);
if (!klass->project)
g_warning("GisViewer: project - Unimplemented");
- klass->project(self, lat, lon, elev, px, py, pz);
+ klass->project(viewer, lat, lon, elev, px, py, pz);
}
-void gis_viewer_clear_height_func(GisViewer *self)
+/**
+ * gis_viewer_clear_height_func:
+ * @viewer: the viewer
+ *
+ * Clears the height function for the entire viewer. Useful when an elevation
+ * plugin is unloaded.
+ */
+void gis_viewer_clear_height_func(GisViewer *viewer)
{
- GisViewerClass *klass = GIS_VIEWER_GET_CLASS(self);
+ GisViewerClass *klass = GIS_VIEWER_GET_CLASS(viewer);
if (!klass->clear_height_func)
g_warning("GisViewer: clear_height_func - Unimplemented");
- klass->clear_height_func(self);
+ klass->clear_height_func(viewer);
}
-void gis_viewer_set_height_func(GisViewer *self, GisTile *tile,
+/**
+ * gis_viewer_set_height_func:
+ * @viewer: the viewer
+ * @tile: the area to set the height function for
+ * @height_func: the height function
+ * @user_data: user data to pass to the height function
+ * @update: %TRUE if the heights inside the tile should be updated.
+ *
+ * Set the height function to be used for a given part of the surface..
+ */
+void gis_viewer_set_height_func(GisViewer *viewer, GisTile *tile,
GisHeightFunc height_func, gpointer user_data,
gboolean update)
{
- GisViewerClass *klass = GIS_VIEWER_GET_CLASS(self);
+ GisViewerClass *klass = GIS_VIEWER_GET_CLASS(viewer);
if (!klass->set_height_func)
g_warning("GisViewer: set_height_func - Unimplemented");
- klass->set_height_func(self, tile, height_func, user_data, update);
+ klass->set_height_func(viewer, tile, height_func, user_data, update);
}
-gpointer gis_viewer_add(GisViewer *self, GisObject *object,
+/**
+ * gis_viewer_add:
+ * @viewer: the viewer
+ * @object: the object to add
+ * @level: the level to add the object to
+ * @sort: %TRUE if the object should be depth-sorted prior to being drawn
+ *
+ * Objects which are added to the viewer will be drawn on subsequent renderings
+ * if their level of details is adequate.
+ *
+ * The @level represents the order the object should be drawn in, this is
+ * unrelated to the objects actual position in the world.
+ *
+ * Semi-transparent objects should set @sort to %TRUE so that they are rendered
+ * correctly when they overlap other semi-transparent objects.
+ *
+ * The viewer steals the objects reference. Call g_object_ref if you plan on
+ * holding a reference as well.
+ *
+ * Returns: a handle to be pass to gis_viewer_remove()
+ */
+gpointer gis_viewer_add(GisViewer *viewer, GisObject *object,
gint level, gboolean sort)
{
- GisViewerClass *klass = GIS_VIEWER_GET_CLASS(self);
+ GisViewerClass *klass = GIS_VIEWER_GET_CLASS(viewer);
if (!klass->add)
g_warning("GisViewer: add - Unimplemented");
- return klass->add(self, object, level, sort);
+ return klass->add(viewer, object, level, sort);
}
-GisObject *gis_viewer_remove(GisViewer *self, gpointer ref)
+/**
+ * gis_viewer_remove:
+ * @viewer: the viewer
+ * @ref: the handle obtained from gis_viewer_add()
+ *
+ * Remove an object from the viewer. The objects reference count is decremented
+ * prior to being removed.
+ *
+ * Returns: the #GisObject referenced by the handle
+ */
+GisObject *gis_viewer_remove(GisViewer *viewer, gpointer ref)
{
- GisViewerClass *klass = GIS_VIEWER_GET_CLASS(self);
+ GisViewerClass *klass = GIS_VIEWER_GET_CLASS(viewer);
if (!klass->remove)
g_warning("GisViewer: remove - Unimplemented");
- return klass->remove(self, ref);
+ return klass->remove(viewer, ref);
}
/****************
* GObject code *
****************/
G_DEFINE_ABSTRACT_TYPE(GisViewer, gis_viewer, GTK_TYPE_DRAWING_AREA);
-static void gis_viewer_init(GisViewer *self)
+static void gis_viewer_init(GisViewer *viewer)
{
g_debug("GisViewer: init");
/* Default values */
- self->time = g_strdup("");
- self->location[0] = 40;
- self->location[1] = -100;
- self->location[2] = 1.5*EARTH_R;
- self->rotation[0] = 0;
- self->rotation[1] = 0;
- self->rotation[2] = 0;
-
- g_object_set(self, "can-focus", TRUE, NULL);
- gtk_widget_add_events(GTK_WIDGET(self),
+ viewer->time = g_strdup("");
+ viewer->location[0] = 40;
+ viewer->location[1] = -100;
+ viewer->location[2] = 1.5*EARTH_R;
+ viewer->rotation[0] = 0;
+ viewer->rotation[1] = 0;
+ viewer->rotation[2] = 0;
+
+ g_object_set(viewer, "can-focus", TRUE, NULL);
+ gtk_widget_add_events(GTK_WIDGET(viewer),
GDK_BUTTON_PRESS_MASK |
GDK_BUTTON_RELEASE_MASK |
GDK_POINTER_MOTION_MASK |
GDK_KEY_PRESS_MASK);
- g_signal_connect(self, "key-press-event", G_CALLBACK(on_key_press), NULL);
+ g_signal_connect(viewer, "key-press-event", G_CALLBACK(on_key_press), NULL);
- g_signal_connect(self, "button-press-event", G_CALLBACK(on_button_press), NULL);
- g_signal_connect(self, "button-release-event", G_CALLBACK(on_button_release), NULL);
- g_signal_connect(self, "motion-notify-event", G_CALLBACK(on_motion_notify), NULL);
+ g_signal_connect(viewer, "button-press-event", G_CALLBACK(on_button_press), NULL);
+ g_signal_connect(viewer, "button-release-event", G_CALLBACK(on_button_release), NULL);
+ g_signal_connect(viewer, "motion-notify-event", G_CALLBACK(on_motion_notify), NULL);
- g_signal_connect(self, "location-changed", G_CALLBACK(on_view_changed), NULL);
- g_signal_connect(self, "rotation-changed", G_CALLBACK(on_view_changed), NULL);
+ g_signal_connect(viewer, "location-changed", G_CALLBACK(on_view_changed), NULL);
+ g_signal_connect(viewer, "rotation-changed", G_CALLBACK(on_view_changed), NULL);
}
static void gis_viewer_finalize(GObject *gobject)
{
g_debug("GisViewer: finalize");
- GisViewer *self = GIS_VIEWER(gobject);
- g_free(self->time);
+ GisViewer *viewer = GIS_VIEWER(gobject);
+ g_free(viewer->time);
G_OBJECT_CLASS(gis_viewer_parent_class)->finalize(gobject);
}
static void gis_viewer_class_init(GisViewerClass *klass)
g_debug("GisViewer: class_init");
GObjectClass *gobject_class = G_OBJECT_CLASS(klass);
gobject_class->finalize = gis_viewer_finalize;
+
+ /**
+ * GisViewer::time-changed:
+ * @viewer: the viewer.
+ * @time: a string representation of the time.
+ *
+ * The ::time-changed signal is emitted when the viewers current time
+ * changers.
+ */
signals[SIG_TIME_CHANGED] = g_signal_new(
"time-changed",
G_TYPE_FROM_CLASS(gobject_class),
G_TYPE_NONE,
1,
G_TYPE_STRING);
+
+ /**
+ * GisViewer::location-changed:
+ * @viewer: the viewer.
+ * @lat: the new latitude.
+ * @lon: the new longitude.
+ * @elev: the new elevation.
+ *
+ * The ::location-changed signal is emitted when the viewers camera
+ * location changes.
+ */
signals[SIG_LOCATION_CHANGED] = g_signal_new(
"location-changed",
G_TYPE_FROM_CLASS(gobject_class),
G_TYPE_DOUBLE,
G_TYPE_DOUBLE,
G_TYPE_DOUBLE);
+
+ /**
+ * GisViewer::rotation-changed:
+ * @viewer: the viewer.
+ * @x: rotation new around the x axes.
+ * @y: rotation new around the y axes.
+ * @z: rotation new around the z axes.
+ *
+ * The ::rotation-changed signal is emitted when the viewers cameras
+ * rotation changes.
+ */
signals[SIG_ROTATION_CHANGED] = g_signal_new(
"rotation-changed",
G_TYPE_FROM_CLASS(gobject_class),
G_TYPE_DOUBLE,
G_TYPE_DOUBLE,
G_TYPE_DOUBLE);
+
+ /**
+ * GisViewer::refresh:
+ * @viewer: the viewer.
+ *
+ * The ::refresh signal is emitted when a refresh is needed. If you are
+ * using real-time data from a remote server, you should connect to the
+ * refresh signal and update the data when necessary.
+ */
signals[SIG_REFRESH] = g_signal_new(
"refresh",
G_TYPE_FROM_CLASS(gobject_class),
g_cclosure_marshal_VOID__VOID,
G_TYPE_NONE,
0);
+
+ /**
+ * GisViewer::offline:
+ * @viewer: the viewer.
+ * @offline: %TRUE if the viewer going offline.
+ *
+ * The ::offline signal is emitted when the viewers offline mode
+ * changes.
+ */
signals[SIG_OFFLINE] = g_signal_new(
"offline",
G_TYPE_FROM_CLASS(gobject_class),