metadata.h File Reference

#include <glib.h>
#include <stdint.h>

Include dependency graph for metadata.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Typedefs
typedef enum dt_metadata_t	dt_metadata_t
typedef enum dt_metadata_type_t	dt_metadata_type_t
typedef enum dt_metadata_signal_t	dt_metadata_signal_t
typedef enum dt_metadata_flag_t	dt_metadata_flag_t

Enumerations
enum	dt_metadata_t {   DT_METADATA_XMP_DC_CREATOR ,   DT_METADATA_XMP_DC_PUBLISHER ,   DT_METADATA_XMP_DC_TITLE ,   DT_METADATA_XMP_DC_DESCRIPTION ,   DT_METADATA_XMP_DC_RIGHTS ,   DT_METADATA_XMP_ACDSEE_NOTES ,   DT_METADATA_XMP_VERSION_NAME ,   DT_METADATA_XMP_IMAGE_ID ,   DT_METADATA_NUMBER }
enum	dt_metadata_type_t {   DT_METADATA_TYPE_USER ,   DT_METADATA_TYPE_OPTIONAL ,   DT_METADATA_TYPE_INTERNAL }
enum	dt_metadata_signal_t {   DT_METADATA_SIGNAL_SHOWN ,   DT_METADATA_SIGNAL_HIDDEN ,   DT_METADATA_SIGNAL_NEW_VALUE }
enum	dt_metadata_flag_t {   DT_METADATA_FLAG_HIDDEN = 1 << 0 ,   DT_METADATA_FLAG_PRIVATE = 1 << 1 ,   DT_METADATA_FLAG_IMPORTED = 1 << 2 }

Functions
unsigned int	dt_metadata_get_nb_user_metadata ()
const char *	dt_metadata_get_name_by_display_order (const uint32_t order)
dt_metadata_t	dt_metadata_get_keyid_by_display_order (const uint32_t order)
dt_metadata_t	dt_metadata_get_keyid_by_name (const char *name)
int	dt_metadata_get_type_by_display_order (const uint32_t order)
const char *	dt_metadata_get_name (const uint32_t keyid)
dt_metadata_t	dt_metadata_get_keyid (const char *key)
const char *	dt_metadata_get_key (const uint32_t keyid)
const char *	dt_metadata_get_subkey (const uint32_t keyid)
const char *	dt_metadata_get_key_by_subkey (const char *subkey)
int	dt_metadata_get_type (const uint32_t keyid)
void	dt_metadata_init ()
void	dt_metadata_set (int id, const char *key, const char *value, const gboolean undo_on)
void	dt_metadata_set_import (int id, const char *key, const char *value)
void	dt_metadata_set_list (const GList *imgs, GList *key_value, const gboolean undo_on)
void	dt_metadata_set_list_id (const GList *img, const GList *metadata, const gboolean clear_on, const gboolean undo_on)
GList *	dt_metadata_get (int id, const char *key, uint32_t *count)
GList *	dt_metadata_get_list_id (int id)
void	dt_metadata_clear (const GList *imgs, const gboolean undo_on)
int	dt_metadata_already_imported (const char *filename, const char *datetime)
void	dt_metadata_cleanup (void)

Typedef Documentation

dt_metadata_flag_t

typedef enum dt_metadata_flag_t dt_metadata_flag_t

dt_metadata_signal_t

typedef enum dt_metadata_signal_t dt_metadata_signal_t

dt_metadata_t

typedef enum dt_metadata_t dt_metadata_t

dt_metadata_type_t

typedef enum dt_metadata_type_t dt_metadata_type_t

Enumeration Type Documentation

dt_metadata_flag_t

enum dt_metadata_flag_t

Enumerator
DT_METADATA_FLAG_HIDDEN
DT_METADATA_FLAG_PRIVATE
DT_METADATA_FLAG_IMPORTED

Definition at line 77 of file metadata.h.

dt_metadata_signal_t

enum dt_metadata_signal_t

Enumerator
DT_METADATA_SIGNAL_SHOWN
DT_METADATA_SIGNAL_HIDDEN
DT_METADATA_SIGNAL_NEW_VALUE

Definition at line 69 of file metadata.h.

dt_metadata_t

enum dt_metadata_t

Enumerator
DT_METADATA_XMP_DC_CREATOR
DT_METADATA_XMP_DC_PUBLISHER
DT_METADATA_XMP_DC_TITLE
DT_METADATA_XMP_DC_DESCRIPTION
DT_METADATA_XMP_DC_RIGHTS
DT_METADATA_XMP_ACDSEE_NOTES
DT_METADATA_XMP_VERSION_NAME
DT_METADATA_XMP_IMAGE_ID
DT_METADATA_NUMBER

Definition at line 44 of file metadata.h.

dt_metadata_type_t

