exif.h File Reference

#include "common/colorspaces.h"
#include "common/image.h"

Include dependency graph for exif.h:

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

Go to the source code of this file.

Typedefs
typedef enum dt_dng_illuminant_t	dt_dng_illuminant_t

Enumerations
enum	dt_dng_illuminant_t {   DT_LS_Unknown = 0 ,   DT_LS_Daylight = 1 ,   DT_LS_Fluorescent = 2 ,   DT_LS_Tungsten = 3 ,   DT_LS_Flash = 4 ,   DT_LS_FineWeather = 9 ,   DT_LS_CloudyWeather = 10 ,   DT_LS_Shade = 11 ,   DT_LS_DaylightFluorescent = 12 ,   DT_LS_DayWhiteFluorescent = 13 ,   DT_LS_CoolWhiteFluorescent = 14 ,   DT_LS_WhiteFluorescent = 15 ,   DT_LS_WarmWhiteFluorescent = 16 ,   DT_LS_StandardLightA = 17 ,   DT_LS_StandardLightB = 18 ,   DT_LS_StandardLightC = 19 ,   DT_LS_D55 = 20 ,   DT_LS_D65 = 21 ,   DT_LS_D75 = 22 ,   DT_LS_D50 = 23 ,   DT_LS_ISOStudioTungsten = 24 ,   DT_LS_Other = 255 }

Functions
void	dt_exif_set_exiv2_taglist ()
const GList *	dt_exif_get_exiv2_taglist ()
int	dt_exif_read (dt_image_t *img, const char *path)
int	dt_exif_read_from_blob (dt_image_t *img, uint8_t *blob, const int size)
int	dt_exif_read_blob (uint8_t **blob, const char *path, const int32_t imgid, const int sRGB, const int out_width, const int out_height, const int dng_mode)
void	dt_exif_img_check_additional_tags (dt_image_t *img, const char *filename)
int	dt_exif_write_blob (uint8_t *blob, uint32_t size, const char *path, const int compressed)
int	dt_exif_xmp_write_with_imgpath (const struct dt_image_t *image, const char *filename, const char *imgpath)
int	dt_exif_xmp_attach_export (const int32_t imgid, const char *filename, void *metadata)
char *	dt_exif_xmp_read_string (const int32_t imgid)
int	dt_exif_xmp_read (dt_image_t *img, const char *filename, const int history_only)
int	dt_exif_get_thumbnail (const char *path, uint8_t **buffer, size_t *size, char **mime_type, int *width, int *height, int min_width)
void	dt_exif_init ()
void	dt_exif_cleanup ()
char *	dt_exif_xmp_encode (const unsigned char *input, const int len, int *output_len)
char *	dt_exif_xmp_encode_internal (const unsigned char *input, const int len, int *output_len, gboolean do_compress)
unsigned char *	dt_exif_xmp_decode (const char *input, const int len, int *output_len)
dt_colorspaces_color_profile_type_t	dt_exif_get_color_space (const uint8_t *data, size_t size)
void	dt_exif_get_datetime_taken (const uint8_t *data, size_t size, char *datetime_taken)

Typedef Documentation

dt_dng_illuminant_t

typedef enum dt_dng_illuminant_t dt_dng_illuminant_t

wrapper around exiv2, C++

Enumeration Type Documentation

dt_dng_illuminant_t

enum dt_dng_illuminant_t

wrapper around exiv2, C++

Enumerator
DT_LS_Unknown
DT_LS_Daylight
DT_LS_Fluorescent
DT_LS_Tungsten
DT_LS_Flash
DT_LS_FineWeather
DT_LS_CloudyWeather
DT_LS_Shade
DT_LS_DaylightFluorescent
DT_LS_DayWhiteFluorescent
DT_LS_CoolWhiteFluorescent
DT_LS_WhiteFluorescent
DT_LS_WarmWhiteFluorescent
DT_LS_StandardLightA
DT_LS_StandardLightB
DT_LS_StandardLightC
DT_LS_D55
DT_LS_D65
DT_LS_D75
DT_LS_D50
DT_LS_ISOStudioTungsten
DT_LS_Other

