File Exchange

image thumbnail

FLIR Spinnaker support by Image Acquisition Toolbox

Spinnaker adaptor for Spinnaker supported cameras using Image Acquisition Toolbox


Updated 16 Apr 2020

View License

This file exchange submission enables FLIR Spinnaker supported cameras to work with Image Acquisition Toolbox™. The Spinnaker adaptor is compatible with Spinnaker SDK Version 1.15 only.

Follow these instructions to install the adaptor:

Step 1: Install the Spinnaker SDK.

a) Download and run the EXE file.
Full EXE:
Web EXE:

b) Proceed with setup. In the Installation Profile, select the ‘Camera Evaluation’ option.
c) Complete the installation process.

Step 2: Download the Spinnaker adaptor as MATLAB Toolbox (recommended) or as a zip file from the Download dropdown.

To install the adaptor as a Toolbox:
a) Download the Toolbox. This downloads an MLTBX file.
b) Drag and drop the MLTBX file into the MATLAB Command Window. This automatically opens the file and completes the installation.

To install the adaptor from a .zip file:
a) Download the zip file.
b) Unzip the file to a desired location.

Step 3: Register the Spinnaker adaptor in MATLAB.

a) Restart MATLAB if you have a session open.
b) If you previously registered an adaptor, unregister it using ‘imaqregister’.
c) Register the latest adaptor using ‘imaqregister’. (Refer to the readme.m file for instructions and an example.)

1. This adaptor is only compatible with Spinnaker SDK Version 1.15.
2. Device-specific properties are supported starting R2019b.
3. Hardware triggering is not supported by this adaptor.

Cite As

