Installing the Support Packages for Image Acquisition Toolbox Adaptors

With previous versions of the Image Acquisition Toolbox™, the files for all of the adaptors were included in your installation. Starting with version R2014a, each adaptor is available separately through the Support Package Installer. All of the support packages contain the necessary MATLAB files to use the toolbox with your adaptor. Some also contain third-party files, such as drivers or camera set-up utilities.

To use the cameras or frame grabbers you have been using with the toolbox, you must install the support package for the adaptor that your camera uses. If you use multiple adaptors, you need to install the support package for each one you use. For example, if you have a Webcam on a Windows® system and a Matrox® camera, you would need to install the OS Generic Video Interface support package for the winvideo adaptor for the Webcam and the Matrox Hardware support package for the matrox adaptor.

To use the Image Acquisition Toolbox for acquisition from any generic video interface, you need to install the OS Generic Video Interface support package. This includes any cameras that use the Windows Video (winvideo), Macintosh Video (macvideo), or Linux Video (linuxvideo) adaptors. The correct files will be installed, depending on your operating system.

All video interface adaptors are available through the Hardware Support Packages. Using this installation process, you download and install the following file(s) on your host computer:

  • Image Acquisition Toolbox adaptor files for your selected adaptor

  • Third-party files if your support package includes them, depending on the adaptor (see the table in step 3)

Installing the Support Package

  1. In MATLAB® type:

    supportPackageInstaller

    to open the Support Package Installer.

    You can also open the installer from MATLAB by selecting Home > Resources > Add-Ons > Get Hardware Support Packages.

  2. On the Select an action screen, select Install from Internet and then click Next. This option is selected by default. Support Package Installer downloads and installs the support package and third-party software from the Internet.

  3. On the Select support package to install screen, all of the adaptors are listed if you have the Image Acquisition Toolbox. You can see some of them in the list in the following graphic, and in this example, OS Generic Video Interface is selected.

    You should select the adaptor that you need to install. If you use multiple adaptors, you need to do this installation for each of them separately. Use this table to identify the name of the support package for your adaptor:

    Adaptor NameSupport package name in listContents
    Windows Video (winvideo)OS Generic Video InterfaceMATLAB files to use Windows Video, Macintosh Video, or Linux Video cameras with the toolbox. The correct OS files will be installed, depending on your system.
    Kinect for Windows (kinect)Kinect for Windows SensorMATLAB files to use Kinect for Windows cameras with the toolbox

    Third party files – Kinect for Windows Runtime

    QImaging (qimaging)QImaging HardwareMATLAB files to use QImaging cameras with the toolbox

    Third party files – QImaging QCam

    DALSA IFC (dalsaifc)Teledyne DALSA IFC HardwareMATLAB files to use DALSA IFC cameras with the toolbox
    DALSA Sapera (dalsasapera)Teledyne DALSA Sapera HardwareMATLAB files to use DALSA Sapera cameras with the toolbox
    GigE Vision (gige)GigE Vision HardwareMATLAB files to use GigE Vision cameras with the toolbox
    Matrox (matrox)Matrox HardwareMATLAB files to use Matrox cameras with the toolbox
    DCAM (dcam)DCAM HardwareMATLAB files to use DCAM cameras with the toolbox

    Third party files – CMU DCAM on Windows driver file

    GenICam GenTL (gentl)GenICam InterfaceMATLAB files to use GenTL cameras with the toolbox
    Point Grey (pointgrey)Point Grey HardwareMATLAB files to use Point Grey cameras with the toolbox

    Third party files – Point Grey FlyCapture

    Linux Video (linuxvideo)OS Generic Video InterfaceMATLAB files to use Windows Video, Macintosh Video, or Linux Video cameras with the toolbox. The correct OS files will be installed, depending on your system.
    Macintosh Video (macvideo)OS Generic Video InterfaceMATLAB files to use Windows Video, Macintosh Video, or Linux Video cameras with the toolbox. The correct OS files will be installed, depending on your system.
    Data Translation (dt)Data Translation Frame GrabbersMATLAB files to use Data Translation hardware with the toolbox
    Hamamatsu (hamamatsu)Hamamatsu HardwareMATLAB files to use Hamamatsu cameras with the toolbox
    National Instruments (ni)NI Frame GrabbersMATLAB files to use NI hardware with the toolbox

    Third party files – NI-IMAQ file

    The table also tells you what files get installed for each adaptor. Accept or change the Installation folder and click Next.

      Note:   You must have write privileges for the Installation folder.

  4. If you are prompted to log in to your MathWorks® account, click Log In to continue.

  5. On the MATHWORKS AUXILIARY SOFTWARE LICENSE AGREEMENT screen, select the I accept check box and click Next.

  6. The Third-party software licenses screen appears if your support package includes third-party files.

    Review the information, including the license agreements, and click Next.

  7. On the Confirm installation screen, Support Package Installer confirms that you are installing the support package you selected, and lists the installation location. Confirm your selection and click Install. In the example shown here, it confirms the OS Generic Video Interface support package.

  8. If your adaptor includes third-party files, that installation starts, and a download status dialog box appears during the installation.

    You can continue working in MATLAB as the download proceeds.

  9. After the installation of the third-party files (if included) and the Image Acquisition Toolbox files is complete you will see a confirmation message on the Support Package Installer Install/update complete screen. Click Finish to close the Support Package Installer.

  10. You may be prompted to restart your computer. If you are prompted, you must restart for the installation to be complete. Click OK and then restart your computer.

Was this topic helpful?