| Components | All | New | MacOS | Windows | Linux | iOS | ||||
| Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old | |
GMImage.Ping
Pings an image to query metadata.
| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
| GraphicsMagick | 10.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |
MBS( "GMImage.Ping"; ImageRef; Spec ) More
Parameters
| Parameter | Description | Example |
|---|---|---|
| ImageRef | The image reference number. | 1 |
| Spec | The image specification. e.g. native file path |
Result
Returns OK or error.
Description
Pings an image to query metadata.Ping is similar to read except only enough of the image is read to determine the image columns, rows, and file size.
See GMImage.GetWidth, GMImage.GetHeight and GMImage.GetXMP.
This function requires a native path. Use Path.FileMakerPathToNativePath to convert a FileMaker path to a native path if required. If you like to have the user choose the path, you can use FileDialog functions.
For Server be aware that server has limited permissions and may not be able to access all files on a computer.
Examples
Ping picture and show size:
# ping in file Contacts
# you have some dummy image already
Set Variable [ $img ; Value: MBS( "GMImage.New"; "10x10"; "white" ) ]
# read new picture into it
Set Variable [ $r ; Value: MBS( "GMImage.Ping"; $img; "/Users/cs/Desktop/test.png" ) ]
If [ MBS("IsError") = 0 ]
Set Variable [ $w ; Value: MBS( "GMImage.GetWidth"; $img ) ]
Set Variable [ $h ; Value: MBS( "GMImage.GetHeight"; $img ) ]
Show Custom Dialog [ "Size" ; $w & " x " & $h ]
Else
Show Custom Dialog [ "Failed" ; $r ]
End If
Set Variable [ $r ; Value: MBS( "GMImage.Release"; $img) ]
See also
- GMImage.GetHeight
- GMImage.GetWidth
- GMImage.GetXMP
- GMImage.List
- GMImage.New
- GMImage.PingContainer
- GMImage.Release
- IsError
- Path.FileMakerPathToNativePath
Release notes
- Version 10.3
- Added GMImage.Ping and GMImage.PingContainer functions.
Blog Entries
- What is new in the MBS FileMaker Plugin Version 10.3
- Neues MBS FileMaker Plugin 10.3 - Über 6200 Funktionen in einem Plugin
- MBS FileMaker Plugin 10.3 - More than 6200 Functions In One Plugin
- MBS FileMaker Plugin, version 10.3pr9
This function checks for a license.
Created 14th July 2020, last changed 8th March 2021
