Complete application development environment

In addition to image processing, analysis and archiving tools, MIL includes image capture, annotation and display functions, which form a cohesive API. The API and accompanying utilities are recognized, by the large installed base of users, as being helpful to facilitate and accelerate application development.

Portable API

The MIL C API is not only intuitive and straightforward to use but it is also portable. It allows applications to be easily moved from one supported video interface or operating system to another, which provides platform flexibility and protects the original development investment.

.NET development

Included in MIL is a low-overhead API layer for developing Windows® applications within the .NET Framework using managed Visual Basic® and Visual C#® code.

JIT compilation and scripting3

MIL supports C# and Visual Basic just-in-time (JIT) compilation and CPython scripting, facilitating experimentation and prototyping. Such code can even be executed from within a MIL-based application, providing a simpler way to tailor an already deployed application.

Simplified platform management

With MIL, a developer does not require an in-depth knowledge of the underlying platform. MIL is designed to deal with the specifics of each platform and provide simplified management (e.g., hardware detection, initialization and buffer copy). MIL gives developers direct access to certain platform resources such as the physical address of a buffer. MIL also includes debugging services (i.e., function parameter checking, tracing and error reporting), as well as configuration and diagnostic tools.

Click to enlarge

MIL configuration and diagnostic tool.

Designed for multi-tasking

MIL supports multi-processing and multi-tasking programming models: multiple MIL applications not sharing MIL data or a single MIL application with multiple threads sharing MIL data. It provides mechanisms to access shared MIL data and ensure that multiple threads using the same MIL resources do not interfere with each other. MIL also offers platform-independent thread management for enhancing application portability.

Supported data formats

MIL can manipulate data, such as monochrome images, stored in 1, 8, 16 and 32-bit integers, as well as 32-bit floating point formats. MIL can also handle color images stored in packed or planar RGB/YUV formats. Commands for efficiently converting between data types are included.

Saving and loading images

MIL supports the saving and loading of individual images or sequence of images to/from disk. Supported file formats are AVI (Audio Video Interleave), BMP (bitmap), JPG (JPEG), JP2 (JPEG2000), MP4 (MPEG-4 Part 14), native (MIM), PNG and TIF (TIFF), as well as a raw format.

Industrial and robot communication3

MIL lets applications interact directly with automation controllers using the EtherNet/IP™, MODBUS® and PROFINET industrial communication protocols. It also supports native communication with robot controllers from ABB, DENSO, EPSON, FANUC, KUKA and Stäubli.

Flexible and dependable image capture

There are many ways to transmit video to an imaging system: analog, Camera Link®, Camera Link HS, CoaXpress®, DVI-D, GigE Vision®, IEEE 1394 IIDC, SDI and USB3 Vision™ 2,3. MIL supports all these interfaces either directly through Matrox Imaging or third-party hardware. MIL works with images captured from virtually any type of color or monochrome source including standard, high-resolution, high-rate, frame-on-demand cameras, line scanners, slow scan and custom designed devices.

For greater determinism and the fastest response, MIL provides multi-buffered image capture control performed in the operating system’s kernel mode. Image capture is secured for frame rates measured in the thousands per second even when the host CPU is heavily loaded with tasks such as HMI management, networking and archiving to disk. The multi-buffered mechanism supports callback functions for simultaneous capture and processing even when the processing time occasionally exceeds the capture time.

Matrox Intellicam

MIL features the Matrox Intellicam image capture and frame grabber configuration utility. This Windows-based program lets users interactively configure Matrox image capture hardware for a variety of image sources or simply try one of the numerous ready-made interfaces available from Matrox Imaging.

Matrox Capture Assistant

MIL includes Matrox Capture Assistant, a Windows-based utility for verifying the connection to one or more GigE Vision or USB3 Vision™ 3 cameras and testing video acquisition. It can obtain GigE Vision and USB3 Vision™ 3 device information, collect and present acquisition statistics and provide access to acquisition (GenICam™) properties. The gathering and display of statistics can be performed when acquiring within or outside of Matrox Capture Assistant. Matrox Capture Assistant also allows the adjustment of GigE Vision driver settings and provides the means to troubleshoot connectivity issues.

Click to enlarge

Matrox Assistant GigE Vision® and USB Vision™ 3 configuration and test tool.

Click to enlarge

Matrox Intellicam frame grabber and camera configuration tool.

Simplified image display

MIL provides transparent image display management with automatic tracking and updating of image display windows at live video rates. MIL also allows for live image display in a user-specified window. Display of multiple video streams using multiple independent windows or a single mosaic window is also supported. Moreover, MIL provides non-destructive graphics overlay, suppression of tearing artifacts and filling the display area at live video rates. All of these features are performed with little or no host CPU intervention when using appropriate graphics hardware.

MIL also supports multi-screen display configurations that are in an extended desktop mode (i.e., desktop across multiple monitors), exclusive mode (i.e., monitor not showing desktop but dedicated to MIL display) or a combination.

Click to enlarge

MIL can manage image display across multiple monitors.

Graphics, regions and fixtures

MIL provides a feature-rich graphics facility to annotate images and define regions of operation. This capability is used by the MIL analysis tools to draw settings and results onto an image. It is also available to the programmer for creating application-specific image annotations. The graphics facility supports different shapes—dot, line, polyline, polygon, arc and rectangle—and text with selectable font. It takes image calibration into account, specifically the unit, reference coordinate system and applicable transformations. The graphics scale smoothly when zooming to sub-pixel. An interactive mode is available to easily allow developers to provide user editing of graphics: add, move, resize and rotate graphic elements. Moreover, the application can hook to interactivity-related events to automatically initiate underlying actions. The graphics facility can further be used to define Regions to guide or confine subsequent MIL analysis operations. Regions can also be repositioned automatically by tying its reference coordinate system to the positional results of a MIL analysis operation.

Click to enlarge

MIL provides a graphics facility to annotate images and define regions of operation.

Application deployment

MIL offers a flexible licensing model for application deployment. Only the components required to run the application need to be licensed. License fulfillment is achieved using a pre-programmed dongle or an activation code tied to Matrox hardware (i.e., smart camera, vision system / industrial computer, frame grabber, vision processor or dongle). Some components are pre-licensed with certain Matrox hardware. Consult the individual Matrox hardware datasheets for details. The use of Distributed MIL within the same physical system does not require the additional specific license. The installation of MIL can even be hidden from the end user.

Documentation, IDE integration and examples

MIL’s online help provides developers with comprehensive and easy-to-find documentation. The online help can even be tailored to match the environment in use. The online help can be called up from within Visual Studio® to provide contextual information on the MIL API3. Also supported is Visual Studio’s intelligent code completion facility3, giving a programmer on the spot access to relevant aspects of the MIL API. An extensive set of categorized and searchable example programs allow developers to quickly get up to speed with MIL.

Click to enlarge

MIL includes comprehensive and easy-to-find documentation.


MIL-Lite is a subset of MIL. MIL-Lite features programming functions for performing image capture, annotation, display and archiving. It also includes fast operators for arithmetic, Bayer interpolation, color space conversion, de-interlacing, temporal filtering, basic geometric transformations, histogram, logic, LUT mapping and thresholding. MIL-Lite is licensed for both application development and deployment in the presence of Matrox Imaging hardware or a supplemental license tied to a dongle.

Software architecture

click to enlarge

MIL provides a comprehensive set of application programming interfaces, imaging tools and hardware support

2. Only under Windows®.
3. Through an update.

Back to top