location_repository.c File Reference

#include "database/location_repository.h"
#include "database/database.h"
#include "database/sql_debug.h"
#include "system/macros.h"
#include "system/mem_alloc.h"
#include <sqlite3.h>

Include dependency graph for location_repository.c:

Go to the source code of this file.

Functions
void	dt_location_repository_delete (const guint locid)
	Drop the geometry row of locid. The tag itself is the tag repository's.
GList *	dt_location_repository_get_in_bbox (const dt_map_box_t *const bbox)
	Locations whose extent overlaps bbox.
dt_map_location_data_t *	dt_location_repository_get_data (const guint locid, const char *name_prefix)
	The geometry of locid, if it is a real location.
void	dt_location_repository_set_data (const guint locid, const dt_map_location_data_t *g)
	Insert or replace the geometry of locid, polygon blob included.
gboolean	dt_location_repository_get_polygon (const guint locid, void **blob, gint *bytes)
	The raw polygon blob of locid.
GList *	dt_location_repository_find_locations_for_image (const int32_t imgid)
	Locations whose shape contains imgid's coordinates.
GList *	dt_location_repository_find_images_for_location (const guint locid, const int shape)
	Images whose coordinates fall inside location locid.
GList *	dt_location_repository_get_image_locations (const int32_t imgid)
	Location (tag) ids currently attached to imgid. GINT_TO_POINTER list.

Function Documentation

dt_location_repository_delete()

void dt_location_repository_delete

(

const guint

locid

)

Drop the geometry row of locid. The tag itself is the tag repository's.

Definition at line 28 of file location_repository.c.

References dt_database_get_sqlite3_global(), DT_DEBUG_SQLITE3_BIND_INT, DT_DEBUG_SQLITE3_PREPARE_V2, and L.

Referenced by dt_map_location_delete().

dt_location_repository_find_images_for_location()

GList * dt_location_repository_find_images_for_location	(	const guint	locid,
		const int	shape
	)

Images whose coordinates fall inside location locid.

Parameters

shape

the location's shape, which selects the query. MAP_LOCATION_SHAPE_POLYGONS returns box-bounded candidates with their coordinates filled in.

Definition at line 227 of file location_repository.c.

References dt_database_get_sqlite3_global(), DT_DEBUG_SQLITE3_BIND_INT, DT_DEBUG_SQLITE3_PREPARE_V2, L, MAP_LOCATION_SHAPE_ELLIPSE, and MAP_LOCATION_SHAPE_RECTANGLE.

Referenced by _map_location_find_images().

dt_location_repository_find_locations_for_image()

GList * dt_location_repository_find_locations_for_image

(

const int32_t

imgid

)

Locations whose shape contains imgid's coordinates.

Returns

dt_location_candidate_t list; polygon entries are box-bounded candidates the caller must still test. Free with g_list_free_full(l, g_free).

Definition at line 183 of file location_repository.c.

References dt_database_get_sqlite3_global(), DT_DEBUG_SQLITE3_BIND_INT, DT_DEBUG_SQLITE3_PREPARE_V2, L, MAP_LOCATION_SHAPE_ELLIPSE, MAP_LOCATION_SHAPE_POLYGONS, and MAP_LOCATION_SHAPE_RECTANGLE.

Referenced by dt_map_location_find_locations().

dt_location_repository_get_data()

dt_map_location_data_t * dt_location_repository_get_data	(	const guint	locid,
		const char *	name_prefix
	)

The geometry of locid, if it is a real location.

Parameters

name_prefix

the darktable|locations| prefix a location's tag name must have. Passed in rather than known here: which tags count as locations is common/map_locations.c's definition, not the database's.

Returns

newly allocated, or NULL when there is no such location, its longitude is NULL, or its tag is not under name_prefix.

Definition at line 83 of file location_repository.c.

References dt_database_get_sqlite3_global(), DT_DEBUG_SQLITE3_BIND_INT, DT_DEBUG_SQLITE3_BIND_TEXT, DT_DEBUG_SQLITE3_PREPARE_V2, g, L, and dt_map_location_data_t::shape.

Referenced by dt_map_location_get_data().

dt_location_repository_get_image_locations()

GList * dt_location_repository_get_image_locations

(

const int32_t

imgid

)

Location (tag) ids currently attached to imgid. GINT_TO_POINTER list.

Definition at line 301 of file location_repository.c.

References dt_database_get_sqlite3_global(), DT_DEBUG_SQLITE3_BIND_INT, DT_DEBUG_SQLITE3_PREPARE_V2, and L.

Referenced by dt_map_location_update_locations().

dt_location_repository_get_in_bbox()

GList * dt_location_repository_get_in_bbox

(

const dt_map_box_t *const

bbox

)

Locations whose extent overlaps bbox.

Returns

a GList of newly allocated dt_location_draw_t, without their polygons – fetch those with dt_location_repository_get_polygon(). Free with g_list_free_full(l, g_free).

Definition at line 40 of file location_repository.c.

References bbox, dt_database_get_sqlite3_global(), DT_DEBUG_SQLITE3_BIND_DOUBLE, DT_DEBUG_SQLITE3_PREPARE_V2, L, dt_map_box_t::lat1, dt_map_box_t::lat2, dt_map_box_t::lon1, dt_map_box_t::lon2, and t.

Referenced by dt_map_location_get_locations_on_map().

dt_location_repository_get_polygon()

gboolean dt_location_repository_get_polygon	(	const guint	locid,
		void **	blob,
		gint *	bytes
	)

The raw polygon blob of locid.

Parameters

blob	receives a newly allocated copy, or NULL. Free with dt_free().
bytes	receives its size in bytes.

Returns

TRUE when a blob was found. The caller divides by sizeof(dt_geo_map_display_point_t) to get the point count – this function does not, because it hands back bytes.

Definition at line 143 of file location_repository.c.

References dt_database_get_sqlite3_global(), DT_DEBUG_SQLITE3_BIND_INT, DT_DEBUG_SQLITE3_PREPARE_V2, FALSE, IS_NULL_PTR, L, n, and TRUE.

Referenced by dt_map_location_find_locations(), and dt_map_location_get_polygons().

dt_location_repository_set_data()

void dt_location_repository_set_data	(	const guint	locid,
		const dt_map_location_data_t *	g
	)

Insert or replace the geometry of locid, polygon blob included.

Definition at line 113 of file location_repository.c.

References dt_database_get_sqlite3_global(), DT_DEBUG_SQLITE3_BIND_BLOB, DT_DEBUG_SQLITE3_BIND_DOUBLE, DT_DEBUG_SQLITE3_BIND_INT, DT_DEBUG_SQLITE3_PREPARE_V2, g, L, and MAP_LOCATION_SHAPE_POLYGONS.

Referenced by dt_map_location_set_data().