Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 9.5   10.0   10.1   10.2   10.3   10.4   10.5   11.0   11.1   11.2    Statistic    FMM    Blog  

GMImage.SetProfile

Add or remove a named profile to/from the image.

Component Version macOS Windows Linux Server iOS SDK
GraphicsMagick 2.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "GMImage.SetProfile"; ImageRef; name; data )   More

Parameters

Parameter Description Example
ImageRef The image reference number. 1
name The string with the name of the profile. "IPTC"
data The container field value with the embedded profile file.

Result

Returns "OK" on success.

Description

Add or remove a named profile to/from the image.
Remove the profile by passing an empty container field. Valid names are "*", "8BIM", "ICM", "IPTC", "EXIF", or a user/format-defined profile name.

Examples

Remove XMP:

Set Variable [$Result; Value:MBS( "GMImage.SetProfile"; $imageRef; "XMP"; "" )]

Remove IPTC:

Set Variable [$Result; Value:MBS( "GMImage.SetProfile"; $imageRef; "IPTC"; "" )]

Remove EXIF:

Set Variable [$Result; Value:MBS( "GMImage.SetProfile"; $imageRef; "EXIF"; "" )]

Clear all profiles:

Set Variable [ $Image ; Value: MBS("GMImage.NewFromContainer"; MyTable::BMPContainer) ]
# remove metadata
Set Variable [$Result; Value:MBS( "GMImage.SetProfile"; $Image; "EXIF"; "" )]
Set Variable [$Result; Value:MBS( "GMImage.SetProfile"; $Image; "IPTC"; "" )]
Set Variable [$Result; Value:MBS( "GMImage.SetProfile"; $Image; "XMP"; "" )]
# write back as JPEG
Set Variable [ $r ; Value: MBS("GMImage.SetQuality";$Image; 90) ]
Set Field [ MyTable::JPEGContainer ; MBS("GMImage.WriteToJPEGContainer"; $Image) ]
Set Variable [ $r ; Value: MBS("GMImage.Release";$Image) ]

See also

Release notes

Blog Entries

Created 18th August 2014, last changed 21st December 2018


GMImage.SetPixelColor - GMImage.SetQuality

Feedback: Report problem or ask question.