Method
GimpImagemetadata_save_prepare
since: 2.10
Declaration [src]
GimpMetadata*
gimp_image_metadata_save_prepare (
GimpImage* image,
const gchar* mime_type,
GimpMetadataSaveFlags* suggested_flags
)
Description [src]
Gets the image metadata for saving it using gimp_image_metadata_save_finish().
The suggested_flags are determined from what kind of metadata
(Exif, XMP, …) is actually present in the image and the preferences
for metadata exporting.
The calling application may still update available_flags, for
instance to follow the settings from a previous export in the same
session, or a previous export of the same image. But it should not
override the preferences without a good reason since it is a data leak.
The suggested value for GIMP_METADATA_SAVE_THUMBNAIL is determined by
whether there was a thumbnail in the previously imported image.
Available since: 2.10
Parameters
mime_type-
Type:
const gchar*The saved file’s mime-type.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. suggested_flags-
Type:
GimpMetadataSaveFlagsSuggested default values for the
flagspassed togimp_image_metadata_save_finish()The data is owned by the caller of the function.
Return value
Type: GimpMetadata
The image’s metadata, prepared for saving.
| The caller of the method takes ownership of the data, and is responsible for freeing it. |