Definition at line 45 of file exif.h.

Function Documentation

dt_exif_cleanup()

void dt_exif_cleanup

(

)

Definition at line 4705 of file exif.cc.

Referenced by dt_cleanup().

dt_exif_get_color_space()

dt_colorspaces_color_profile_type_t dt_exif_get_color_space	(	const uint8_t *	data,
		size_t	size
	)

look for color space hints in data and tell the caller if it's sRGB, AdobeRGB or something else. used for mipmaps

Definition at line 4592 of file exif.cc.

References DT_COLORSPACE_ADOBERGB, DT_COLORSPACE_DISPLAY, DT_COLORSPACE_SRGB, and size.

Referenced by dt_imageio_jpeg_read_color_space().

dt_exif_get_datetime_taken()

void dt_exif_get_datetime_taken	(	const uint8_t *	data,
		size_t	size,
		char *	datetime_taken
	)

look for datetime_taken in data. used for gphoto downloads

Definition at line 4637 of file exif.cc.

References _find_datetime_taken(), read_metadata_threadsafe, and size.

dt_exif_get_exiv2_taglist()

const GList * dt_exif_get_exiv2_taglist

(

)

get the list of available tags from Exvi2 must not be freed

Definition at line 356 of file exif.cc.

dt_exif_get_thumbnail()

int dt_exif_get_thumbnail	(	const char *	path,
		uint8_t **	buffer,
		size_t *	size,
		char **	mime_type,
		int *	width,
		int *	height,
		int	min_width
	)

fetch largest exif thumbnail jpg bytestream into buffer

Get the largest possible thumbnail from the image

Definition at line 1702 of file exif.cc.

References DT_DEBUG_LIGHTTABLE, dt_print(), height, IS_NULL_PTR, read_metadata_threadsafe, size, WIDEN, and width.

Referenced by dt_imageio_large_thumbnail().

dt_exif_img_check_additional_tags()

void dt_exif_img_check_additional_tags	(	dt_image_t *	img,
		const char *	filename
	)

Reads exif tags that are not cached in the database

Definition at line 836 of file exif.cc.

References _check_dng_opcodes(), _check_usercrop(), read_metadata_threadsafe, and WIDEN.

Referenced by dt_imageio_open_rawspeed().

dt_exif_init()

void dt_exif_init

(

)

thread safe init and cleanup.

Definition at line 4665 of file exif.cc.

References dt_exif_log_handler().

Referenced by dt_init().

dt_exif_read()

int dt_exif_read	(	dt_image_t *	img,
		const char *	path
	)

read metadata from file with full path name, XMP data trumps IPTC data trumps EXIF data, store to image struct. returns 0 on success.

read the metadata of an image. XMP data trumps IPTC data trumps EXIF data

Definition at line 1753 of file exif.cc.

References _exif_decode_exif_data(), _exif_decode_iptc_data(), _exif_decode_xmp_data(), dt_datetime_unix_to_img(), DT_IMAGE_HDR, DT_IMAGE_LDR, DT_IMAGE_RAW, DT_IMAGE_S_RAW, dt_imageio_get_type_from_extension(), dt_image_t::exif_inited, dt_image_t::flags, dt_image_t::height, read_metadata_threadsafe, WIDEN, and dt_image_t::width.

Referenced by _image_import_internal(), _import_copy_file(), _set_test_path(), dt_control_refresh_exif_run(), dt_imageio_open_j2k(), dt_imageio_open_jpeg(), dt_imageio_open_png(), dt_imageio_open_rawspeed(), dt_imageio_open_tiff(), and update_preview_cb().

dt_exif_read_blob()

int dt_exif_read_blob	(	uint8_t **	blob,
		const char *	path,
		const int32_t	imgid,
		const int	sRGB,
		const int	out_width,
		const int	out_height,
		const int	dng_mode
	)

