[QA] Reusable function for freeing the waypoint image cache.

[andy/viking.git] / src / vikroutingengine.c

diff --git a/src/vikroutingengine.c b/src/vikroutingengine.c
index 5e20b4a1c02b70b03159a99371585412a17b90bc..00b8689a529d543149bd5bae6f1766ea23ac8b68 100644 (file)
--- a/src/vikroutingengine.c
+++ b/src/vikroutingengine.c
@@ -141,8 +141,12 @@ vik_routing_engine_class_init ( VikRoutingEngineClass *klass )
 
   routing_class = VIK_ROUTING_ENGINE_CLASS ( klass );
   routing_class->find = NULL;
+
   routing_class->supports_direction = NULL;
-  routing_class->get_cmd_from_directions = NULL;
+  routing_class->get_url_from_directions = NULL;
+
+  routing_class->refine = NULL;
+  routing_class->supports_refine = NULL;
 
   pspec = g_param_spec_string ("id",
                                "Identifier",
@@ -206,7 +210,7 @@ vik_routing_engine_finalize ( GObject *self )
  * 
  * Returns: indicates success or not.
  */
-int
+gboolean
 vik_routing_engine_find ( VikRoutingEngine *self, VikTrwLayer *vtl, struct LatLon start, struct LatLon end )
 {
        VikRoutingEngineClass *klass;
@@ -277,23 +281,67 @@ vik_routing_engine_supports_direction ( VikRoutingEngine *self )
 }
 
 /**
- * vik_routing_engine_get_cmd_from_directions:
+ * vik_routing_engine_get_url_from_directions:
  * @self: routing engine
  * @start: the start direction
  * @end: the end direction
  *
- * Compute a "cmd" for acquire framework.
+ * Compute the URL used with the acquire framework.
  *
- * Returns: the computed cmd
+ * Returns: the computed URL
  */
 gchar *
-vik_routing_engine_get_cmd_from_directions ( VikRoutingEngine *self, const gchar *start, const gchar *end )
+vik_routing_engine_get_url_from_directions ( VikRoutingEngine *self, const gchar *start, const gchar *end )
 {
   VikRoutingEngineClass *klass;
 
   g_return_val_if_fail ( VIK_IS_ROUTING_ENGINE (self), NULL );
   klass = VIK_ROUTING_ENGINE_GET_CLASS( self );
-  g_return_val_if_fail ( klass->get_cmd_from_directions != NULL, NULL );
+  g_return_val_if_fail ( klass->get_url_from_directions != NULL, NULL );
+
+  return klass->get_url_from_directions( self, start, end );
+}
+
+/**
+ * vik_routing_engine_refine:
+ * @self: self object
+ * @vtl: layer where to create new track
+ * @vt: the simple route to refine
+ *
+ * Retrieve a route refining the @vt track/route.
+ *
+ * A refined route is computed from @vt.
+ * The route is computed from first trackpoint to last trackpoint,
+ * and going via all intermediate trackpoints.
+ *
+ * Returns: indicates success or not.
+ */
+gboolean
+vik_routing_engine_refine ( VikRoutingEngine *self, VikTrwLayer *vtl, VikTrack *vt )
+{
+  VikRoutingEngineClass *klass;
+
+  g_return_val_if_fail ( VIK_IS_ROUTING_ENGINE (self), 0 );
+  klass = VIK_ROUTING_ENGINE_GET_CLASS ( self );
+  g_return_val_if_fail ( klass->refine != NULL, 0 );
+
+  return klass->refine ( self, vtl, vt );
+}
+
+/**
+ * vik_routing_engine_supports_refine:
+ * @self: routing engine
+ *
+ * Returns: %TRUE if this engine supports the refine of track
+ */
+gboolean
+vik_routing_engine_supports_refine ( VikRoutingEngine *self )
+{
+  VikRoutingEngineClass *klass;
+
+  g_return_val_if_fail ( VIK_IS_ROUTING_ENGINE (self), FALSE );
+  klass = VIK_ROUTING_ENGINE_GET_CLASS ( self );
+  g_return_val_if_fail ( klass->supports_refine != NULL, FALSE );
 
-  return klass->get_cmd_from_directions( self, start, end );
+  return klass->supports_refine ( self );
 }