Using Matrox Image Library (MIL) for Windows

Matrox Imaging Library (MIL) is a comprehensive collection of software tools for developing machine vision, image analysis, and medical imaging applications. The toolkit features interactive software and programming functions for image capture, processing, analysis, annotation, display, and archiving. The following instructions describe how to configure Lucid Vision GigE cameras with Matrox Imaging Library for Windows.

System Specifications

  • Windows 10 Pro 64-bit, version 1709, build 16299.64
  • MIL 10.00 R2 (build 2995) 64-bit including MIL 10 Update 25 for GigE Vision

Prerequisites

  1. Install GigE Vision support at the time of MIL software installation.

    https://d1d1c1tnh6i0t6.cloudfront.net/wp-content/uploads/2018/01/mil_windows_install_step.png

  2. Verify GigE Vision support is installed by opening MilConfig and finding GigE Vision as an installed Board in General -> Information. MilConfig can be launched from the Start Menu.

    https://d1d1c1tnh6i0t6.cloudfront.net/wp-content/uploads/2018/01/mil_windows_milconfig_gigevision_installed.png

    Note

    Installing MIL 10 Update 25 for GigE Vision is required for GigE Vision 2.0 support.

  3. Verify the Matrox GigE Vision Discovery Service is running in Boards -> GigE Vision.

    https://d1d1c1tnh6i0t6.cloudfront.net/wp-content/uploads/2018/01/mil_windows_milconfig_gige_service.png

  4. Ensure you have the Matrox GigE Vision Filter Driver installed. To install the Matrox GigE Vision filter driver:

    • Open Network and Sharing Center

    • Right-click on your Ethernet adapter and click Properties

    • Click Install in the Ethernet adapter’s properties window

    • Choose Service in the Network Feature Type window

      https://d1d1c1tnh6i0t6.cloudfront.net/wp-content/uploads/2018/01/mil_windows_install_network_service.png
    • Find the Matrox GigE Vision Filter Driver in the Network Service window, and click OK to install the service.

      https://d1d1c1tnh6i0t6.cloudfront.net/wp-content/uploads/2018/01/mil_windows_install_filter_driver.png

      Note

      If the Matrox GigE Vision Filter Driver is not available in the Network Service window, click Have Disk to find the filter driver manually. The filter driver is located in C:\Program Files\Matrox Imaging\Drivers\mtxgigefilter\sys.

    • Verify the Matrox GigE Vision Filter Driver is installed in the Ethernet adapter’s properties window.

      https://d1d1c1tnh6i0t6.cloudfront.net/wp-content/uploads/2018/01/mil_windows_filter_driver.png

Matrox Capture Assistant

Matrox Capture Assistant is a utility that will allow you to quickly evaluate your camera from Lucid Vision Labs.

https://d1d1c1tnh6i0t6.cloudfront.net/wp-content/uploads/2018/01/mil_windows_capture_assistant.png

  1. Click mil_windows_capture_assistant_button_allocate to take or release control of the camera in Matrox Capture Assistant.
  2. Click mil_windows_capture_assistant_button_start_acquisition to start acquiring images.
  3. Click mil_windows_capture_assistant_button_feature_browser to open the camera Feature Browser.
  4. Click mil_windows_capture_assistant_button_display to toggle image display while acquiring images.

Matrox Intellicam

Matrox Intellicam is a program that enables frame grabber and image grabber configuration. You can also save customized camera settings to a digitizer configuration format file (DCF) in Intellicam for future use. Note while an Ethernet port is required to use a Lucid camera, a specific frame grabber is not necessary.

  1. Ensure GigE Vision is chosen as your active system.

    https://d1d1c1tnh6i0t6.cloudfront.net/wp-content/uploads/2018/01/mil_windows_intellicam_active_system.png

  2. Click mil_windows_intellicam_button_new_dcf to start a new DCF.

  3. Choose a DCF file. The GigEVision DCF file is a default configuration that can be used as a starting point.

    https://d1d1c1tnh6i0t6.cloudfront.net/wp-content/uploads/2018/01/mil_windows_intellicam_new_dcf_selection.png

After choosing your DCF file, you will see the DCF configuration window.

https://d1d1c1tnh6i0t6.cloudfront.net/wp-content/uploads/2018/01/mil_windows_intellicam_dcf_configuration_window.png
  1. Click mil_windows_intellicam_button_grab_single to grab a single image and display it on screen.
  2. Click mil_windows_intellicam_button_grab_single_safe to grab a single image and attempt to display it on screen even there was an error.
  3. Click mil_windows_intellicam_button_grab_continuous to continuously grab images and display them on screen.
  4. Click mil_windows_intellicam_button_grab_continuous_safe to continuously grab images and attempt to display them on screen even if there were errors.
  5. Click mil_windows_intellicam_button_feature_browser to open the camera Feature Browser.

You can configure the camera in the Camera Configuration tab of the the DCF configuration window.

https://d1d1c1tnh6i0t6.cloudfront.net/wp-content/uploads/2018/01/mil_windows_intellicam_dcf_camera_configuration.png

The Manual Feature Configuration section is for camera feature changes made in the Feature Browser.

  • Recording Mode enables any changes made in the Feature Browser to be recorded and saved in the DCF.
  • Dump State to DCF saves all Streamable camera features in the DCF.
  • Delete removes a feature from the DCF.
  • Delete All removes all features from the DCF.

The Configure Feature section is for camera features to add to the DCF.

  • Name specifies the camera feature’s name.
  • Value specifies the camera feature’s value.
  • Type specifies the camera feature’s type.
  • Add adds a camera feature to the DCF.
  • Modify modifies the current camera feature in the DCF.
  • Make Optional specifies to make the camera feature optional in the DCF.

Matrox Example Launcher

Matrox Example Launcher is an interface to evaluate MIL’s image acquisition samples. Matrox Example Launcher can be launched from the Start Menu.

The following shows the MdigGrab sample.

https://d1d1c1tnh6i0t6.cloudfront.net/wp-content/uploads/2018/01/mil_windows_milexamplelauncher_mdiggrab.png

By default, the MIL samples are installed to %PUBLIC%\Documents\Matrox Imaging\MIL\Examples.

For more information on Matrox Imaging Library please visit https://www.matrox.com/imaging/en/products/software/mil/