enum dt_metadata_type_t

Enumerator
DT_METADATA_TYPE_USER
DT_METADATA_TYPE_OPTIONAL
DT_METADATA_TYPE_INTERNAL

Definition at line 61 of file metadata.h.

Function Documentation

dt_metadata_already_imported()

int dt_metadata_already_imported	(	const char *	filename,
		const char *	datetime
	)

Return the first imgid of the filename-datetime "Xmp.darktable.image_id" if it already exists

Definition at line 694 of file metadata/metadata.c.

References dt_free, dt_metadata_repository_find_image_by_value(), FALSE, IS_NULL_PTR, and UNKNOWN_IMAGE.

Referenced by _is_in_library_by_metadata().

dt_metadata_cleanup()

void dt_metadata_cleanup

(

void

)

cleanup cached statements

Definition at line 414 of file metadata/metadata.c.

References dt_metadata_repository_cleanup().

Referenced by dt_cleanup().

dt_metadata_clear()

void dt_metadata_clear	(	const GList *	imgs,
		const gboolean	undo_on
	)

Remove metadata from specific images, or all selected for id == -1.

Definition at line 637 of file metadata/metadata.c.

References _metadata_execute(), _metadata_undo_data_free(), _pop_undo(), dt_conf_get_int(), dt_free, dt_free_gpointer(), DT_MA_REMOVE, DT_METADATA_FLAG_HIDDEN, dt_metadata_get_name(), dt_metadata_get_type(), DT_METADATA_NUMBER, DT_METADATA_TYPE_INTERNAL, dt_undo_end_group(), dt_undo_get_global(), DT_UNDO_METADATA, dt_undo_record(), dt_undo_start_group(), i, and name.

Referenced by dt_exif_decode_xmp_data().

dt_metadata_get()

GList * dt_metadata_get	(	int	id,
		const char *	key,
		uint32_t *	count
	)

Get metadata (named keys) for a specific image, or all selected for id == -1. For keys which return a string, the caller has to make sure that it is freed after usage.

Definition at line 380 of file metadata/metadata.c.

References dt_colorlabel_repository_get_list(), dt_image_repository_get_ratings(), dt_metadata_get_keyid(), dt_metadata_repository_get_values(), dt_tag_repository_get_attached_names(), IS_NULL_PTR, and key.

Referenced by _expand_image_and_version(), _expand_rating_and_metadata(), _metadata_view_update_values(), _print_button_clicked(), _write_xmp_id(), dt_exif_read_blob(), and store().

dt_metadata_get_key()

const char * dt_metadata_get_key

(

const uint32_t

keyid

)

return the key of the metadata keyid

Definition at line 159 of file metadata/metadata.c.

References dt_metadata_def, and DT_METADATA_NUMBER.

Referenced by _metadata_set_list(), _metadata_view_update_values(), _xmp_append_metadata(), dt_exif_decode_xmp_data(), and set_params().

dt_metadata_get_key_by_subkey()

const char * dt_metadata_get_key_by_subkey

(

const char *

subkey

)

return the key of the metadata subkey

Definition at line 177 of file metadata/metadata.c.

References dt_metadata_def, DT_METADATA_NUMBER, i, key, and t.

dt_metadata_get_keyid()

dt_metadata_t dt_metadata_get_keyid

(

const char *

key

)

return the keyid of the metadata key

Definition at line 148 of file metadata/metadata.c.

References dt_metadata_def, DT_METADATA_NUMBER, i, IS_NULL_PTR, and key.

Referenced by dt_metadata_get(), dt_metadata_set(), dt_metadata_set_import(), and dt_metadata_set_list().

dt_metadata_get_keyid_by_display_order()

dt_metadata_t dt_metadata_get_keyid_by_display_order

(

const uint32_t

order

)

return the metadata keyid by display order

Definition at line 103 of file metadata/metadata.c.

References display_order, dt_metadata_def, DT_METADATA_NUMBER, and i.

Referenced by _get_label(), _is_metadata_ui(), _metadata_set_list(), _metadata_view_update_values(), _populate_collect_combo(), _refresh(), dt_collection_get_property_values(), dt_collection_query_get_property_values(), get_params(), and get_query_string().

dt_metadata_get_keyid_by_name()

dt_metadata_t dt_metadata_get_keyid_by_name

(

const char *

name

)

return the metadata keyid by name

Definition at line 116 of file metadata/metadata.c.

References dt_metadata_def, DT_METADATA_NUMBER, i, IS_NULL_PTR, and name.

dt_metadata_get_list_id()

GList * dt_metadata_get_list_id

(

int

id

)

Get metadata (id keys) for a specific image. The caller has to free the list after usage.

Definition at line 341 of file metadata/metadata.c.

References dt_metadata_repository_get_all().

