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 for facilitating and accelerating application development.
The MIL C/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, providing platform flexibility and protecting the original development investment.
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 scripting4
MIL supports C# and Visual Basic 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 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 (e.g., function parameter checking, tracing, and error reporting), as well as configuration and diagnostic tools.
MIL configuration and diagnostic tool
Designed for multi-tasking
MIL supports multi-processing and multi-tasking programming models, namely, 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.
Buffers and containers
MIL manipulates data stored in buffers, such as monochrome images arranged in 1-, 8-, 16-, and 32-bit integer formats, as well as 32-bit floating point formats. It also handles color images laid out in packed or planar RGB/YUV formats. Commands for efficiently converting between buffer types are included. MIL additionally operates on containers4, which combine related buffers into a cohesive whole. Containers simplify working with multi-component data such as point clouds for 3D processing and analysis as well as display.
MIL 3D (point cloud) data container
Saving and loading images
MIL supports the saving and loading of individual images, image sequences, and containers to and from disks. Supported file formats are AVI (Audio Video Interleave), BMP (bitmap), JPG (JPEG), JP2 (JPEG2000), MP4 (MPEG-4 Part 14), PLY, MIM (native), PNG, STL, and TIF (TIFF), as well as a raw format.
Industrial and robot communication
MIL lets applications interact directly with automation controllers using the CC-Link IE Field Basic4, EtherNet/IP™, Modbus®, and PROFINET®6 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 for an imaging system to capture video: Analog, Camera Link, CoaXPress, DisplayPort, GenTL, GigE Vision, HDMI, SDI, and USB3 Vision. MIL supports all these interfaces either directly or 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.
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 Intellicam frame grabber and camera configuration tool
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 cameras and testing video acquisition. It can obtain GigE Vision and USB3 Vision 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.
Matrox Capture Assistant GigE Vision and USB Vision configuration and test tool
Simplified 2D image display
MIL provides transparent 2D 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.
MIL can manage image display across
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, and the ability to 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 their reference coordinate system to the positional results of a MIL analysis operation.
MIL provides a graphics facility to annotate images and define regions of operation
Native 3D display
MIL can natively display point clouds. A 3D display can be panned, tilted, and zoomed in all directions. Visual guides appear to help orient the view. In addition to showing individual points, a 3D display can be supplemented with geometric shapes (i.e., arc, cylinder, line, plane, sphere, and textured polygon), text, coordinate system axes, grid (on reference plane), and orientation box. MIL allows control over appearance (solid or wireframe), opacity, color (including point cloud colorization using jet or turbo lookup tables), visibility, and thickness.
MIL 3D display
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 Imaging hardware (i.e., smart camera, vision controller, I/O card, frame grabber, or dongle). Some components are pre-licensed with certain Matrox Imaging hardware; please consult the individual Matrox Imaging 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 for redistribution 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, and 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 API. Also supported is Visual Studio’s intelligent code-completion facility, 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.
MIL includes comprehensive and easy-to-find
MIL provides a rich set of categorized and searchable programming examples
MIL-Lite is a subset of MIL, featuring 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.
MIL provides a comprehensive set of application programming interfaces, imaging tools and hardware support
4. Through an update.
6. With appropriate Matrox Imaging I/O card, smart camera, or vision controller.