write exif to blob, return length in bytes. blob will be allocated by the function. sRGB should be true if sRGB colorspace is used as output.

Todo:

: find a nice place for the missing metadata (tags, publisher, colorlabels?). Additionally find out

Definition at line 1890 of file exif.cc.

References darktable, darktable_package_string, dt_conf_get_int(), DT_DATETIME_EXIF_LENGTH, dt_datetime_img_to_exif(), DT_DATETIME_LENGTH, dt_datetime_now_to_exif(), dt_free, dt_free_gpointer(), dt_image_cache_get(), dt_image_cache_read_release(), dt_metadata_get(), dt_remove_exif_geotag(), dt_remove_exif_keys(), dt_image_geoloc_t::elevation, dt_image_t::geoloc, i, darktable_t::image_cache, IS_NULL_PTR, dt_image_geoloc_t::latitude, dt_image_geoloc_t::longitude, read_metadata_threadsafe, sRGB, and WIDEN.

Referenced by dt_control_merge_hdr_job_run(), and dt_imageio_export_with_flags().

dt_exif_read_from_blob()

int dt_exif_read_from_blob	(	dt_image_t *	img,
		uint8_t *	blob,
		const int	size
	)

read exif data to image struct from given data blob, wherever you got it from.

Todo:

: can this blob also contain xmp and iptc data?

Definition at line 1682 of file exif.cc.

References _exif_decode_exif_data(), dt_image_t::filename, and size.

Referenced by dt_imageio_open_exr().

dt_exif_set_exiv2_taglist()

void dt_exif_set_exiv2_taglist

(

)

set the list of available tags from Exvi2

Definition at line 266 of file exif.cc.

References _get_exiv2_type(), _get_xmp_tags(), dt_util_dstrcat(), and exiv2_taglist.

Referenced by dt_exif_get_exiv2_taglist(), and dt_init().

dt_exif_write_blob()

int dt_exif_write_blob	(	uint8_t *	blob,
		uint32_t	size,
		const char *	path,
		const int	compressed
	)

write blob to file exif. merges with existing exif information.

Definition at line 1816 of file exif.cc.

References dt_remove_exif_keys(), i, key, read_metadata_threadsafe, size, and WIDEN.

Referenced by dt_imageio_write_dng(), write_image(), write_image(), write_image(), and write_image().

dt_exif_xmp_attach_export()

int dt_exif_xmp_attach_export	(	const int32_t	imgid,
		const char *	filename,
		void *	metadata
	)

write xmp packet inside an image.

Todo:

if an element of the list contains a ", " it is not correctly exported

Definition at line 4241 of file exif.cc.

References _exif_get_exiv2_tag_type(), _exif_read_exif_tag(), _exif_xmp_read_data_export(), _remove_xmp_keys(), dt_free, dt_image_full_path(), dt_image_path_append_version(), DT_META_EXIF, DT_META_GEOTAG, dt_remove_exif_geotag(), dt_remove_exif_key(), dt_remove_iptc_key(), dt_remove_known_keys(), dt_remove_xmp_key(), dt_remove_xmp_keys(), dt_variables_expand(), dt_variables_params_destroy(), dt_variables_params_init(), dt_variables_set_tags_flags(), FALSE, i, IS_NULL_PTR, key, m, PATH_MAX, read_metadata_threadsafe, TRUE, type, and WIDEN.

Referenced by dt_imageio_export_with_flags().

dt_exif_xmp_decode()

unsigned char * dt_exif_xmp_decode	(	const char *	input,
		const int	len,
		int *	output_len
	)

Definition at line 2337 of file exif.cc.

References dt_free, factor, i, IS_NULL_PTR, and TO_BINARY.

Referenced by add_preset(), dt_exif_xmp_read(), dt_presets_import_from_file(), dt_style_plugin_save(), init_presets(), read_history_v1(), read_history_v2(), read_masks(), and read_masks_v3().

dt_exif_xmp_encode()

char * dt_exif_xmp_encode	(	const unsigned char *	input,
		const int	len,
		int *	output_len
	)

