X-Git-Url: https://git.street.me.uk/andy/viking.git/blobdiff_plain/26336cf0db5532e80d37c82983338e09d7789d9d..ac150134f51cccffab083c1054cc2b071a9468f5:/src/vikmapsource.c?ds=sidebyside

diff --git a/src/vikmapsource.c b/src/vikmapsource.c
index d3a95007..d59b4163 100644
--- a/src/vikmapsource.c
+++ b/src/vikmapsource.c
@@ -31,7 +31,7 @@
 #include "vikviewport.h"
 #include "vikcoord.h"
 #include "mapcoord.h"
-
+#include "download.h"
 #include "vikmapsource.h"
 
 static void vik_map_source_init (VikMapSource *object);
@@ -40,7 +40,7 @@ static void vik_map_source_class_init (VikMapSourceClass *klass);
 
 static gboolean _supports_download_only_new (VikMapSource *object);
 
-G_DEFINE_TYPE_EXTENDED (VikMapSource, vik_map_source, G_TYPE_OBJECT, (GTypeFlags)G_TYPE_FLAG_ABSTRACT,);
+G_DEFINE_ABSTRACT_TYPE (VikMapSource, vik_map_source, G_TYPE_OBJECT);
 
 static void
 vik_map_source_init (VikMapSource *object)
@@ -65,12 +65,21 @@ vik_map_source_class_init (VikMapSourceClass *klass)
 	klass->get_license = NULL;
 	klass->get_license_url = NULL;
 	klass->get_logo = NULL;
+	klass->get_name = NULL;
 	klass->get_uniq_id = NULL;
 	klass->get_label = NULL;
 	klass->get_tilesize_x = NULL;
 	klass->get_tilesize_y = NULL;
 	klass->get_drawmode = NULL;
+	klass->is_direct_file_access = NULL;
+	klass->is_mbtiles = NULL;
 	klass->supports_download_only_new = _supports_download_only_new;
+	klass->get_zoom_min = NULL;
+	klass->get_zoom_max = NULL;
+	klass->get_lat_min = NULL;
+	klass->get_lat_max = NULL;
+	klass->get_lon_min = NULL;
+	klass->get_lon_max = NULL;
 	klass->coord_to_mapcoord = NULL;
 	klass->mapcoord_to_center_coord = NULL;
 	klass->download = NULL;
@@ -87,17 +96,27 @@ _supports_download_only_new (VikMapSource *self)
 	return FALSE;
 }
 
-const gchar *
-vik_map_source_get_copyright (VikMapSource *self)
+/**
+ * vik_map_source_get_copyright:
+ * @self: the VikMapSource of interest.
+ * @bbox: bounding box of interest.
+ * @zoom: the zoom level of interest.
+ * @fct: the callback function to use to return matching copyrights.
+ * @data: the user data to use to call the callbaack function.
+ *
+ * Retrieve copyright(s) for the corresponding bounding box and zoom level.
+ */
+void
+vik_map_source_get_copyright (VikMapSource *self, LatLonBBox bbox, gdouble zoom, void (*fct)(VikViewport*,const gchar*), void *data)
 {
 	VikMapSourceClass *klass;
-	g_return_val_if_fail (self != NULL, NULL);
-	g_return_val_if_fail (VIK_IS_MAP_SOURCE (self), NULL);
+	g_return_if_fail (self != NULL);
+	g_return_if_fail (VIK_IS_MAP_SOURCE (self));
 	klass = VIK_MAP_SOURCE_GET_CLASS(self);
 
-	g_return_val_if_fail (klass->get_copyright != NULL, NULL);
+	g_return_if_fail (klass->get_copyright != NULL);
 
-	return (*klass->get_copyright)(self);
+	(*klass->get_copyright)(self, bbox, zoom, fct, data);
 }
 
 const gchar *
@@ -139,15 +158,28 @@ vik_map_source_get_logo (VikMapSource *self)
 	return (*klass->get_logo)(self);
 }
 