MathWorks Image Acquisition Toolbox Team (2020). FLIR Spinnaker support by Image Acquisition Toolbox (, MATLAB Central File Exchange. Retrieved .

Comments and Ratings (47)


Hi there,
Are there any plans to release a Linux version of this software? Or are we restricted to using the GenICam drivers for the Linux? I am running Ubuntu 18.04 with a Grasshopper GigE camera.
Thanks for the same!


Does anybody know whether it is possible to add 'hardware trigger' option to TriggerType in the case when the option does not appear as a default. In SpinView I can select this option (external triggers are supported by the camera).
Thank you!

Zach Jessen

I'm interested in using the imaq toolbox to acquire data from a FLIR camera. For my application I need accurate frame timestamps, which according to the documentation for the spinnaker sdk are stored in the chunk data by the camera. I'm wondering if this data is available in matlab (perhaps through the getdata() function?) via this adaptor.


Ali Razavi

Hello Janak:
Q1. How do you get/read all device info at your end?
Q1. How do you wrote any of device info at your end?

I have Matlab 2019b , Spinnaker 1.15 and adapter 3.1 and was able to do the followings - but I could not figure out how to do Q1 and Q2.

close all
FilePath='C:\Users\arazavi\AppData\Roaming\MathWorks\MATLAB Add-Ons\Toolboxes\FLIR Spinnaker support by Image Acquisition Toolbox\R2019b';
out = imaqhwinfo('mwspinnakerimaq');
vid = videoinput('mwspinnakerimaq');
>> out
out =
struct with fields:
AdaptorDllName: 'C:\Users\arazavi\AppData\Roaming\MathWorks\MATLAB Add-Ons\Toolboxes\FLIR Spinnaker support by Image Acquisition Toolbox\R2019b\mwspinnakerimaq.dll'
AdaptorDllVersion: '6.1 (R2019b)'
AdaptorName: 'mwspinnakerimaq'
DeviceIDs: {[1]}
DeviceInfo: [1×1 struct]
>> vid
Summary of Video Input Object Using 'Blackfly S BFS-U3-200S6M'.
Acquisition Source(s): Spinnaker is available.
Acquisition Parameters: 'Spinnaker' is the current selected source.
10 frames per trigger using the selected source.
'Mono10Packed' video data to be logged upon START.
Grabbing first of every 1 frame(s).
Log data to 'memory' on trigger.
Trigger Parameters: 1 'immediate' trigger(s) on START.
Status: Waiting for START.
0 frames acquired since starting.
0 frames available for GETDATA.

Hi Ali,

Device-specific properties are currently supported in R2019b.
Please download and register the latest version of the spinnaker adaptor from this page to get access to the camera properties.

If you continue to encounter issues, reach out to the support team using the below link.


Ali Razavi

Forgot mentioning that I am using 2019b. More details on version:
MATLAB Version: (R2019b) Update 4
Operating System: Microsoft Windows 10 Pro Version 10.0 (Build 18362)
Java Version: Java 1.8.0_202-b08 with Oracle Corporation Java HotSpot(TM) 64-Bit Server VM mixed mode
MATLAB Version 9.7 (R2019b)
Image Acquisition Toolbox Version 6.1 (R2019b)

Ali Razavi

It seems "accessing and manipulating device properties in Matlab environment" is not supported yet:
History in this chain:
* Nov. 21, 2018: "Properties for the spinnaker adaptor will be added in a future release. The Image Acquisition toolbox development team is looking into it."
* July 2, 2019: ". Currently, these properties are not supported by the adaptor."
This seems to be the most key an basic feature.
Any reason why it is not supported?

@John - You should use the DLL located in a subfolder whose name matches with the MATLAB version you are using. For example, if you are using MATLAB R2019b use the DLL located in the R2019b subfolder of the .zip attached to this submission.

@Hanlin - Sorry for the delay. I did notice an issue with R2018b DLL attached to this submission, will add a fix and update the submission soon.


Yiyu Zhou

With MATLAB 2019b I am able to change the settings (exposure, gain, etc) in MATLAB.


Where is the mwspinnakerimaq.dll located? Which subfolder is it located in?

Hanlin Zhu

I some how get rid of the "\mwspinnakerimaq.dll is not a valid adaptor" issue by switch to a .dll downloaded at the early stage of this post, it is 210kb in size, the current one for 2018b is 213kb, leave an email if you want me to share it to you, but it would be great if this old version can be included in this package


I'm inquiring about a linux compatible version of this? Any chance there is a beta version or a release in the near future?


@Janak Thotakura , Thank you for your response! Unregistering and reregistering solved the problem!

To those having crash issues with access violation, make sure you have the version of Spinnaker SDK cited in the readme above and not the newest one from FLIR.

Hi Ann,

Is the issue only with the 'imaqtool'? Were you able to use the adaptor in MATLAB from the command line?

A quick thing to try is to unregister the DLL and register it again.
- imaqregister('<path to DLL>', 'unregister')
- Restart MATLAB
- imaqregister('<path to DLL>')

If the issue continues to exist, please reach out to our support team along with the crash files generated to investigate the issue further.

To locate crash files,


Ann T.

Hello.. after I imaqregister the .dll, when I tried t oopen imaqtool, it crashes and complained about access violation. Do you have any pointer what I could do? thanks, Ann


is there an option to access device properties like frame rate, exposure time, gain,... I couldn't find it.
Thank you,


Thanks for the quick response! That solved the issue and now I have control over camera resolution.


Hi Nolan,

The issue you are running into might be due to the binning setting of the device. Currently, these properties are not supported by the adaptor.

You can try the following,

1) Close all instances of MATLAB
2) Open SpinView GUI, double click on camera from the interface list and navigate to 'Image Format' section
3) Select 'ISP Enable'
4) The 'Binning Horizontal' and 'Binning Vertical' in the same window in GUI should be set to '1'
5) Click on 'Max Image Size' to set the ROI to maximum image size.
6) Close SpinView and open MATLAB to connect with the device and access available supported formats.
>> hwinfo = imaqhwinfo('mwspinnakerimaq')
>> hwinfo.DeviceInfo.SupportedFormats

Did the resolution change?

If the issue continues to exist, please reach out to our technical support.



I have a question in regards to supported image formats using the spinnaker SDK adapter. The camera that I am connecting using the SDK adapter allows a 12MP (4000 x 3000) resolution, however all of the available supported formats are at 1/4 of the available resolution (2000 x 1500). Are there resolution limits defined in this adapter that aren't immediately apparent or is this potentially a hardware related issue that I should discuss with FLIR?


Hi Vasiliy,

It looks like the spinnaker adaptor you registered for R2018b is still in the MATLAB user preferences, which is causing a name conflict when you try to register a newer version of the adaptor.

You can try the following steps to resolve this issue.

1) Execute 'imaqregister' command in MATLAB to get all the registered 3rd party adaptor DLL paths.
2) Execute the below command to unregister the earlier version of Spinnaker adaptor in MATLAB. Replace <path> with the complete path to the Spinnaker DLL obtained after executing step 1.
>> imaqregister('<path>', 'unregister')
Ex: imaqregister('C:\Users\**\Downloads\FLIR Spinnaker support by Image Acquisition Toolbox\mwspinnakerimaq.dll', 'unregister')
3) Repeat step 1 to confirm that the Spinnaker adaptor is unregistered.
4) Register the new version of the Spinnaker adaptor by following the instructions mentioned in the description.


