Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Guides   Examples
New in version: 8.2   8.3   8.4   8.5   9.0   9.1   9.2   9.3   9.4   9.5    Statistic  


Releases the image from memory.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
GraphicsMagick 2.0 Yes Yes Yes Yes Yes
MBS( "GMImage.Release"; ImageRef )   More

(old name: GMImage.Destroy)


Parameter Description Example value
ImageRef The image reference number. 1


Returns OK or error.


Releases the image from memory.
Please call this function when you are done with the image to free memory.
The plugin doesn't know whether you need the image later, so it can't free the memory for you.
You can use GMImage.ImageCount to find out how many images are open in memory.

On the long term, we will change all examples to use GMImage.Release instead of GMImage.Destroy and later deprecate GMImage.Destroy and hide it in documentation.

You need to release all image references returned by functions GMImage.New, GMImage.NewFromBase64, GMImage.NewFromContainer, GMImage.NewFromFile, GMImage.NewFromHex, GMImage.NewImagesFromContainer, GMImage.NewImagesFromFile, GMImage.Copy, GMImage.GetClipMask, MenuItem.GetImage, MenuItem.GetMixedStateImage, MenuItem.GetOffStateImage, MenuItem.GetOnStateImage, Twain.CurrentImage, and Barcode.Generate.


Show with and height

Let ( [
$Image = MBS("GMImage.NewFromContainer"; GraphicsMagick::image);
$Width = MBS("GMImage.GetWidth";$Image);
$Height = MBS("GMImage.GetHeight";$Image);
$Error = MBS("GMImage.Destroy";$Image)
$Width & " x " & $Height )

Create red square and save to container:

Set Variable [$img; Value:MBS( "GMImage.New"; "16x16"; "red" )]
Set Field [test::test; MBS( "GMImage.WriteToPNGContainer"; $img; "test.png" )]
Set Variable [$r; Value:MBS( "GMImage.Destroy"; $img)]

See also

Example Databases

Blog Entries

Release notes

Created 18th August 2014, last changed 31st July 2019

GMImage.ReduceNoise   -   GMImage.ReleaseAll

Feedback: Report problem or ask question.

MBS Xojo Plugins