![]() |
Ansel 0.0
A darktable fork - bloat + design vision
|
main.meta_data: the free-text image metadata (title, description, creator, publisher, rights, notes, version name). More...
#include <glib.h>#include <stdint.h>Go to the source code of this file.
Data Structures | |
| struct | dt_metadata_row_t |
Typedefs | |
| typedef struct dt_metadata_row_t | dt_metadata_row_t |
| typedef void(* | dt_metadata_repository_row_cb) (void *user_data, const int keyid, const char *value) |
| One main.meta_data row: its key id and its value. | |
| typedef void(* | dt_metadata_repository_selected_cb) (void *user_data, const int keyid, const char *value, const uint32_t count) |
| One distinct (key, value) across the selection, and how many selected images carry it. | |
Functions | |
| G_BEGIN_DECLS GList * | dt_metadata_repository_get_values (const int32_t imgid, const int keyid) |
Values stored under keyid, ordered by value. | |
| GList * | dt_metadata_repository_get_all (const int32_t imgid) |
Every (key, value) pair of imgid, as a flat list. | |
| void | dt_metadata_repository_remove (const int32_t imgid, const char *keyid_list) |
Delete the rows of imgid whose key is in keyid_list, a comma-separated list of decimal key ids. Does nothing when keyid_list is NULL. | |
| void | dt_metadata_repository_add (const dt_metadata_row_t *rows, const size_t count) |
Insert count rows as a single multi-VALUES statement. | |
| int32_t | dt_metadata_repository_find_image_by_value (const char *value) |
The first image carrying value under any key, or -1. | |
| void | dt_metadata_repository_foreach (const int32_t imgid, dt_metadata_repository_row_cb cb, void *user_data) |
Every metadata row of imgid, in row order. | |
| void | dt_metadata_repository_foreach_selected (dt_metadata_repository_selected_cb cb, void *user_data) |
| Every distinct (key, value) pair across main.selected_images, ordered by value. | |
| void | dt_metadata_repository_cleanup (void) |
| Finalise the prepared statements. See dt_colorlabel_repository_cleanup(). | |
main.meta_data: the free-text image metadata (title, description, creator, publisher, rights, notes, version name).
One row per (image, key, value), key being a dt_metadata_t index rather than a name – the names live in common/metadata.c, which owns the mapping, the XMP spellings and the visibility flags.
Definition in file metadata_repository.h.
One main.meta_data row: its key id and its value.
Definition at line 96 of file metadata_repository.h.
| typedef void(* dt_metadata_repository_selected_cb) (void *user_data, const int keyid, const char *value, const uint32_t count) |
One distinct (key, value) across the selection, and how many selected images carry it.
Definition at line 104 of file metadata_repository.h.
| typedef struct dt_metadata_row_t dt_metadata_row_t |
One (image, key, value) row to insert.
| void dt_metadata_repository_add | ( | const dt_metadata_row_t * | rows, |
| const size_t | count ) |
Insert count rows as a single multi-VALUES statement.
Quoting is done here, with sqlite3_mprintf("q", …). It used to be done by the caller, which is why common/metadata.c linked against sqlite for one function call: a module that has to escape its own strings for SQL is still writing SQL. Nothing happens when count is 0.
Definition at line 106 of file metadata_repository.c.
References dt_database_get_sqlite3_global(), DT_DEBUG_SQLITE3_PREPARE_V2, dt_free, i, IS_NULL_PTR, TRUE, and value.
Referenced by _bulk_add_metadata(), _seed_every_table(), and test_metadata_foreach_selected().
Finalise the prepared statements. See dt_colorlabel_repository_cleanup().
Definition at line 184 of file metadata_repository.c.
Referenced by dt_metadata_cleanup(), and testdb_teardown().
| int32_t dt_metadata_repository_find_image_by_value | ( | const char * | value | ) |
The first image carrying value under any key, or -1.
Used to recognise an already-imported file by the filename-datetime marker the importer stores. Matches on value alone, across every key.
Definition at line 133 of file metadata_repository.c.
References dt_database_get_sqlite3_global(), DT_DEBUG_SQLITE3_BIND_TEXT, DT_DEBUG_SQLITE3_PREPARE_V2, and value.
Referenced by dt_metadata_already_imported().
| void dt_metadata_repository_foreach | ( | const int32_t | imgid, |
| dt_metadata_repository_row_cb | cb, | ||
| void * | user_data ) |
Every metadata row of imgid, in row order.
Definition at line 149 of file metadata_repository.c.
References dt_database_get_sqlite3_global(), DT_DEBUG_SQLITE3_BIND_INT, and DT_DEBUG_SQLITE3_PREPARE_V2.
Referenced by dt_set_xmp_dt_metadata().
| void dt_metadata_repository_foreach_selected | ( | dt_metadata_repository_selected_cb | cb, |
| void * | user_data ) |
Every distinct (key, value) pair across main.selected_images, ordered by value.
One pass instead of one dt_metadata_repository_get_values() call per key, which is what the panel needs: for each field it must know both the values present and whether every selected image agrees on one – hence the count travelling with the pair.
Definition at line 163 of file metadata_repository.c.
References dt_database_get_sqlite3_global(), and DT_DEBUG_SQLITE3_PREPARE_V2.
Referenced by _refresh(), and test_metadata_foreach_selected().
| GList * dt_metadata_repository_get_all | ( | const int32_t | imgid | ) |
Every (key, value) pair of imgid, as a flat list.
Definition at line 69 of file metadata_repository.c.
References dt_database_get_sqlite3_global(), DT_DEBUG_SQLITE3_BIND_INT, DT_DEBUG_SQLITE3_PREPARE_V2, and value.
Referenced by dt_metadata_get_list_id().
| G_BEGIN_DECLS GList * dt_metadata_repository_get_values | ( | const int32_t | imgid, |
| const int | keyid ) |
Values stored under keyid, ordered by value.
| imgid | the image, or a negative value for every selected image. |
Definition at line 28 of file metadata_repository.c.
References dt_database_get_sqlite3_global(), DT_DEBUG_SQLITE3_BIND_INT, DT_DEBUG_SQLITE3_PREPARE_V2, IS_NULL_PTR, and value.
Referenced by dt_metadata_get(), and test_round_trip_restores_every_table().
| void dt_metadata_repository_remove | ( | const int32_t | imgid, |
| const char * | keyid_list ) |
Delete the rows of imgid whose key is in keyid_list, a comma-separated list of decimal key ids. Does nothing when keyid_list is NULL.
Definition at line 91 of file metadata_repository.c.
References dt_database_get_sqlite3_global(), DT_DEBUG_SQLITE3_PREPARE_V2, dt_free, and IS_NULL_PTR.
Referenced by _bulk_remove_metadata().