-guint8
+const gchar *
+vik_map_source_get_name (VikMapSource *self)
+{
+	VikMapSourceClass *klass;
+	g_return_val_if_fail (self != NULL, NULL);
+	g_return_val_if_fail (VIK_IS_MAP_SOURCE (self), NULL);
+	klass = VIK_MAP_SOURCE_GET_CLASS(self);
+
+	g_return_val_if_fail (klass->get_name != NULL, NULL);
+
+	return (*klass->get_name)(self);
+}
+
+guint16
 vik_map_source_get_uniq_id (VikMapSource *self)
 {
 	VikMapSourceClass *klass;
-	g_return_val_if_fail (self != NULL, (guint8 )0);
-	g_return_val_if_fail (VIK_IS_MAP_SOURCE (self), (guint8 )0);
+	g_return_val_if_fail (self != NULL, (guint16 )0);
+	g_return_val_if_fail (VIK_IS_MAP_SOURCE (self), (guint16 )0);
 	klass = VIK_MAP_SOURCE_GET_CLASS(self);
 
-	g_return_val_if_fail (klass->get_uniq_id != NULL, (guint8 )0);
+	g_return_val_if_fail (klass->get_uniq_id != NULL, (guint16 )0);
 
 	return (*klass->get_uniq_id)(self);
 }
@@ -204,6 +236,66 @@ vik_map_source_get_drawmode (VikMapSource *self)
 	return (*klass->get_drawmode)(self);
 }
 
+/**
+ * vik_map_source_is_direct_file_access:
+ * @self: the VikMapSource of interest.
+ *
+ *   Return true when we can bypass all this download malarky
+ *   Treat the files as a pre generated data set in OSM tile server layout: tiledir/%d/%d/%d.png
+ */
+gboolean
+vik_map_source_is_direct_file_access (VikMapSource * self)
+{
+	VikMapSourceClass *klass;
+	g_return_val_if_fail (self != NULL, 0);
+	g_return_val_if_fail (VIK_IS_MAP_SOURCE (self), 0);
+	klass = VIK_MAP_SOURCE_GET_CLASS(self);
+
+	g_return_val_if_fail (klass->is_direct_file_access != NULL, 0);
+
+	return (*klass->is_direct_file_access)(self);
+}
+
+/**
+ * vik_map_source_is_mbtiles:
+ * @self: the VikMapSource of interest.
+ *
+ *   Return true when the map is in an MB Tiles format.
+ *   See http://github.com/mapbox/mbtiles-spec
+ *   (Read Only ATM)
+ */
+gboolean
+vik_map_source_is_mbtiles (VikMapSource * self)
+{
+	VikMapSourceClass *klass;
+	g_return_val_if_fail (self != NULL, 0);
+	g_return_val_if_fail (VIK_IS_MAP_SOURCE (self), 0);
+	klass = VIK_MAP_SOURCE_GET_CLASS(self);
+
+	g_return_val_if_fail (klass->is_mbtiles != NULL, 0);
+
+	return (*klass->is_mbtiles)(self);
+}
+
+/**
+ * vik_map_source_is_osm_meta_tiles:
+ * @self: the VikMapSource of interest.
+ *
+ *   Treat the files as a pre generated data set directly by tirex or renderd
+ *     tiledir/Z/[xxxxyyyy]/[xxxxyyyy]/[xxxxyyyy]/[xxxxyyyy]/[xxxxyyyy].meta
+ */
+gboolean vik_map_source_is_osm_meta_tiles (VikMapSource * self)
+{
+	VikMapSourceClass *klass;
+	g_return_val_if_fail (self != NULL, 0);
+	g_return_val_if_fail (VIK_IS_MAP_SOURCE (self), 0);
+	klass = VIK_MAP_SOURCE_GET_CLASS(self);
+
+	g_return_val_if_fail (klass->is_osm_meta_tiles != NULL, 0);
+
+	return (*klass->is_osm_meta_tiles)(self);
+}
+
 gboolean
 vik_map_source_supports_download_only_new (VikMapSource * self)
 {
@@ -217,6 +309,111 @@ vik_map_source_supports_download_only_new (VikMapSource * self)
 	return (*klass->supports_download_only_new)(self);
 }
 
