| Customize Help

Using Matrox GatorEye with MIL


To use your Matrox GatorEye with MIL, you must allocate a MIL GigE Vision system (M_SYSTEM_GIGE_VISION), using MsysAlloc(). This allocation opens general communication with all the GigE Vision-compliant cameras found on your subnet (through one or more Gigabit Ethernet network adapters in your computer). Then, allocate a digitizer for each Matrox GatorEye that you want to use to grab images and/or access directly, using MdigAlloc(). In the case where you have only one Matrox GatorEye, use MdigAlloc() with M_DEV0. If, however, you have multiple network cameras, you should use the M_GC_CAMERA_ID() macro and specify the camera's name; this will make for more portable code.

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

Since you interact with Matrox GatorEye as you would another GigE Vision camera, Matrox GatorEye information in the MIL Reference can be found in the paragraphs and values marked as being supported by the GigE Vision driver. For additional information on Matrox GatorEye, refer to the Matrox GigE Vision driver chapter in the MIL Hardware-specific Notes. Refer to the Matrox GigE Vision driver release notes for any additions/modifications to this chapter.

To inquire the current value of the required GigE Vision camera feature, use MdigInquireFeature(). If a GigE 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.

Matrox Intellicam's Feature Browser accesses the GigE Vision-compliant camera's device description file (XML), providing an interface to view and change the camera's information. For more information, refer to the Using MIL with GenICam section of Chapter 25: Grabbing with your digitizer.

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. To learn the list of GenICam-extension features, specific to your Matrox GatorEye, refer to the Matrox GatorEye Installation and Hardware Reference manual.