callisto-debian/gimp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

libgimp: update gimp_image_metadata_save_prepare() description.

Browse Source 
The returned flags should not be called "suggested" flags anymore.
Having metadata available in the work image does not mean we want them
exported absolutely, which can be a security risk, especially for the
metadata which are there from the imported image.
This commit is contained in:
Jehan
2018-01-11 00:44:46 +01:00
parent 096debb0fd
commit 5e3d4cf131
1 changed files with 5 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
libgimp/gimpimagemetadata.c
View File

@ -202,16 +202,19 @@ gimp_image_metadata_load_finish (gint32 image_ID,
* gimp_image_metadata_save_prepare: * gimp_image_metadata_save_prepare:
* @image_ID: The image * @image_ID: The image
* @mime_type: The saved file's mime-type * @mime_type: The saved file's mime-type
* @suggested_flags: Suggested default values for the @flags passed to * @available_flags: Value of @flags which would save all available
* metadata in @image_ID when passed to
* gimp_image_metadata_save_finish() * gimp_image_metadata_save_finish()
* *
* Gets the image metadata for saving it using * Gets the image metadata for saving it using
* gimp_image_metadata_save_finish(). * gimp_image_metadata_save_finish().
* *
* The @suggested_flags are determined from what kind of metadata * The @available_flags are determined from what kind of metadata
* (Exif, XMP, ...) is actually present in the image. The suggested * (Exif, XMP, ...) is actually present in the image. The suggested
* value for GIMP_METADATA_SAVE_THUMBNAIL is determined by whether * value for GIMP_METADATA_SAVE_THUMBNAIL is determined by whether
* there was a thumbnail in the previously imported image. * there was a thumbnail in the previously imported image.
* It is up to the calling application to update @available_flags in
* order to remove any unwanted metadata before exporting.
* *
* Returns: The image's metadata, prepared for saving. * Returns: The image's metadata, prepared for saving.
* *