+/**
+ *
+ */
+guint8
+vik_map_source_get_zoom_min (VikMapSource * self)
+{
+	VikMapSourceClass *klass;
+	g_return_val_if_fail (self != NULL, 0);
+	g_return_val_if_fail (VIK_IS_MAP_SOURCE (self), 0);
+	klass = VIK_MAP_SOURCE_GET_CLASS(self);
+	g_return_val_if_fail (klass->get_zoom_min != NULL, 0);
+	return (*klass->get_zoom_min)(self);
+}
+
+/**
+ *
+ */
+guint8
+vik_map_source_get_zoom_max (VikMapSource * self)
+{
+	VikMapSourceClass *klass;
+	g_return_val_if_fail (self != NULL, 18);
+	g_return_val_if_fail (VIK_IS_MAP_SOURCE (self), 18);
+	klass = VIK_MAP_SOURCE_GET_CLASS(self);
+	g_return_val_if_fail (klass->get_zoom_max != NULL, 18);
+	return (*klass->get_zoom_max)(self);
+}
+
+/**
+ *
+ */
+gdouble
+vik_map_source_get_lat_max (VikMapSource * self)
+{
+	VikMapSourceClass *klass;
+	g_return_val_if_fail (self != NULL, 90.0);
+	g_return_val_if_fail (VIK_IS_MAP_SOURCE (self), 90.0);
+	klass = VIK_MAP_SOURCE_GET_CLASS(self);
+	g_return_val_if_fail (klass->get_lat_max != NULL, 90.0);
+	return (*klass->get_lat_max)(self);
+}
+
+/**
+ *
+ */
+gdouble
+vik_map_source_get_lat_min (VikMapSource * self)
+{
+	VikMapSourceClass *klass;
+	g_return_val_if_fail (self != NULL, -90.0);
+	g_return_val_if_fail (VIK_IS_MAP_SOURCE (self), -90.0);
+	klass = VIK_MAP_SOURCE_GET_CLASS(self);
+	g_return_val_if_fail (klass->get_lat_min != NULL, -90.0);
+	return (*klass->get_lat_min)(self);
+}
+
+/**
+ *
+ */
+gdouble
+vik_map_source_get_lon_max (VikMapSource * self)
+{
+	VikMapSourceClass *klass;
+	g_return_val_if_fail (self != NULL, 180.0);
+	g_return_val_if_fail (VIK_IS_MAP_SOURCE (self), 180.0);
+	klass = VIK_MAP_SOURCE_GET_CLASS(self);
+	g_return_val_if_fail (klass->get_lon_max != NULL, 180.0);
+	return (*klass->get_lon_max)(self);
+}
+
+/**
+ *
+ */
+gdouble
+vik_map_source_get_lon_min (VikMapSource * self)
+{
+	VikMapSourceClass *klass;
+	g_return_val_if_fail (self != NULL, -180.0);
+	g_return_val_if_fail (VIK_IS_MAP_SOURCE (self), -180.0);
+	klass = VIK_MAP_SOURCE_GET_CLASS(self);
+	g_return_val_if_fail (klass->get_lon_min != NULL, -180.0);
+	return (*klass->get_lon_min)(self);
+}
+
+/**
+ * vik_map_source_get_file_extension:
+ * @self: the VikMapSource of interest.
+ *
+ * Returns the file extension of files held on disk.
+ *  Typically .png but may be .jpg or whatever the user defines
+ *
+ */
+const gchar *
+vik_map_source_get_file_extension (VikMapSource * self)
+{
+	VikMapSourceClass *klass;
+	g_return_val_if_fail (self != NULL, NULL);
+	g_return_val_if_fail (VIK_IS_MAP_SOURCE (self), NULL);
+	klass = VIK_MAP_SOURCE_GET_CLASS(self);
+
+	g_return_val_if_fail (klass->get_file_extension != NULL, NULL);
+
+	return (*klass->get_file_extension)(self);
+}
+
 gboolean
 vik_map_source_coord_to_mapcoord (VikMapSource *self, const VikCoord *src, gdouble xzoom, gdouble yzoom, MapCoord *dest )
 {
@@ -243,7 +440,16 @@ vik_map_source_mapcoord_to_center_coord (VikMapSource *self, MapCoord *src, VikC
 	(*klass->mapcoord_to_center_coord)(self, src, dest);
 }
 
-int
+/**
+ * vik_map_source_download:
+ * @self:    The VikMapSource of interest.
+ * @src:     The map location to download
+ * @dest_fn: The filename to save the result in
+ * @handle:  Potential reusable Curl Handle (may be NULL)
+ *
+ * Returns: How successful the download was as per the type #DownloadResult_t
+ */
+DownloadResult_t
 vik_map_source_download (VikMapSource * self, MapCoord * src, const gchar * dest_fn, void *handle)
 {
 	VikMapSourceClass *klass;