Referenced by _metadata_execute().

dt_metadata_get_name()

const char * dt_metadata_get_name

(

const uint32_t

keyid

)

return the metadata name of the metadata keyid

Definition at line 140 of file metadata/metadata.c.

References dt_metadata_def, and DT_METADATA_NUMBER.

Referenced by _get_label(), _populate_collect_combo(), _xmp_append_metadata(), dt_collection_get_property_values(), dt_metadata_clear(), dt_metadata_init(), and dt_metadata_set_import().

dt_metadata_get_name_by_display_order()

const char * dt_metadata_get_name_by_display_order

(

const uint32_t

order

)

return the metadata key by display order

Definition at line 90 of file metadata/metadata.c.

References display_order, dt_metadata_def, DT_METADATA_NUMBER, and i.

Referenced by _menuitem_preferences(), _update_layout(), dt_collection_name(), gui_init(), and gui_reset().

dt_metadata_get_nb_user_metadata()

unsigned int dt_metadata_get_nb_user_metadata

(

)

return the number of user metadata (!= DT_METADATA_TYPE_INTERNAL)

Definition at line 79 of file metadata/metadata.c.

References dt_metadata_def, DT_METADATA_NUMBER, DT_METADATA_TYPE_INTERNAL, i, and type.

Referenced by add_rights_preset().

dt_metadata_get_subkey()

const char * dt_metadata_get_subkey

(

const uint32_t

keyid

)

return the metadata subeky of the metadata keyid

Definition at line 167 of file metadata/metadata.c.

References dt_metadata_def, DT_METADATA_NUMBER, key, and t.

dt_metadata_get_type()

int dt_metadata_get_type

(

const uint32_t

keyid

)

return the type of the metadata keyid

Definition at line 191 of file metadata/metadata.c.

References dt_metadata_def, and DT_METADATA_NUMBER.

Referenced by _is_metadata_ui(), _menuitem_preferences(), _metadata_set_list(), _metadata_view_update_values(), _populate_collect_combo(), _refresh(), _xmp_append_metadata(), dt_metadata_clear(), dt_metadata_init(), and dt_metadata_set_import().

dt_metadata_get_type_by_display_order()

int dt_metadata_get_type_by_display_order

(

const uint32_t

order

)

return the metadata type by display order

Definition at line 127 of file metadata/metadata.c.

References display_order, dt_metadata_def, DT_METADATA_NUMBER, and i.

Referenced by _menuitem_preferences(), _update_layout(), dt_collection_name(), get_params(), gui_cleanup(), gui_init(), gui_reset(), and set_params().

dt_metadata_init()

void dt_metadata_init

(

)

init metadata flags

Definition at line 199 of file metadata/metadata.c.

References dt_conf_key_exists(), dt_conf_set_int(), dt_free, DT_METADATA_FLAG_HIDDEN, DT_METADATA_FLAG_IMPORTED, dt_metadata_get_name(), dt_metadata_get_type(), DT_METADATA_NUMBER, DT_METADATA_TYPE_OPTIONAL, flag, i, name, and type.

Referenced by dt_init().

dt_metadata_set()

void dt_metadata_set	(	int	id,
		const char *	key,
		const char *	value,
		const gboolean	undo_on
	)

Set metadata for a specific image, or all selected for id == -1.

dt_metadata_set_import()

void dt_metadata_set_import	(	int	id,
		const char *	key,
		const char *	value
	)

Set imported metadata for a specific image

dt_metadata_set_list()

void dt_metadata_set_list	(	const GList *	imgs,
		GList *	key_value,
		const gboolean	undo_on
	)

Set metadata (named keys) for a specific image, or all selected for id == -1. list is a set of key, value

Definition at line 592 of file metadata/metadata.c.

References _cleanup_metadata_value(), _metadata_execute(), _metadata_undo_data_free(), _pop_undo(), dt_free_gpointer(), DT_MA_ADD, dt_metadata_get_keyid(), dt_undo_end_group(), dt_undo_get_global(), DT_UNDO_METADATA, dt_undo_record(), dt_undo_start_group(), key, and value.

Referenced by _write_metadata(), and set_params().

dt_metadata_set_list_id()

void dt_metadata_set_list_id	(	const GList *	img,
		const GList *	metadata,
		const gboolean	clear_on,
		const gboolean	undo_on
	)

Set metadata (id keys) for a list of images. list is a set of keyid, value if clear_on TRUE the image metadata are cleared before attaching the new ones

Definition at line 676 of file metadata/metadata.c.

References _metadata_execute(), _metadata_undo_data_free(), _pop_undo(), DT_MA_ADD, DT_MA_SET, dt_undo_end_group(), dt_undo_get_global(), DT_UNDO_METADATA, dt_undo_record(), and dt_undo_start_group().