exif.h

Go to the documentation of this file.

/*
    This file is part of darktable,
    Copyright (C) 2009-2013 johannes hanika.
    Copyright (C) 2010 calca.
    Copyright (C) 2010 Henrik Andersson.
    Copyright (C) 2011-2012, 2014-2016 Tobias Ellinghaus.
    Copyright (C) 2012 Pascal de Bruijn.
    Copyright (C) 2012 Richard Wonka.
    Copyright (C) 2013 Ulrich Pegelow.
    Copyright (C) 2014 Pedro Côrte-Real.
    Copyright (C) 2014-2016 Roman Lebedev.
    Copyright (C) 2016 Matthieu Volat.
    Copyright (C) 2019, 2021 Hanno Schwalm.
    Copyright (C) 2019-2020, 2022 Philippe Weyland.
    Copyright (C) 2020 Pascal Obry.
    Copyright (C) 2021 Hubert Kowalski.
    Copyright (C) 2022 Martin Bařinka.
    Copyright (C) 2022 paolodepetrillo.
    Copyright (C) 2023, 2025 Aurélien PIERRE.
    
    darktable is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.
    
    darktable is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.
    
    You should have received a copy of the GNU General Public License
    along with darktable.  If not, see <http://www.gnu.org/licenses/>.
*/
 
#pragma once
 
#include "common/colorspaces.h"
#include "common/image.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef enum dt_dng_illuminant_t // from adobes dng_sdk
{
  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, // D  5700 - 7100K
  DT_LS_DayWhiteFluorescent  = 13, // N  4600 - 5500K
  DT_LS_CoolWhiteFluorescent = 14, // W  3800 - 4500K
  DT_LS_WhiteFluorescent     = 15, // WW 3250 - 3800K
  DT_LS_WarmWhiteFluorescent = 16, // L  2600 - 3250K
  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
} dt_dng_illuminant_t;
 
 
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);
 
#ifdef __cplusplus
}
#endif
 
// clang-format off
// modelines: These editor modelines have been set for all relevant files by tools/update_modelines.py
// vim: shiftwidth=2 expandtab tabstop=2 cindent
// kate: tab-indents: off; indent-width 2; replace-tabs on; indent-mode cstyle; remove-trailing-spaces modified;
// clang-format on