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: 12.2   12.3   12.4   12.5   13.0   13.1   13.2   13.3   13.4   13.5    Statistic    FMM    Blog  

GMImage.Release

Releases the image from memory.

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

(old name: GMImage.Destroy)

Parameters

Parameter Description Example
ImageRef The image reference number. 1

Result

Returns OK or error.

Description

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.

Used to be named GMImage.Release before.

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.

Examples

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

Release notes

Example Databases

Blog Entries

This function checks for a license.

Created 18th August 2014, last changed 12nd June 2020


GMImage.ReduceNoise - GMImage.ReleaseAll

💬 Ask a question or report a problem