Using Matrox Radient eCL with MIL

User Guide:

Grabbing with your digitizer I/O signals and communicating with external devices Using MIL with GenICam Using MIL with a Processing FPGA Using images acquired with a Bayer color filter

Reference:

MbufBayer MbufPut1d MbufPut2d MdigControl MsysAlloc

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. Each process (executable) can allocate multiple MIL Radient eV-CL systems for the same board (although, allocating the same board multiple times is not very useful). If multiple systems (in the same process or different processes) allocate the same digitizer, grabs from the different systems 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 23: Grabbing with your digitizer and Chapter 24: I/O signals and communicating with external devices, respectively.

For information regarding the use of your Matrox Radient eCL's Processing FPGA, see Chapter 34: 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 23: 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.

On-board Bayer color conversion

Matrox Radient eCL can be used to grab color images from a camera with a Bayer color filter (as specified by the DCF), and then perform the Bayer color conversion and white balancing on-board. The following table shows the difference between performing Bayer color conversion off-board as opposed to on-board your Matrox Radient eCL.

	On-board	Off-board
Performing gamma correction	Not available.	Use MbufBayer().
Performing white balance correction automatically	MdigControl() with M_WHITE_BALANCE set to M_ENABLE.	MbufBayer() with M_WHITE_BALANCE_CALCULATE.
Performing white balance correction, providing a coefficients array.	M_BAYER_COEFFICIENTS_ID	MbufPut1d() or MbufPut2d().
Applying the Bayer conversion on the source image	MdigControl() with M_BAYER_CONVERSION set to M_ENABLE.	MbufBayer().

For information on Bayer color conversion, refer to the Using images acquired with a Bayer color filter section of Chapter 19: Data buffers.

The M_BAYER... control types 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.