CGImageMetadataSetValueMatchingImageProperty(_:_:_:_:)
Updates the value of the metadata tag assigned to the specified image property.
Declaration
func CGImageMetadataSetValueMatchingImageProperty(_ metadata: CGMutableImageMetadata, _ dictionaryName: CFString, _ propertyName: CFString, _ value: CFTypeRef) -> BoolParameters
- metadata:
The metadata object that contains the tag.
- dictionaryName:
The metadata subdictionary to which the image property belongs. For example, specify Kcgimagepropertyexifdictionary for image properties that are part of the image’s EXIF metadata. This function doesn’t support all dictionaries.
- propertyName:
The name of the property. For example, specify Kcgimagepropertytifforientation, Kcgimagepropertyexifdatetimeoriginal, or Kcgimagepropertyiptckeywords. If the specified property is unsupported by the metadata object, this function logs a warning.
- value:
The new value for the property. The new value’s type must match the XMP type of the metadata tag.
Return Value
true if this function set the tag successfully, or false if a problem occurred.
Discussion
Use this function to update the value of a property in the specified metadata collection. If you try to set the value of an EXIF or IPTC property, this function matches it to an appropriate XMP tag. For example, when you set the value of the kCGImagePropertyExifDateTimeOriginal property, this function sets the value of the photoshop:DateTime XMP tag.
If the metdata object doesn’t contain the tag, this function creates it and populates it with appropriate XMP information.