| MIL 10 Board Specific Notes
| Customize Help

Using the Matrox USB3 Vision driver with MIL



See also
Next

To use ther Matrox USB3 Vision driver with MIL, you must allocate a MIL USB3 Vision system (M_SYSTEM_USB3_VISION), using MsysAlloc(). This allocation opens general communication with all the USB3 Vision-compliant cameras (or devices) connected to your computer. Then, allocate a digitizer for each camera (USB3.0 camera) that you want to use to grab images and/or access directly, using MdigAlloc().

Each process (executable) can allocate only one MIL USB3 Vision system; an error will occur if you try to allocate more than one. Multiple processes can allocate a MIL USB3 Vision system.

To inquire the current value of the required USB3 Vision camera feature, use MdigInquireFeature(). If a USB3 Vision feature is not already set to the required value, use MdigControlFeature() to change the value of the feature. Functionality is also supported with the conventional MIL functions MdigInquire() and MdigControl(). To learn the list of GenICam-standard features available, refer to the GenICam-standard Feature Naming Convention, available on the GenICam website at: http://www.genicam.org. Additional GenICam-extension features might be available; check your camera's manual and Matrox Intellicam's Feature Browser for details.

You can also use Matrox Intellicam's Feature Browser to access the USB3 Vision-compliant camera's device description file (XML), providing an interface to view and change the camera's configuration. For more information, refer to the Using MIL with GenICam section of Chapter 23: Grabbing with your digitizer.

Matrox USB3 Vision information in the MIL Reference can be found in the paragraphs and values marked as being supported by the USB Vision driver. Refer to the Matrox USB3 Vision release notes for any additions/modifications to this chapter.

Non-paged memory usage

With each call to MdigAlloc(), a certain amount of memory is reserved so that MIL can create internal buffers. To calculate the exact amount of memory reserved, inquire the amount of non-paged memory used before and again after you call MdigAlloc(); to perform the inquire, use MappInquire() with M_NON_PAGED_MEMORY_USED. MIL uses this reserved non-paged memory when grabbing and when decoding image data received in "chunk mode".

If your application requires more non-paged memory than is currently available, increase the amount of non-paged memory accessible to MIL using the MILConfig utility.