encode / decode op params

Definition at line 2246 of file exif.cc.

References COMPRESS_THRESHOLD, dt_conf_get_string(), dt_exif_xmp_encode_internal(), dt_free, FALSE, and TRUE.

Referenced by _exif_xmp_append_history_hash(), _init_presets(), dt_preset_encode(), dt_set_xmp_dt_history(), and dt_style_encode().

dt_exif_xmp_encode_internal()

char * dt_exif_xmp_encode_internal	(	const unsigned char *	input,
		const int	len,
		int *	output_len,
		gboolean	do_compress
	)

Definition at line 2272 of file exif.cc.

References dt_free, factor, i, IS_NULL_PTR, and MIN.

Referenced by dt_exif_xmp_encode(), encode_colorchecker(), and encode_tonecurve().

dt_exif_xmp_read()

int dt_exif_xmp_read	(	dt_image_t *	img,
		const char *	filename,
		const int	history_only
	)

read xmp sidecar file.

Todo:

: make this configurable? or remove it altogether?

Definition at line 3105 of file exif.cc.

References _exif_decode_xmp_data(), add_mask_entries_to_db(), add_mask_entry_to_db(), add_non_clone_mask_entries_to_db(), history_entry_t::blendop_params, history_entry_t::blendop_params_len, history_entry_t::blendop_version, darktable, darktable_t::db, dt_database_get(), dt_database_release_transaction, dt_database_rollback_transaction(), dt_database_start_transaction, DT_DEBUG_SQLITE3_BIND_INT, DT_DEBUG_SQLITE3_PREPARE_V2, dt_deprecated(), dt_exif_xmp_decode(), dt_free, dt_free_gpointer(), dt_history_db_delete_history(), dt_history_db_delete_masks_history(), dt_history_db_get_next_history_num(), dt_history_db_shift_history_nums(), dt_history_db_write_history_item(), dt_history_set_end(), DT_IMAGE_AUTO_PRESETS_APPLIED, DT_IMAGE_NO_LEGACY_PRESETS, DT_IOP_ORDER_ANSEL_RAW, DT_IOP_ORDER_LEGACY, dt_ioppr_deserialize_text_iop_order_list(), dt_ioppr_get_iop_order_link(), dt_ioppr_get_iop_order_list_version(), dt_ioppr_write_iop_order_list(), dt_sort_iop_list_by_order_f(), history_entry_t::enabled, FALSE, dt_image_t::flags, free_history_entry(), free_mask_entry(), dt_image_t::history_hash, dt_image_t::id, dt_iop_order_entry_t::instance, history_entry_t::iop_order, dt_iop_order_entry_t::iop_order_f, dt_image_raw_parameters_t::legacy, dt_image_t::legacy_flip, MIN, history_entry_t::modversion, history_entry_t::multi_name, history_entry_t::multi_priority, history_entry_t::num, dt_iop_order_entry_t::o, history_entry_t::operation, dt_iop_order_entry_t::operation, out, history_entry_t::params, history_entry_t::params_len, read_history_v1(), read_history_v2(), read_masks(), read_masks_v3(), read_metadata_threadsafe, read_xmp_timestamps(), TRUE, dt_image_raw_parameters_t::user_flip, and WIDEN.

Referenced by _history_load_and_apply_apply(), _image_import_internal(), dt_image_read_duplicates(), and main().

dt_exif_xmp_read_string()

char * dt_exif_xmp_read_string

(

const int32_t

imgid

)

get the xmp blob for imgid.

Definition at line 4116 of file exif.cc.

References _exif_xmp_read_data(), dt_image_full_path(), dt_image_path_append_version(), dt_remove_known_keys(), ERROR_CODE, FALSE, PATH_MAX, and WIDEN.

Referenced by write_image(), and write_image().

dt_exif_xmp_write_with_imgpath()

int dt_exif_xmp_write_with_imgpath	(	const struct dt_image_t *	image,
		const char *	filename,
		const char *	imgpath
	)

write xmp sidecar file.