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.1   9.2   9.3   9.4   9.5   10.0   10.1   10.2   10.3   10.4    Statistic  


Sets the value for a property.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
CGImageSource 9.4 Yes No Yes, macOS only No Yes
MBS( "CGImageSource.SetProperty"; Ref; Index; Key; Value { ; Type } )   More


Parameter Description Example value
Ref The image source reference number returned by CGImageSource.CreateWithData, CGImageSource.CreateWithPath or CGImageSource.CreateWithURL $ref
Index The index of the image to query. -1 for global properties. Else a number from 0 to CGImageSource.Count-1. 0
Key The property name to query. "PixelWidth"
Value The value to use.
Can be text, timestamp, boolean or number.
Type Optional
Available in MBS FileMaker Plugin 10.3 or newer.
Which data type to use.
Default is to auto to pick data type based on FileMaker data type.
Can be "auto", "text", "number" or "array".
For keywords, pass a list of values, which we pass as array.


Returns OK or error.


Sets the value for a property.
You may need to use CGImageSource.Export to actually write an image with new metadata.
The creation of new property dictionary is implemented for version 10.2, so you can create new sections like GPS.


Set keywords:

MBS("CGImageSource.SetProperty"; $ref; 0; "{IPTC}.Keywords"; "First¶Second¶Third"; "Array")

See also

Example Databases

Blog Entries

Release notes

Created 30th August 2019, last changed 19th June 2020

CGImageSource.Release   -   CGImageSource.Status

Feedback: Report problem or ask question.

MBS Xojo blog