mirror of
https://gitlab.gnome.org/GNOME/gimp.git
synced 2025-07-03 09:23:24 +00:00
6b10cce682
when creating a new image. We add a new function `gimp_metadata_set_creation_date` to `libgimpbase/gimpmetadata` to handle setting all relevant metadata tags. We add a local function `gimp_image_new_add_creation_metadata` to add the creation date metadata to relevant functions that create new images. We write tags for both the creation date and several modified dates for IPTC, XMP and Exif metadata. All these use different ways to express date/time and timezones and I can already see we need to have another look at other places where we handle modified dates. This solves the second part of #7287, adding metadata about the date/time a new image was created.
158 lines
6.9 KiB
C
158 lines
6.9 KiB
C
/* LIBGIMPBASE - The GIMP Basic Library
|
|
* Copyright (C) 1995-1997 Peter Mattis and Spencer Kimball
|
|
*
|
|
* gimpmetadata.h
|
|
* Copyright (C) 2013 Hartmut Kuhse <hartmutkuhse@src.gnome.org>
|
|
*
|
|
* This library is free software: you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 3 of the License, or (at your option) any later version.
|
|
*
|
|
* This library 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
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library. If not, see
|
|
* <https://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef __GIMP_METADATA_H__
|
|
#define __GIMP_METADATA_H__
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
#include <gexiv2/gexiv2.h>
|
|
|
|
|
|
#define GIMP_TYPE_METADATA (gimp_metadata_get_type ())
|
|
G_DECLARE_FINAL_TYPE (GimpMetadata, gimp_metadata, GIMP, METADATA, GExiv2Metadata)
|
|
|
|
|
|
/**
|
|
* GimpMetadataLoadFlags:
|
|
* @GIMP_METADATA_LOAD_NONE: Do not load the metadata
|
|
* @GIMP_METADATA_LOAD_COMMENT: Load the comment
|
|
* @GIMP_METADATA_LOAD_RESOLUTION: Load the resolution
|
|
* @GIMP_METADATA_LOAD_ORIENTATION: Load the orientation (rotation)
|
|
* @GIMP_METADATA_LOAD_COLORSPACE: Load the colorspace
|
|
* @GIMP_METADATA_LOAD_ALL: Load all of the above
|
|
*
|
|
* What metadata to load when importing images.
|
|
**/
|
|
typedef enum
|
|
{
|
|
GIMP_METADATA_LOAD_NONE = 0,
|
|
GIMP_METADATA_LOAD_COMMENT = 1 << 0,
|
|
GIMP_METADATA_LOAD_RESOLUTION = 1 << 1,
|
|
GIMP_METADATA_LOAD_ORIENTATION = 1 << 2,
|
|
GIMP_METADATA_LOAD_COLORSPACE = 1 << 3,
|
|
|
|
GIMP_METADATA_LOAD_ALL = 0xffffffff
|
|
} GimpMetadataLoadFlags;
|
|
|
|
|
|
/**
|
|
* GimpMetadataSaveFlags:
|
|
* @GIMP_METADATA_SAVE_EXIF: Save EXIF
|
|
* @GIMP_METADATA_SAVE_XMP: Save XMP
|
|
* @GIMP_METADATA_SAVE_IPTC: Save IPTC
|
|
* @GIMP_METADATA_SAVE_THUMBNAIL: Save a thumbnail of the image
|
|
* @GIMP_METADATA_SAVE_COLOR_PROFILE: Save the image's color profile
|
|
* Since: 2.10.10
|
|
* @GIMP_METADATA_SAVE_COMMENT: Save the image's comment
|
|
* Since: 3.0
|
|
* @GIMP_METADATA_SAVE_ALL: Save all of the above
|
|
*
|
|
* What kinds of metadata to save when exporting images.
|
|
**/
|
|
typedef enum
|
|
{
|
|
GIMP_METADATA_SAVE_EXIF = 1 << 0,
|
|
GIMP_METADATA_SAVE_XMP = 1 << 1,
|
|
GIMP_METADATA_SAVE_IPTC = 1 << 2,
|
|
GIMP_METADATA_SAVE_THUMBNAIL = 1 << 3,
|
|
GIMP_METADATA_SAVE_COLOR_PROFILE = 1 << 4,
|
|
GIMP_METADATA_SAVE_COMMENT = 1 << 5,
|
|
|
|
GIMP_METADATA_SAVE_ALL = 0xffffffff
|
|
} GimpMetadataSaveFlags;
|
|
|
|
|
|
/**
|
|
* GimpMetadataColorspace:
|
|
* @GIMP_METADATA_COLORSPACE_UNSPECIFIED: Unspecified
|
|
* @GIMP_METADATA_COLORSPACE_UNCALIBRATED: Uncalibrated
|
|
* @GIMP_METADATA_COLORSPACE_SRGB: sRGB
|
|
* @GIMP_METADATA_COLORSPACE_ADOBERGB: Adobe RGB
|
|
*
|
|
* Well-defined colorspace information available from metadata
|
|
**/
|
|
typedef enum
|
|
{
|
|
GIMP_METADATA_COLORSPACE_UNSPECIFIED,
|
|
GIMP_METADATA_COLORSPACE_UNCALIBRATED,
|
|
GIMP_METADATA_COLORSPACE_SRGB,
|
|
GIMP_METADATA_COLORSPACE_ADOBERGB
|
|
} GimpMetadataColorspace;
|
|
|
|
|
|
GimpMetadata * gimp_metadata_new (void);
|
|
GimpMetadata * gimp_metadata_duplicate (GimpMetadata *metadata);
|
|
|
|
GimpMetadata * gimp_metadata_deserialize (const gchar *metadata_xml);
|
|
gchar * gimp_metadata_serialize (GimpMetadata *metadata);
|
|
gchar * gimp_metadata_get_guid (void);
|
|
|
|
void gimp_metadata_add_xmp_history (GimpMetadata *metadata,
|
|
gchar *state_status);
|
|
|
|
GimpMetadata * gimp_metadata_load_from_file (GFile *file,
|
|
GError **error);
|
|
gboolean gimp_metadata_save_to_file (GimpMetadata *metadata,
|
|
GFile *file,
|
|
GError **error);
|
|
|
|
gboolean gimp_metadata_set_from_exif (GimpMetadata *metadata,
|
|
const guchar *exif_data,
|
|
gint exif_data_length,
|
|
GError **error);
|
|
gboolean gimp_metadata_set_from_iptc (GimpMetadata *metadata,
|
|
const guchar *iptc_data,
|
|
gint iptc_data_length,
|
|
GError **error);
|
|
gboolean gimp_metadata_set_from_xmp (GimpMetadata *metadata,
|
|
const guchar *xmp_data,
|
|
gint xmp_data_length,
|
|
GError **error);
|
|
|
|
void gimp_metadata_set_pixel_size (GimpMetadata *metadata,
|
|
gint width,
|
|
gint height);
|
|
void gimp_metadata_set_bits_per_sample (GimpMetadata *metadata,
|
|
gint bits_per_sample);
|
|
|
|
gboolean gimp_metadata_get_resolution (GimpMetadata *metadata,
|
|
gdouble *xres,
|
|
gdouble *yres,
|
|
GimpUnit **unit);
|
|
void gimp_metadata_set_resolution (GimpMetadata *metadata,
|
|
gdouble xres,
|
|
gdouble yres,
|
|
GimpUnit *unit);
|
|
void gimp_metadata_set_creation_date (GimpMetadata *metadata,
|
|
GDateTime *datetime);
|
|
|
|
GimpMetadataColorspace
|
|
gimp_metadata_get_colorspace (GimpMetadata *metadata);
|
|
void gimp_metadata_set_colorspace (GimpMetadata *metadata,
|
|
GimpMetadataColorspace colorspace);
|
|
|
|
gboolean gimp_metadata_is_tag_supported (const gchar *tag,
|
|
const gchar *mime_type);
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GIMP_METADATA_H__ */
|