Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old


Initializes the matrix dongle API.

Component Version macOS Windows Linux Server iOS SDK
MatrixDongle 5.2 ✅ Yes ✅ Yes ❌ No ✅ Yes, on macOS and Windows ❌ No


This function was deprecated.

MBS( "MatrixDongle.Initialize"; LibraryPath )   More


Parameter Description Example
LibraryPath The native file path to the matrix library file. $path


Returns OK or error.


Initializes the matrix dongle API.
Loads the library files: matrix64.dll, matrix32.dll or libmxmac260.dylib from disk.
You need to pass the path to the dynapdf library and the plugin loads it.
The matrix dll/dylib files are included with the matrix dongle SDK.
Be sure to use right 32-bit/64-bit driver depending on which bit number FileMaker has!

You can pass just the filename of library and the plugin finds it in the Extensions folder or in FileMaker's application folder.

If you get a crash here on MacOS, please check if crash report says Code Signature Invalid. Then you may need to code sign the dylib yourself to match the code signature of your application.

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.


Initialize dongle functions:

If [MBS( "SystemInfo.isMacOSX" ) = 1]
    Set Variable [$path; Value:MatrixDongle::LibraryPathMac]
    Set Variable [$path; Value:MatrixDongle::LibraryPathWin]
End If
Set Variable [$r; Value:MBS("MatrixDongle.Initialize"; $path)]
If [MBS("iserror")]
    Show Custom Dialog ["Failed to initialize"; $r]
    Show Custom Dialog ["Initialize OK"; "The dongle functions are ready to use."]
End If

See also

This function does not need a paid license.

Created 1st August 2015, last changed 31st July 2020

MatrixDongle.GetVersionDRV.USB - MatrixDongle.Initialized

💬 Ask a question or report a problem