| Components | All | New | MacOS | Windows | Linux | iOS | ||||
| Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old | |
MatrixDongle.Initialize
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 |
Deprecated
This function was deprecated.
MBS( "MatrixDongle.Initialize"; LibraryPath ) More
Parameters
| Parameter | Description | Example |
|---|---|---|
| LibraryPath | The native file path to the matrix library file. | $path |
Result
Returns OK or error.
Description
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.
Examples
Initialize dongle functions:
If [MBS( "SystemInfo.isMacOSX" ) = 1]
Set Variable [$path; Value:MatrixDongle::LibraryPathMac]
Else
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]
Else
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