The camera was working fine before but after an update of 2018b literally during work it started giving me an error: "The name mwspinnakerimaq conflicts with a toolbox or third party adaptor." I removed 2018b, updated to 2019a, same thing. I have the Spinnaker SDK SpinView and Image Acquisition Toolbox version 6.0 installed. Is there something I should try to jump start?

Hi Tar,

The recent update to this submission makes the adaptor functional in MATLAB R2019a. Download the latest files and register the right version of the DLL as mentioned in the description.


Tae Jin Kim

Hi everyone. Did anyone succeed in getting this to work in versions other than R2018b?
I'm crossing my fingers that this is not 'only for' R2018b only, but is also compatible with the newest R2019a version.

Jacky Lyu

@ Francesko Molla, @yuhai li. I did figure it out. Install the Spinnaker SDK Version 1.15 with Full SDK option rather than 'Camera Evaluation'. Then register the .dll file as describe above. You should be good to go.

Hi Az,

1) Spinnaker Adaptor is different from the Point Grey adaptor, this adaptor is only supported for R2018b version. Unfortunately, we do not have plans to support Spinnaker adaptor with earlier versions of MATLAB.

2) There is no direct support for USB3 vision in MATLAB. However, if the manufacturer provides GenTL producer drivers you can use this,

- Janak

Can I request: a) compatibility with R2014a and later as with previous PtGrey adapter? b) USB3 Vision native support?
Is there a formal process for either? Thanks! A

yuhai li

Hello Everybody. Could you solve the problem
"...\mwspinnakerimaq.dll is not a valid adaptor. Was the shared library created using the Image Acquisition Toolbox Adaptor Kit?"

@Mitya Reznikov @Jacky Lyu Same Problem for me.. any idea why would that be?

Jacky Lyu

@Mitya Reznikov, I have the same situation. The MATLAB will crash when I run the sample code. Do you find any solutions?

@Konstantinos For me registering the dll with Matlab launched using admin mode and restarting it on standard mode solved that problem.

I was able to install the adapter, but MATLAB crashes with "Access Violation Error" when I try to start the acquisition. Please help.

Hello Everybody. Could you solve the problem
"...\mwspinnakerimaq.dll is not a valid adaptor. Was the shared library created using the Image Acquisition Toolbox Adaptor Kit?"

I have exactly the same problem. Unfortunately, lack of functionality makes my camera useless at this point. Is there a chance to upgrade this package to fully functional version - as the one for FlyCap? Thanks!
Maybe anyone knows a workaround that would be useful for BFS-U3-51S5M-C ?

This driver adaptor is only a packaged version of the winvideo adaptor. What about the functionality we had with the previous adaptor that gave us full control of camera settings and functionality?

I have the same observation as Jeremy, this driver functionally is no better than the winvideo adaptor. With a blackfly S I see 30 fps and no other function than ROI. With some tweaking this camera is capable of ~400 fps with the point grey software which includes extensive controls. It would be good to have performance that at least approximates this...

@Jeremy @Dongjun, After installing the Spinnaker drivers please restart MATLAB so that the necessary paths added by the Spinnaker driver installation are reflected.

Jeremy, Thomas: Properties for the spinnaker adaptor will be added in a future release. The Image Acquisition toolbox development team is looking into it.

I don't have access to exposure properties either.

For me this adpator provides access to image bit number and ROI properties. I tried to drive a Blackfly S in the past using the winvideo adapter and I nearly had access to the same options I have with this new adapter.

I expected access to useful properties like exposure time as well, to be able to easily use my Blackfly S in a realistic configuration...


Hi, can anyone of you access device properties such as Exposure with this adaptor? Under 'Device properties' all I get is 'Selected Source: Spinnaker', but nothing else. Thanks for your help.

Same error : "mwspinnakerimaq.dll is not a valid adaptor. Was the shared library created using the Image Acquisition Toolbox Adaptor Kit?".

I specified the full path as requested.

Get this error while registering the dll
mwspinnakerimaq.dll is not a valid adaptor. Was the shared library created using the Image Acquisition Toolbox Adaptor Kit?

@Brian, please refer to the updated instructions. Thanks

Brian Ofrim

Also unable to locate the mentioned .mltbx file

Attached .mltbx file is missing.



Update for Spinnaker adaptor to work with MATLAB R2020a.


The issue with registering R2018b DLL fixed


Update for Spinnaker adaptor to work with MATLAB R2019b.


Update for Spinnaker adaptor to work with MATLAB R2019a




Installation instructions in the description have been updated.

MATLAB Release Compatibility
Created with R2020a
Compatible with R2018b to R2020a
Platform Compatibility
Windows macOS Linux