| Customize Help

Using Matrox Radient eCL with MIL

To use any Matrox Radient eCL, you must allocate it as a MIL Radient system using MsysAlloc() with M_SYSTEM_RADIENT. This allocation opens communications with your Matrox Radient eCL and allows MIL to use its resources. You can allocate a MIL Radient eCL system for your board in multiple processes (executables). If more than one process allocates a digitizer for the same acquisition path, grabs from the different processes will be queued in the order that they arrive (first in, first out).

For information regarding controlling your digitizer and its I/Os, see Chapter 25: Grabbing with your digitizer and Chapter 41: I/O signals and communicating with external devices, respectively.

For information regarding the use of your Matrox Radient eCL's Processing FPGA, see Chapter 52: Using MIL with a Processing FPGA.

For information regarding using MIL to access the GenICam standard feature naming convention (SFNC)-compatible features of your camera, and configuring your Camera Link camera to use GenICam, see the Using MIL with GenICam section of Chapter 25: Grabbing with your digitizer.

Refer to the Matrox Radient eCL release notes for any additions/modifications to the MIL Hardware-specific Notes in this chapter or in the MIL Reference.

Performing Bayer color conversion in hardware

When Matrox Radient eCL grabs color images from a video source with a Bayer color filter (as specified by the DCF), it performs Bayer color conversion in hardware, as it transfers the images to the Host. If the images require white balancing, Matrox Radient eCL can perform this automatically if white balancing is enabled using MdigControl() with M_WHITE_BALANCE set to M_ENABLE. If performing white balancing, you can use the default white balance coefficients, automatically have them calculated (using MdigControl() with M_WHITE_BALANCE set to M_CALCULATE), or set explicit coefficients (M_BAYER_COEFFICIENTS_ID). For information on Bayer color conversion, refer to the Using images acquired with a Bayer color filter section of Chapter 21: Data buffers.

If you don't want to perform Bayer color conversion in hardware, disable it using MdigControl() with M_BAYER_CONVERSION set to M_DISABLE.

The M_BAYER... control types of MdigControl() can only be used when grabbing from a camera that has a Bayer color filter (as specified by the DCF); otherwise, an error will be generated.