| Components | All | New | MacOS | Windows | Linux | iOS | ||||
| Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old | |
GMImage.NewFromContainer
Loads a picture from the given container.
| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
| GraphicsMagick | 2.0 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |
Parameters
| Parameter | Description | Example |
|---|---|---|
| Data | A value from a Container Field. Can include various image formats like JPEG, PNG or just containers with FILE data. |
Result
Returns the ImageRef number on success.
Description
Loads a picture from the given container.Please call GMImage.Release later to free memory for this image.
Image reference numbers are starting at 18000 and counting up for each new image.
If image doesn't load, please check whether it's a HEIC, HEIF or RAW image. For those, please use Container.ReadImage first to convert on macOS/iOS/Windows.
When the container has a PDF, the plugin may just load the preview image. Please use DynaPDF.RenderPage, PDFKit.GetPDFPageImage or WinPDF.PageImage to render an image from the PDF first, before loading it.
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.Release";$Image)
];
$Width & " x " & $Height )
Load from container:
MBS( "GMImage.NewFromContainer"; test::test)
Invert image:
Set Variable [ $image ; Value: MBS( "GMImage.NewFromContainer"; Invert::Input ) ]
# each channel...
// Set Variable [ $r ; Value: MBS( "GMImage.InvertChannel"; $image; "red") ]
// Set Variable [ $r ; Value: MBS( "GMImage.InvertChannel"; $image) ]
// Set Variable [ $r ; Value: MBS( "GMImage.InvertChannel"; $image; "blue") ]
# all channels...
Set Variable [ $r ; Value: MBS( "GMImage.InvertChannel"; $image; "rgb") ]
Set Field [ Invert::Output ; MBS( "GMImage.WriteToPNGContainer"; $image; "output.png") ]
Set Variable [ $r ; Value: MBS( "GMImage.Release"; $image) ]
See also
- GMImage.ReadContainer
- GMImage.WriteToContainer
- GMImage.WriteToTiffContainer
- GMImage.WriteToWebPContainer
- ImageView.CreateWithSize
- OCR.GetText
- OCR.GetTextWithCoordinates
- Window.SetTitleIcon
- WinPDF.PageImage
- XL.Book.AddPictureContainer
Release notes
- Version 13.0
- Changed JPEG loader for GMImage.NewFromContainer, GMImage.NewFromFile and related to not stop loading of an image on a warning.
- Version 9.5
- Improved JPEG detection for byte streams, so we can detect if a PNG is actually a JPEG. Now GMImage.NewFromContainer can read JPEG, GIF, PNG, TIFF and BMP even if they are passed in wrong container format.
- Version 9.0
- Improved error handling for GMImage.NewFromContainer, so we pass on error messages from GraphicsMagick.
- Version 8.3
- Fixed GMImage.NewFromContainer to handle SVG files better.
- Version 7.2
- Fixed a bug with GMImage.NewFromContainer where referenced image file would stay open.
Example Databases
- Containers/Create Container Preview
- DynaPDF/Click Points
- GraphicsMagick/Annotate Image
- GraphicsMagick/Clip Image
- GraphicsMagick/Combine Pictures
- GraphicsMagick/Correct Image Orientation
- GraphicsMagick/GraphicsMagick IPTC
- GraphicsMagick/Image Scaling
- GraphicsMagick/Pick color from image via Screenshot
- GraphicsMagick/SVG to PNG
Blog Entries
- MBS Plugin Advent calendar: 16 - GraphicsMagick
- Tips and tricks with MBS
- Create thumbnail with GraphicsMagick
- GraphicsMagick in FileMaker, part 24
- GraphicsMagick in FileMaker, part 23
- GraphicsMagick in FileMaker, part 22
- GraphicsMagick in FileMaker, part 19
- GraphicsMagick in FileMaker, part 18
- GraphicsMagick in FileMaker, part 13
- GraphicsMagick in FileMaker, part 10
FileMaker Magazin
This function checks for a license.
Created 18th August 2014, last changed 22nd November 2023
