Click here to show toolbars of the Web Online Help System: show toolbars
 

Filters
Filter values by
Settings
  • Analog control
  • Input device information and control
  • Bayer
  • Image format and adjustment control
  • DCF information
  • Acquisition
    • Control
    • Triggered grab
    • Status and statistics
  • Data latches
  • Digital I/O control
  • Timer and counter control
  • Rotary decoder control
  • Transport layer control
| Customize Help
| Save Settings
Close

MdigControl


Function Map
Syntax
Description
Parameters
- DigId
- ControlType
- ControlValue
Parameter Associations
Table: For the general digitizer settings
+ combination: For specifying to wait for the camera to perform its focusing operation.
+ combination: For specifying the speed and precision of the interpolation.
+ combination: For specifying the acquisition path
+ combination: For specifying whether the Feature Browser should be synchronous or asynchronous
+ combination: For specifying whether to enable anti-aliasing and/or dithering
Table: For the general reference settings
+ combination: For controlling the reference level of a specific acquisition path
+ combination: For specifying the reference level in Volts
Table: For controlling the input gain
+ combination: For specifying the acquisition path for the input gain
+ combination: For specifying the specific video signal component to apply the input-gain setting
Table: For routing I/O signals and setting their mode
+ combination: For specifying the type and number of the I/O signal to affect
Table: For setting the state of specified user-bits in a static-user-output register
+ combination: For specifying the bit in a static-user-output register to affect
+ combination: For specifying the static-user-output register
Table: For controlling the settings to grab using a trigger
+ combination: For specifying which I/O command register bit to use
Table: For controlling the settings of a timer
Table: For controlling the camera's exposure
+ combination: For specifying whether an IIDC camera specific feature can be turned on or off
+ combination: For specifying whether the control type relates to the camera or the board
Table: For controlling the settings of a rotary decoder
+ combination: For specifying which rotary decoder to set
Table: For controlling a data latch
+ combination: For specifying the data latch to affect
+ combination: For specifying which on-board timer to control
Type specific versions of the function when using a C compiler under 64-bit
Compilation information
Synopsis
Control a digitizer setting.
Syntax
void MdigControl(
MIL_ID DigId, //in
MIL_INT64 ControlType, //in
MIL_DOUBLE ControlValue //in
)
Description

This function allows you to control various digitizer settings.

Note that, when a control type has only one supported control value on a given system, it is not documented in this function because it cannot be changed to another value. Instead it can only be inquired.

To inquire the current value of a particular digitizer setting, use MdigInquire().

If you change the setting of a control type of a digitizer currently being used in a grab, the change does not affect the current grab. It does, however, affect the very next grab.

[Matrox Radient eCL; Matrox Radient eV-CL (requires Update 27); Matrox Radient eV-CLHS (requires Update 21); Matrox Radient eV-CXP; Matrox RadientPro-CL (requires Update 7); Matrox Solios eA/XA; Matrox Solios ecl/xcl/ev-cl; Matrox Vio]

Note that, to change this default behavior and have the change affect the digitizer even if it is currently being used in a grab, use M_COMMAND_QUEUE_MODE.

You can also interactively control and test most of the digitizer settings and obtain results in real-time, using Matrox Intellicam's Feature Browser. If your camera is connected to a CoaXPress (CXP) communication standard-compliant frame grabber (such as Matrox Radient eV-CXP), you can save digitizer (and camera) settings selected in Matrox Intellicam's Feature Browser to the DCF for your camera.

[Matrox IEEE 1394 IIDC driver]

The control types described in this function can control either the connected camera or the interface board (digitizer). When the control type is only available on the board, it is handled automatically by your board. In situations where the control type is available on both the camera and the board, you can use the M_CAMERA or the M_BOARD combination constant to specify which to control. When the control type is available on both the camera and the board and you don't specify which to control, it is handled automatically by your camera. If the camera does not support the standard feature, an error is generated. In this case, to use the control type with the board, you must use the M_BOARD combination constant.

In addition, the control types described in this function assume your interface board and standard-compliant camera support the associated IEEE IIDC 1394 standard-compliant feature.

[Matrox GigE Vision driver; Matrox GigE Vision driver (requires Update 25); Matrox USB3 Vision driver (requires Update 19)]

Typically, the supported control types affect the camera (or device) associated with the digitizer. This means that the control types described in this function assume your camera supports the associated GenICam standard feature naming convention (SFNC) feature. If the device does not support the GenICam SFNC feature, an error is generated. In case of error, use MdigControlFeature().

Note that there are several control types that are available on a Host system, even without any additional Matrox imaging boards; these are to control a simulated digitizer (allocated using MdigAlloc() with M_EMULATED). To see the control types available to control a simulated digitizer, select the Host system as your board type in this help file. For more information on simulated digitizers, refer to the Simulated digitizer section of Chapter 25: Grabbing with your digitizer.

Note that when using a C compiler (not a C++ or other compiler) in 64-bit mode, MdigControl() internally calls the MIL_INT64 version of this function (MdigControlInt64()). If you need to pass floating-point values, call the MIL_INT64 version of this function (MdigControlDouble()).
Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see which MIL system’s documentation you should use in its place and any possible differences.
Parameters
This function is not supported on the selected boards.
This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.
Parameters
DigId

Specifies the identifier of the digitizer.

ControlType

Specifies the digitizer setting to control.

See the Parameter associations section for possible values that can be specified.

ControlValue

Specifies the value to assign to the digitizer setting.

See the Parameter associations section for possible values that can be specified.

Parameter associations

The tables below list possible values for the ControlType and ControlValue parameters.

The following control types allow you to control various digitizer settings.

function map For the general digitizer settings
Click to summarize
ControlType		 Description MIL system-specific
tooltip (‡)
ControlValue
Click to summarize M_BAYER_COEFFICIENTS_ID

Loads the internal white balance coefficients buffer with the values in the specified buffer. To have your digitizer automatically calculate these coefficients and load them into the internal buffer, use the M_WHITE_BALANCE control type with M_CALCULATE. Note that the internal buffer only has an effect if the M_BAYER_CONVERSION and M_WHITE_BALANCE control types are enabled.

If you change the coefficient values in the specified buffer, you must call MdigControl() again with the updated buffer to load the new values into the internal white balance coefficients buffer. INQ

(summarize)
‡ c f k m o p q r s t
MIL system specific

Refer to your Matrox Imaging board's hardware manual for more details.

 ‡ k m p q r

Note that this control type is used to perform Bayer conversion if performed by the Host. To control the Bayer conversion on the camera, use MdigControlFeature(); refer to your camera's documentation for details regarding the features to set.

 ‡ c o s

Note that this control type is only supported on Matrox Solios eV-CLB and eV-CLBL.

 ‡ m

Note that this control type is only available when using Matrox Iris GT300C, GT1300C, and GT2000C.

 ‡ t

Note that this control type is only available when using Matrox Iris GT300C, GT1200C, and GT1900C.

 ‡ f
Click to summarize M_DEFAULT

Specifies to use the default coefficients that were automatically set, following a call to MdigAlloc(). The default coefficients are initially set in the DCF.

(summarize)
‡ c f o s t
Click to summarize MIL array buffer identifier

Specifies the identifier of an M_ARRAY buffer containing the white balance coefficients. The buffer must be allocated as a single-band 32-bit floating-point buffer with a 3x1 dimension. For more information, see the Correcting the white balance of your Bayer images subsection of the Using images acquired with a Bayer color filter section of Chapter 21: Data buffers.

(summarize)
‡ c f k m o p q r s t
Click to summarize M_BAYER_CONVERSION

Sets whether to perform a Bayer color conversion, using your digitizer. This control type can only be used when grabbing from a camera that has a Bayer color filter, otherwise an error will be generated.

For a more conventional technique of controlling Bayer conversion, use MbufBayer() and see the Correcting the white balance of your Bayer images subsection of the Using images acquired with a Bayer color filter section of Chapter 21: Data buffers. INQ

(summarize)
‡ c f k m o p q r s t
MIL system specific

Refer to your Matrox Imaging board's hardware manual for more details.

 ‡ k m p q r

Note that this control type is used to perform Bayer conversion if performed by the Host. To control the Bayer conversion on the camera, use MdigControlFeature(); refer to your camera's documentation for details regarding the features to set.

 ‡ c o s

Note that this control value is only supported on Matrox Solios eV-CLB and eV-CLBL.

 ‡ m

Note that this control type is only available when using Matrox Iris GT300C, GT1200C, and GT1900C.

 ‡ f

Note that this control type is only available when using Matrox Iris GT300C, GT1300C, and GT2000C.

 ‡ t
Click to summarize M_DEFAULT

Same as M_ENABLE.

 ‡ c f k m o p q r s t
Click to summarize M_DISABLE

Specifies to not perform Bayer conversion on the grabbed image.

 ‡ c f k m o p q r s t
Click to summarize M_ENABLE

Specifies to perform Bayer conversion on the grabbed image. Note that to white balance an image, M_WHITE_BALANCE must also be set to M_ENABLE.

(summarize)
‡ c f k m o p q r s t
Click to summarize M_CAMERA_COLOR_LOCK

Sets whether a color-lock check is done before starting each grab. This control type has an effect only when M_CAMERA_LOCK is enabled and/or when a camera lock was successful (established using MdigInquire() with M_CAMERA_LOCKED). Note that this control type is only applicable when the digitizer uses a composite or Y/C color DCF. INQ

(summarize)
‡ b g
Click to summarize M_DEFAULT

Same as M_ENABLE.

 ‡ b g
Click to summarize M_DISABLE

Specifies that a color-lock check will not be done.

 ‡ b g
Click to summarize M_ENABLE

Specifies that a color-lock check will be done.

 ‡ b g
Click to summarize M_CAMERA_LOCK

Sets whether to check if the camera is locked with the digitizer after channel-switching. Ensuring that the camera is locked after channel-switching is useful when the digitizer might not be synchronized with the source. When performing a channel-switch, the hardware needs to be unlocked from the current camera and locked to the new camera. If the hardware is not locked properly, it can affect the speed and reliability of the next grab. INQ

(summarize)
‡ b g l n
Click to summarize M_DEFAULT

Same as M_ENABLE.

 ‡ b g l n
Click to summarize M_DISABLE

Specifies that the grab operation (such as, MdigGrab()) grabs without verifying whether the digitizer is locked with the camera. Corrupt images or a synchronization-lost error can occur if the digitizer is not locked.

(summarize)
‡ b g l n
Click to summarize M_ENABLE

Specifies that the grab operation (such as, MdigGrab()) waits until the digitizer is locked with the camera before starting the grab.

 ‡ b g l n
Click to summarize M_CAMERA_LOCK_SENSITIVITY

Sets how sensitive the digitizer is to locking with the next camera, during a channel switch. The lock sensitivity determines how quickly a lock can occur and how reliable the lock is. This control type only has an effect if M_CAMERA_LOCK is disabled. INQ

(summarize)
‡ g
Click to summarize M_DEFAULT

Specifies the optimal compromise between speed and reliability, and varies depending on the Matrox Imaging board.

 ‡ g
Click to summarize 0 <= Value <= 511

Specifies the camera line-lock sensitivity level. 0 is the least reliable but has the fastest lock speed.

(summarize)
‡ g
Click to summarize M_CAMERA_UNLOCK_SENSITIVITY

Sets how sensitive the digitizer is to unlocking from the camera, during a channel switch. The unlock sensitivity determines how quickly an unlock can occur and how reliable the unlock is. This control type only has an effect if M_CAMERA_LOCK is enabled. INQ

(summarize)
‡ g
Click to summarize M_DEFAULT

Specifies the optimal compromise between speed and reliability, and varies depending on the Matrox Imaging board.

 ‡ g
Click to summarize 0 <= Value <= 255

Specifies the camera line-unlock sensitivity level. 0 is the least reliable but has the fastest unlock speed.

(summarize)
‡ g
Click to summarize M_CAPTURE_QUALITY +

Sets the capture quality of the image.

Note that this control type is IIDC camera specific. The camera must support the CAPTURE_QUALITY IIDC standard feature for this control type to be supported. INQ

(summarize)
‡ e
Click to summarize M_DEFAULT

Specifies to use the camera's default value or, if supported, to enable the camera's auto control state for this feature (that is, the camera adjusts this value automatically).

 ‡ e
Click to summarize M_OFF

Specifies that the camera's feature is turned off.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. By default, when turned on and the camera supports it, the camera adjusts the feature's value automatically.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. quality <= Value <= Max. quality

Specifies a value between the minimum and maximum values supported by the camera. Use MdigInquire() to determine these values.

Note that, if using M_CAPTURE_QUALITY + M_MODE_CONTROL, you must first set M_CAPTURE_QUALITY to M_ON for the value specified to take effect.

(summarize)
‡ e
Click to summarize M_CAPTURE_SIZE +

Sets the capture size of the image.

Note that this control type is IIDC camera specific. The camera must support the CAPTURE_SIZE IIDC standard feature for this control type to be supported. INQ

(summarize)
‡ e
Click to summarize M_DEFAULT

Specifies to use the camera's default value or, if supported, to enable the camera's auto control state for this feature(that is, the camera adjusts this value automatically).

 ‡ e
Click to summarize M_OFF

Specifies that the camera's feature is turned off.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. By default, when turned on and the camera supports it, the camera adjusts the feature's value automatically.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. size <= Value <= Max. size

Specifies a value between the minimum and maximum values supported by the camera. Use MdigInquire() to determine these values.

Note that, if using M_CAPTURE_SIZE + M_MODE_CONTROL, you must first set M_CAPTURE_SIZE to M_ON for the value specified to take effect.

(summarize)
‡ e
Click to summarize M_CHANNEL

Sets the channel on which the digitizer is to acquire data, as well as sets the synchronization channel to the default for the selected data channel. Note that, typically, this control type is only available when the specified digitizer uses acquisition paths with several multiplexed data inputs. This means that they have several data input channels but can only grab from one channel at a time. INQ

(summarize)
‡ b g i l n u
Click to summarize M_DEFAULT

Same as M_CH0.

 ‡ b g i l n u
Click to summarize M_CH0

Specifies channel 0 as the channel on which the digitizer is to receive input data.

(summarize)
‡ b g i l n u
MIL system specific

For monochrome or composite input, this corresponds to VID_IN0 .

 ‡ b g

For Y/C input, this corresponds to VID_IN0 (Y of camera 0) and VID_IN1 (C of camera 0).

 ‡ g

For DVI-D signals or when using RGB input, only this channel is available. It corresponds to analog green (CVBS0), analog blue (CVBS1), and analog red (CVBS2).

When using standard definition (SD) analog, it corresponds to HD/SD_SDI_IN0 on the external digital video input connectors.

 ‡ i u

This corresponds to a signal whose name ends with A.

 ‡ l

This channel is available only on the Matrox Vio Duo when operating in SDI input. It corresponds to HD/SD_SDI_IN0.

 ‡ n
Click to summarize M_CH1

Specifies channel 1 as the channel on which the digitizer is to receive input data.

(summarize)
‡ b g i l n u
MIL system specific

For monochrome or composite input, this corresponds to VID_IN1 .

 ‡ b g

This channel corresponds to a signal whose name ends with B.

 ‡ l

For Y/C input, this corresponds to VID_IN2 (Y of camera 1) and VID_IN3 (C of camera 1).

 ‡ g

This channel is available only on the Matrox Vio Duo when operating in SDI input. It corresponds to HD/SD_SDI_IN1 on the external digital video input connectors.

 ‡ n

When using standard definition (SD) analog, it corresponds to HD/SD_SDI_IN1 on the external digital video input connectors.

 ‡ i u
Click to summarize M_CH2

Specifies channel 2 as the channel on which the digitizer is to receive input data.

For composite color/monochrome input, this corresponds to VID_IN2 .

(summarize)
‡ b g i u
MIL system specific

For Y/C input, this corresponds to VID_IN4 (Y of camera 2) and VID_IN5 (C of camera 2).

 ‡ g
Click to summarize M_CH3

Specifies channel 3 as the channel on which the digitizer is to receive input data.

For composite color/monochrome input, this corresponds to VID_IN3 .

(summarize)
‡ b g
MIL system specific

For Y/C input, this corresponds to VID_IN6 (Y of camera 3) and VID_IN7 (C of camera 3).

 ‡ g
Click to summarize M_CH4

Specifies channel 4 as the channel on which the digitizer is to receive input data.

For composite color/monochrome input, this corresponds to VID_IN4 .

For Y/C input, this corresponds to VID_IN8 (Y of camera 4) and VID_IN9 (C of camera 4).

(summarize)
‡ g
Click to summarize M_CH5

Specifies channel 5 as the channel on which the digitizer is to receive input data.

For composite color/monochrome input, this corresponds to VID_IN5 .

For Y/C input, this corresponds to VID_IN10 (Y of camera 5) and VID_IN11 (C of camera 5).

(summarize)
‡ g
Click to summarize M_CH6

Specifies channel 6 as the channel on which the digitizer is to receive input data.

For composite color/monochrome input, this corresponds to VID_IN6 .

For Y/C input, this corresponds to VID_IN12 (Y of camera 6) and VID_IN13 (C of camera 6).

(summarize)
‡ g
Click to summarize M_CH7

Specifies channel 7 as the channel on which the digitizer is to receive input data.

For composite color/monochrome input, this corresponds to VID_IN7 .

For Y/C input, this corresponds to VID_IN14 (Y of camera 7) and VID_IN15 (C of camera 7).

(summarize)
‡ g
Click to summarize M_CH8

Specifies channel 8 as the channel on which the digitizer is to receive input data.

For composite color/monochrome input, this corresponds to VID_IN8 .

(summarize)
‡ g
Click to summarize M_CH9

Specifies channel 9 as the channel on which the digitizer is to receive input data.

For composite color/monochrome input, this corresponds to VID_IN9 .

(summarize)
‡ g
Click to summarize M_CH10

Specifies channel 10 as the channel on which the digitizer is to receive input data.

For composite color/monochrome input, this corresponds to VID_IN10 .

(summarize)
‡ g
Click to summarize M_CH11

Specifies channel 11 as the channel on which the digitizer is to receive input data.

For composite color/monochrome input, this corresponds to VID_IN11 .

(summarize)
‡ g
Click to summarize M_CH12

Specifies channel 12 as the channel on which the digitizer is to receive input data.

For composite color/monochrome input, this corresponds to VID_IN12 .

(summarize)
‡ g
Click to summarize M_CH13

Specifies channel 13 as the channel on which the digitizer is to receive input data.

For composite color/monochrome input, this corresponds to VID_IN13 .

(summarize)
‡ g
Click to summarize M_CH14

Specifies channel 14 as the channel on which the digitizer is to receive input data.

For composite color/monochrome input, this corresponds to VID_IN14 .

(summarize)
‡ g
Click to summarize M_CH15

Specifies channel 15 as the channel on which the digitizer is to receive input data.

For composite color/monochrome input, this corresponds to VID_IN15 .

(summarize)
‡ g
Click to summarize M_COMMAND_QUEUE_MODE

Sets whether changes to digitizer settings affect the digitizer immediately, even if it is currently being used in a grab, or the change will wait until the current grab is complete. INQ

(summarize)
‡ j k l m n p q r
Click to summarize M_DEFAULT

Same as M_QUEUED.

 ‡ j k l m n p q r
Click to summarize M_IMMEDIATE

Specifies that, if you change the setting of a control type of a digitizer currently being used in a grab, the change affects the current grab. Note that, this can cause the grabbed image to become corrupt.

(summarize)
‡ j k l m n p q r
Click to summarize M_QUEUED

Specifies that, if you change the setting of a control type of a digitizer currently being used in a grab, the change does not affect the current grab. Instead, the changes are queued and applied before the very next grab.

(summarize)
‡ j k l m n p q r
Click to summarize M_CORRUPTED_FRAME_ERROR

Sets whether an error is generated when a corrupted or incomplete frame is grabbed. INQ

(summarize)
‡ c f i o s t u
MIL system specific

Note that whether the grabbed image is corrupt can always be inquired using MdigGetHookInfo() with M_CORRUPTED_FRAME from the user-defined function hooked to the end of a grab using MdigProcess().

 ‡ c o s
Click to summarize M_DEFAULT

Same as M_ENABLE.

 ‡ c f i o s t u
Click to summarize M_DISABLE

Specifies not to generate an error when grabbing a corrupted frame.

 ‡ c f i o s t u
Click to summarize M_ENABLE

Specifies to generate an error when grabbing a corrupted frame.

 ‡ c f i o s t u
Click to summarize M_DIGITIZER_INTERNAL_BUFFERS_NUM

Sets the number of internal grab buffers allocated and used when MIL cannot grab directly into the specified buffers (for example, when the grab buffer's format is not compatible with the camera's current pixel format or when the image sent from the GenICam SFNC-compliant camera has additional information that needs to be stripped out to make the grabbed image compatible with MIL buffers, such as when GenICam "chunk mode" is enabled). INQ

(summarize)
‡ c o s
Click to summarize M_DEFAULT

Specifies the default value; the default value is 5.

 ‡ c o s
Click to summarize Value >= 0

Specifies the number of internal grab buffers.

 ‡ c o s
Click to summarize M_FIX_PATTERN_NOISE_CORRECTION

Sets the type of fixed pattern noise correction to apply when acquiring images. Note that, acquisition must be stopped prior to changing this control type. INQ

(summarize)
‡ t
Click to summarize M_DEFAULT

Same as M_PREPROCESSING.

 ‡ t
Click to summarize M_PREPROCESSING

Specifies a correction for dark signal non-uniformity and for photo response non-uniformity, applied to the grabbed images. MIL calculates the correction factor(s) when the control type is called.

(summarize)
‡ t
Click to summarize M_SENSOR

Specifies a correction for dark signal non-uniformity, applied to the grabbed images. MIL adjusts the correction factor for each image.

(summarize)
‡ t
Click to summarize M_FOCUS +

Sets the lens focus capabilities. INQ

(summarize)
‡ e t
MIL system specific

Note that this control type is IIDC camera specific. The camera must support the FOCUS IIDC standard feature for this control type to be supported.

 ‡ e

Note that this control type requires that your Matrox Iris GTR use an I 2 C (inter-integrated circuit) controlled lens.

 ‡ t
Click to summarize M_DEFAULT

Specifies to use the camera's default value or, if supported, to enable the camera's auto control state for this feature (that is, the camera adjusts this value automatically).

 ‡ e
Click to summarize M_OFF

Specifies that the camera's feature is turned off.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. By default, when turned on and the camera supports it, the camera adjusts the feature's value automatically.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. focus <= Value <= Max. focus

Specifies a value between the minimum and maximum values supported by the camera. Use MdigInquire() to determine these values.

Note that, if using M_FOCUS + M_MODE_CONTROL, you must first set M_FOCUS to M_ON for the value specified to take effect.

(summarize)
‡ e t
Click to summarize M_GAMMA +

Sets the difference between the incoming light level and output light level in the grabbed image.

Note that this control type is IIDC camera specific. The camera must support the GAMMA IIDC standard feature for this control type to be supported. INQ

(summarize)
‡ e
Click to summarize M_DEFAULT

Specifies to use the camera's default value or, if supported, to enable the camera's auto control state for this feature (that is, the camera adjusts this value automatically).

 ‡ e
Click to summarize M_OFF

Specifies that the camera's feature is turned off.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. By default, when turned on and the camera supports it, the camera adjusts the feature's value automatically.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. gamma <= Value <= Max. gamma

Specifies a value between the minimum and maximum values supported by the camera.

Use MdigInquire() to determine the minimum and maximum values.

Note that, if using M_GAMMA + M_MODE_CONTROL, you must first set M_GAMMA to M_ON for the value specified to take effect.

(summarize)
‡ e
Click to summarize M_GC_CLPROTOCOL

Sets whether the GenICam CLProtocol module is enabled. The GenICam CLProtocol module allows Camera Link cameras to be accessed using GenICam-specific constants (including M_GC_FEATURE_BROWSER), as well as using MdigControlFeature() and MdigInquireFeature().

Even when the GenICam CLProtocol module is enabled, you should follow the MIL documentation specific to your board; if a control type requires the CLProtocol module to be enabled, it will be noted.

Note that this control type should be enabled only after the required third-party vendor-supplied, standard compliant, CLProtocol library for the Camera Link camera is installed on your computer and M_GC_CLPROTOCOL_DEVICE_ID is set. INQ

(summarize)
‡ j m p r
Click to summarize M_DEFAULT

Same as M_DISABLE.

 ‡ j m p r
Click to summarize M_DISABLE

Specifies that the GenICam CLProtocol module is disabled.

 ‡ j m p r
Click to summarize M_ENABLE

Specifies that the GenICam CLProtocol module is enabled.

 ‡ j m p r
Click to summarize M_GC_CLPROTOCOL_DEVICE_ID

Identifies the Camera Link camera connected to your digitizer, as well as the GenICam CLProtocol library for the camera. When allocating a digitizer for a camera, the digitizer identifies that the connected device is a camera; M_GC_CLPROTOCOL_DEVICE_ID provides the digitizer with the details required to identify a specific Camera Link camera and its corresponding GenICam CLProtocol library.

Note that, this control type is only available if you first install the required third-party vendor-supplied, standard complaint, CLProtocol library.

To enumerate the complete list of camera identifiers installed on your computer, use MdigInquire() with M_GC_CLPROTOCOL_DEVICE_ID + n. For an example, see CLProtocol.cpp.

Even after the library to use has been specified, you must enable the CLProtocol module (with M_GC_CLPROTOCOL set to M_ENABLE) before you can use a Matrox GenICam constant (including M_GC_FEATURE_BROWSER), or use MdigControlFeature(), or MdigInquireFeature(). INQ

(summarize)
‡ j m p r
Click to summarize
M_PTR_TO_DOUBLE(
MIL_CONST_TEXT_PTR * String
)

Casts the address of the string identifying the specified Camera Link camera and its corresponding GenICam CLProtocol library, from a MIL_CONST_TEXT_PTR to a MIL_DOUBLE. The specified identifier string must contain sufficient data to uniquely identify the Camera Link camera and its GenICam CLProtocol library.

(summarize)
‡ j m p r
Parameters

This parameter specifies the string whose address to cast.

 ‡ j m p r
MIL_TEXT("CameraLinkCameraIdentifier") 1

Specifies the identifier string of your Camera Link camera and its corresponding GenICam CLProtocol library.

The specified string should contain the tokens separated by the hash ("#") sign instead of back slashes (for example, "LibraryDirectory#LibraryFileName#Manufacturer#Family#Model#Version). Each of these tokens must follow the naming convention for C variables.
‡ j m p r
MIL_TEXT("M_DEFAULT") 1

Specifies to use the default identifier string of your Camera Link camera and its corresponding GenICam CLProtocol library, specified using the MILConfig utility.
‡ j m p r
Click to summarize M_GC_FEATURE_BROWSER
[This is only applicable to Windows]

Sets whether to open or close a dialog box that allows you to view and edit the GenICam SFNC-compliant camera configuration information interactively, using a limited version of Matrox Intellicam's Feature Browser.

(summarize)
‡ c j k m o p q r s u
MIL system specific

Note that, this control type is only available if you first install the third-party, vendor-supplied, standard compliant CLProtocol library for the Camera Link camera connected to your digitizer. In addition, the GenICam CLProtocol module must be enabled, using M_GC_CLPROTOCOL set to M_ENABLE.

 ‡ j m p r
Click to summarize M_DEFAULT

Same as M_OPEN.

 ‡ c j k m o p q r s u
Click to summarize M_CLOSE

Closes the Feature Browser.

 ‡ c j k m o p q r s u
Click to summarize M_OPEN +

Opens the Feature Browser.

(summarize)
‡ c j k m o p q r s u
MIL system specific

You must specify a combination value from the following table:
‡ c k m o q s u
Click to summarize M_GC_FEATURE_POLLING

Sets whether Feature Browser will periodically poll camera features that can automatically change on the camera, for updates (for example, the camera's temperature). The camera's device description file (XML) defines these feature as pollable. To learn whether a camera feature is pollable, refer to your camera's documentation.

If this control type is enabled, these features will be polled periodically and Feature Browser (if open either through Matrox Intellicam or launched using M_GC_FEATURE_BROWSER) will be updated automatically with this information. The polling period is determined by MIL and throttled with respect to available bandwidth.

If this control type is disabled, Feature Browser will display the initial value of the pollable features and not update them until the user clicks upon their corresponding display field in Feature Browser. Note that MdigInquire() and MdigInquireFeature() always return information that comes from the camera at the time of the inquire, regardless of whether feature polling is enabled or not.

Note that this control type does not enable execution-polling completion of executable commands. To enable execution-polling completion, use MsysControl() with M_GC_FEATURE_EXECUTE_POLLING_MODE. INQ

(summarize)
‡ c j k m o p q r s
MIL system specific

Note that, this control type is only available if you first install the third-party, vendor-supplied, standard compliant CLProtocol library for the Camera Link camera connected to your digitizer. In addition, the GenICam CLProtocol module must be enabled, using M_GC_CLPROTOCOL set to M_ENABLE.

 ‡ j m p r
Click to summarize M_DEFAULT

Same as M_DISABLE.

 ‡ c j k m o p q r s
Click to summarize M_DISABLE

Specifies that automatically changing camera features will not be polled.

 ‡ c j k m o p q r s
Click to summarize M_ENABLE

Specifies that automatically changing camera features will be polled.

 ‡ c j k m o p q r s
Click to summarize M_GC_FRAME_MAX_RETRIES

Sets the maximum number of times packets should be re-sent before flagging their associated frame as corrupt. Each packet can be re-sent the number of times specified using M_GC_PACKET_MAX_RETRIES. When the total number of packet re-sends is equal to M_GC_FRAME_MAX_RETRIES, the frame is flagged as corrupt (for example, if each packet can be re-sent 3 times and the frame's maximum retries is set to 30, a total of 30 packets associated with the frame can be re-sent before the frame is flagged as corrupt).

To establish the number of frames corrupted, use MdigInquire() with M_GC_TOTAL_FRAMES_MISSED, Matrox Capture Assistant, or Matrox Intellicam's Feature Browser. INQ

(summarize)
‡ c s
Click to summarize M_DEFAULT

Specifies the default value; the default value is 30.

 ‡ c s
Click to summarize Value >= M_GC_PACKET_MAX_RETRIES

Specifies the maximum number of times to retry sending the packets of a frame.

Note that this value should always be greater than or equal to M_GC_PACKET_MAX_RETRIES.

(summarize)
‡ c s
Click to summarize M_GC_FRAME_TIMEOUT

Sets the maximum amount of time to wait for the remaining packets of a frame, after receiving the trailer packet. If the missing packets are not returned within this time period, the corresponding frame is flagged as corrupt. To establish the number of corrupt frames, use MdigInquire() with M_GC_TOTAL_FRAMES_MISSED, Matrox Capture Assistant, or Matrox Intellicam's Feature Browser. INQ

(summarize)
‡ c s
Click to summarize M_DEFAULT

Specifies the default value; the default value is 100 msecs.

 ‡ c s
Click to summarize Value >= 0

Specifies the maximum time to wait, in msecs.

 ‡ c s
Click to summarize M_GC_HEARTBEAT_STATE

Sets whether the heartbeat mechanism is used to keep the GenICam SFNC-compliant camera active. The heartbeat mechanism is used to inform your GenICam SFNC-compliant camera that communication between your MIL application and the camera is still likely (for example, your application is delayed in requesting a grab due to processing). INQ

(summarize)
‡ c s
Click to summarize M_DEFAULT

Same as M_ENABLE.

 ‡ c s
Click to summarize M_DISABLE

Specifies that the heartbeat mechanism is disabled. The GenICam SFNC-compliant camera assumes communication will continue and remains active.

(summarize)
‡ c s
Click to summarize M_ENABLE

Specifies that the heartbeat mechanism is enabled. If, after the heartbeat timeout value expires, the GenICam SFNC-compliant camera assumes there will be no further communication and shuts down.

(summarize)
‡ c s
Click to summarize M_GC_HEARTBEAT_TIMEOUT

Sets the amount of time that your GenICam SFNC-compliant camera will wait after the last communication before shutting down. INQ

(summarize)
‡ c s
Click to summarize M_DEFAULT

Specifies the default value; the default value is 5000 msecs.

 ‡ c s
Click to summarize Value >= 0

Specifies the amount of time, in msecs.

 ‡ c s
Click to summarize M_GC_INTER_PACKET_DELAY

Sets the delay between packets sent by your camera when transmitting a stream of image packets.

The unit used is a timestamp tick. If you know the inter-packet delay in secs, use the following calculation to convert from timestamp ticks to secs: (1/m)*n , where m is the frequency of the timestamp ticks (to inquire this value, use MdigInquire() with M_GC_COUNTER_TICK_FREQUENCY), and n is your inter-packet delay value. INQ

(summarize)
‡ c s
Click to summarize Value >= 0

Specifies the delay, in timestamp ticks.

 ‡ c s
Click to summarize M_GC_MAX_NBR_PACKETS_OUT_OF_ORDER

Sets the maximum number of packets that can be received out-of-order, before the associated frame is marked as corrupt. This is useful when using link-aggregated cameras, where packets are typically received out-of-order. To establish the number of packets currently received out-of-order, use MdigInquire() with M_GC_MAX_NBR_PACKETS_OUT_OF_ORDER, Matrox Capture Assistant, or Matrox Intellicam's Feature Browser. INQ

(summarize)
‡ c s
Click to summarize M_DEFAULT

Specifies the default value; the default value is 0.

 ‡ c s
Click to summarize Value >= 0

Specifies the maximum number of out-of-order packets to receive.

 ‡ c s
Click to summarize M_GC_MESSAGE_CHANNEL_MULTICAST_ADDRESS_STRING

Sets the IP address used for the multicast message channel of your GenICam SFNC-compliant camera. This IP address is set by MIL within the reserved range of multicast IP addresses (239.0.0.0 to 239.255.255.255). This control type should be changed only if there is a multicast conflict. Note that, with a multicast conflict, the multicast IP address and/or the UDP port assignment can be in conflict. If the problem persists after changing the multicast IP address, you can try changing the default UDP port assignment, using M_GC_MESSAGE_PORT.

This control type is only available when dealing with a multicast master or slave (allocated using MdigAlloc() with M_GC_MULTICAST_MASTER or M_GC_MULTICAST_SLAVE). For more information on using a multicast IP address, refer to the Using IP multicast section of Chapter 4: Matrox GigE Vision driver. INQ

(summarize)
‡ c s
Click to summarize
M_PTR_TO_DOUBLE(
MIL_CONST_TEXT_PTR * String
)

Casts the string with the specified multicast IP address of the GenICam SFNC-compliant camera from a MIL_CONST_TEXT_PTR to a MIL_DOUBLE. The size of this string is determined by calling MdigInquire() with M_GC_MESSAGE_CHANNEL_MULTICAST_ADDRESS_STRING_SIZE.

(summarize)
‡ c s
Parameters

This parameter specifies the string whose address to cast.

 ‡ c s
MIL_TEXT("239.n.n.n") 1

Specifies the multicast IP address of the GenICam SFNC-compliant camera, in dotted decimal notation where each dotted decimal value (n) is a number between 0 and 255.
‡ c s
Click to summarize M_GC_MESSAGE_PORT

Sets the UDP port number used for the multicast message channel of your GenICam SFNC-compliant camera. By default, this port number is set by MIL. This control type should be changed only if there is a multicast conflict. Note that, with a multicast conflict, the multicast IP address and/or the UDP port assignment can be in conflict. If the problem persists after changing the message port, you can try changing the default multicast IP address, using M_GC_MESSAGE_CHANNEL_MULTICAST_ADDRESS_STRING.

This control type is only available when dealing with a multicast master or slave (allocated using MdigAlloc() with M_GC_MULTICAST_MASTER or M_GC_MULTICAST_SLAVE). For more information on using a multicast IP address, refer to the Using IP multicast section of Chapter 4: Matrox GigE Vision driver. INQ

(summarize)
‡ c s
Click to summarize Value >= 0

Specifies the UDP port number to use.

 ‡ c s
Click to summarize M_GC_PACKET_MAX_RETRIES

Sets the maximum number of times each packet can be re-sent. If the maximum number of times a packet can be re-sent is reached, the packet is flagged as corrupted. INQ

(summarize)
‡ c s
Click to summarize M_DEFAULT

Specifies the default value; the default value is 3.

 ‡ c s
Click to summarize Value >= M_GC_FRAME_MAX_RETRIES

Specifies the maximum number of times to resend a given packet of a frame.

Note that this value should always be less than M_GC_FRAME_MAX_RETRIES.

(summarize)
‡ c s
Click to summarize M_GC_PACKET_RESEND

Sets whether to request packets be re-sent from your GenICam SFNC-compliant camera, if the packets are not received properly (for example, when the packets are received out-of-order, or a packet timeout occurs). The request is issued up to a maximum number of times for each packet, set using M_GC_PACKET_MAX_RETRIES. INQ

(summarize)
‡ c s
Click to summarize M_DISABLE

Specifies that packets should never be re-sent.

 ‡ c s
Click to summarize M_ENABLE

Specifies that packets should be re-sent as required.

This is the default value.

(summarize)
‡ c s
Click to summarize M_GC_PACKET_SIZE

Sets the packet size used by the GigE Vision-compliant camera when streaming data to the Host. By default, Matrox's GigE Vision driver negotiates the largest possible packet size with the GigE Vision-compliant camera. This control type should only be changed if the negotiated size is causing errors in acquisition (such as image corruption). INQ

(summarize)
‡ c s
Click to summarize Value >= 0

Specifies the packet size, in bytes. Typical packet sizes range from 512 bytes to 1.5 Kbytes. Jumbo packets, if enabled on your network and compatible with both your GigE Vision device and your firewall, are up to 9 Kbytes in size.

(summarize)
‡ c s
Click to summarize M_GC_PACKET_TIMEOUT

Sets the maximum amount of time to wait before flagging a packet as dropped. INQ

(summarize)
‡ c s
Click to summarize M_DEFAULT

Specifies the default value; the default value is 10 msecs.

 ‡ c s
Click to summarize Value >= 0

Specifies the maximum time to wait, in msecs.

 ‡ c s
Click to summarize M_GC_PIXEL_FORMAT

Sets the pixel format that the digitizer should use to create internal buffers to receive images from the camera, if the digitizer is a multicast monitor digitizer. The pixel format cannot be inquired from the GigE Vision-compliant camera. It must therefore be set using this control type or a DCF. To set this value to the same pixel format as received image data, use MdigInquire() with M_SOURCE_DATA_FORMAT; in this case, you must first grab into an arbitrary image buffer and then issue the inquire. INQ

(summarize)
‡ c s
Click to summarize M_DEFAULT

Same as specified in the DCF.

 ‡ c s
Click to summarize Value

Specifies the data depth and raw color format to use to create the internal buffers. The GenICam predefined list of pixel formats are in the PFNC.h header file in MIL installation folder, under the include\MilDyn subfolder.

(summarize)
‡ c s
Click to summarize M_GC_PIXEL_FORMAT_SWITCHING

Sets whether to allow the camera's pixel format to change automatically to match the current grab buffer, when supported by the GenICam-compatible camera. INQ

(summarize)
‡ c o s
Click to summarize M_DEFAULT

Same as M_ENABLE.

 ‡ c o s
Click to summarize M_DISABLE

Specifies to disable automatic pixel format switching.

 ‡ c o s
Click to summarize M_ENABLE

Specifies to enable automatic pixel format switching.

 ‡ c o s
Click to summarize M_GC_STATISTICS_RESET

Resets the acquisition statistics. For a list of GenICam-compliant statistics available in MIL, refer to MdigInquire() with M_GC_TOTAL_..., Matrox Capture Assistant, or Matrox Intellicam's Feature Browser.

(summarize)
‡ c o s
Click to summarize M_DEFAULT

Implements the default behavior.

 ‡ c o s
Click to summarize M_GC_STREAM_CHANNEL_MULTICAST_ADDRESS_STRING

Sets the IP address used for the multicast stream channel of your GenICam SFNC-compliant camera. By default, this address is set by MIL within a limited range of multicast addresses (239.0.0.0 to 239.255.255.255). This control type should be changed only if there is a multicast conflict. Note that, with a multicast conflict, the multicast IP address and/or the UDP port assignment can be in conflict. If the problem persists after changing the multicast IP address, you can try changing the default UDP port assignment, using M_GC_STREAM_PORT.

This control type is only available when dealing with a multicast master or slave (allocated using MdigAlloc() with M_GC_MULTICAST_MASTER or M_GC_MULTICAST_SLAVE). For more information on using a multicast IP address, refer to the Using IP multicast section of Chapter 4: Matrox GigE Vision driver. INQ

(summarize)
‡ c s
Click to summarize
M_PTR_TO_DOUBLE(
MIL_CONST_TEXT_PTR * String
)

Casts the string with the specified multicast IP address of the GenICam SFNC-compliant camera from a MIL_CONST_TEXT_PTR to a MIL_DOUBLE. While MIL assigns an address within a limited range of multicast IP addresses (239.0.0.0 to 239.255.255.255), the full range is available (224.0.0.0 to 239.255.255.255). You can determine the size of this string by calling MdigInquire() with M_GC_STREAM_CHANNEL_MULTICAST_ADDRESS_STRING_SIZE.

(summarize)
‡ c s
Parameters

This parameter specifies the string whose address to cast.

 ‡ c s
MIL_TEXT("2nn.n.n.n") 1

Specifies the multicast IP address of the GenICam SFNC-compliant camera, in dotted decimal notation where each dotted decimal value (n) is a number between 0 and 255.
‡ c s
Click to summarize M_GC_STREAM_PORT

Sets the UDP port number used for the multicast stream channel of your GenICam SFNC-compliant camera. By default, this port number is set by MIL within the reserved range of multicast port numbers. This control type should be changed only if there is a multicast conflict. Note that, with a multicast conflict, the multicast IP address and/or the UDP port assignment can be in conflict. If the problem persists after changing the stream port, you can try changing the default multicast IP address, using M_GC_STREAM_CHANNEL_MULTICAST_ADDRESS_STRING.

This control type is only available when dealing with a multicast master or slave (allocated using MdigAlloc() with M_GC_MULTICAST_MASTER or M_GC_MULTICAST_SLAVE). For more information on using a multicast IP address, refer to the Using IP multicast section of Chapter 4: Matrox GigE Vision driver. INQ

(summarize)
‡ c s
Click to summarize Value >= 0

Specifies the UDP port number to use.

 ‡ c s
Click to summarize M_GC_STREAMING_MODE

Sets the camera's image stream activation mechanism. Typically, this control type is used when performing a monoshot grab in a loop. Since the camera cannot tell when the next grab might arrive, you can either manually control the image stream (starting it before the first grab and stopping it after the last one), or allow MIL to handle it automatically (using M_GC_STREAMING_STOP_CHECK_PERIOD and M_GC_STREAMING_STOP_DELAY to control the delay between the grab and when the image stream is stopped). Reducing the time during which images are streamed to the Host can reduce bandwidth requirements. INQ

(summarize)
‡ c k o q s
Click to summarize M_DEFAULT

Same as M_AUTOMATIC.

 ‡ c k o q s
Click to summarize M_AUTOMATIC

Specifies that the image stream is started and stopped automatically.

Use M_GC_STREAMING_STOP_CHECK_PERIOD and M_GC_STREAMING_STOP_DELAY to control the delay between the grab and when the image stream is stopped.

(summarize)
‡ c k o q s
Click to summarize M_MANUAL

Specifies that the image stream is started and stopped manually. Use M_GC_STREAMING_START and M_GC_STREAMING_STOP.

(summarize)
‡ c k o q s
Click to summarize M_GC_STREAMING_START

Starts the camera's image stream. Note that this control type is only available when M_GC_STREAMING_MODE is set to M_MANUAL.

(summarize)
‡ c k o q s
Click to summarize M_DEFAULT

Implements the default behavior.

 ‡ c k o q s
Click to summarize M_GC_STREAMING_STOP

Stops the camera's image stream. Note that this control type is only available when M_GC_STREAMING_MODE is set to M_MANUAL.

(summarize)
‡ c k o q s
Click to summarize M_DEFAULT

Implements the default behavior.

 ‡ c k o q s
Click to summarize M_GC_STREAMING_STOP_CHECK_PERIOD

Sets the maximum amount of time to wait before MIL checks to see whether a grab is pending. If there is no grab pending after this delay, a second check is made after a second delay (set using M_GC_STREAMING_STOP_DELAY). If there is still no grab pending, then MIL stops the digitizer from streaming images.

Note that this control type is only available when M_GC_STREAMING_MODE is set to M_AUTOMATIC. INQ

(summarize)
‡ c k o q s
Click to summarize M_DEFAULT

Specifies the default value; the default value is 1000 msecs.

 ‡ c k o q s
Click to summarize Value >= 0

Specifies the amount of time, in msecs.

 ‡ c k o q s
Click to summarize M_GC_STREAMING_STOP_DELAY

Sets the amount of time to wait before stopping the image stream, if no grab is pending. Note that this delay occurs after the first check for pending grabs (set using M_GC_STREAMING_STOP_CHECK_PERIOD).

Note that this control type is only available when M_GC_STREAMING_MODE is set to M_AUTOMATIC. INQ

(summarize)
‡ c k o q s
Click to summarize M_DEFAULT

Specifies the default value; the default value is 0 msecs.

 ‡ c k o q s
Click to summarize Value >= 0

Specifies the amount of time, in msecs.

 ‡ c k o q s
Click to summarize M_GC_UPDATE_MULTICAST_INFO

Updates the multicast information on the master, slave, or monitor digitizer. The multicast information includes the IP address and port number used for the multicast stream and message channels of your GigE Vision-compliant camera.

When used with the multicast master digitizer (allocated using MdigAlloc() with M_GC_MULTICAST_MASTER), this control type updates the master digitizer's multicast information after you manually change it on the camera (using M_GC_STREAM_CHANNEL_MULTICAST_ADDRESS_STRING, M_GC_STREAM_PORT, M_GC_MESSAGE_CHANNEL_MULTICAST_ADDRESS_STRING, and/or M_GC_MESSAGE_PORT).

When used with a multicast slave digitizer (allocated using MdigAlloc() with M_GC_MULTICAST_SLAVE), this control type is used to update the local copy of the slave digitizer's multicast information after the multicast master digitizer disconnects with the camera and reconnects using a different multicast IP address and/or port number.

When used with a multicast monitor digitizer (allocated using MdigAlloc() with M_GC_MULTICAST_MONITOR), this control type is used to update the monitor digitizer's multicast information after you change the multicast stream channel address and port address manually for the digitizer.

To verify that the multicast master is connected, use MdigInquire() with M_GC_MULTICAST_MASTER_CONNECTED.

To detect when the image stream stops, check the number of images grabbed with MdigProcess(), using MdigInquire() with M_PROCESS_FRAME_COUNT before and after a wait period.

For more information on multicast IP addresses, refer to the Using IP multicast section of Chapter 4: Matrox GigE Vision driver.

(summarize)
‡ c s
Click to summarize M_DEFAULT

Implements the default behavior.

 ‡ c s
Click to summarize M_GC_USER_NAME

Sets the camera's name. INQ

(summarize)
‡ c o s
Click to summarize
M_PTR_TO_DOUBLE(
MIL_CONST_TEXT_PTR * String
)

Casts the address of the string identifying the camera's name, from a MIL_CONST_TEXT_PTR to a MIL_DOUBLE.

(summarize)
‡ c o s
Parameters

This parameter specifies the string whose address to cast.

 ‡ c o s
MIL_TEXT("CameraName") 1

Specifies the name of the camera. Note that this string can be 16 characters long (including the null-terminating character) and must use the UTF-8 character set.
‡ c o s
Click to summarize M_GRAB_ABORT

Immediately stops a grab in progress and aborts queued grabs. This is useful for canceling a triggered grab that is waiting for a trigger.

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
MIL system specific

Note that, for this control type to function on the Host, you must pass a simulated digitizer (allocated using MdigAlloc() with M_EMULATED).

 ‡ a
Click to summarize M_DEFAULT

Implements the default behavior.

 ‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize M_GRAB_DIRECTION_X

Sets the horizontal grab direction. INQ

(summarize)
‡ b c e f g h j k l m o p q r s t u
Click to summarize M_DEFAULT

Same as M_FORWARD.

 ‡ b c e f g h j k l m o p q r s t u
Click to summarize M_FORWARD

Specifies to grab from left to right, in the horizontal direction.

 ‡ b c e f g h j k l m o p q r s t u
Click to summarize M_REVERSE

Specifies to grab from right to left, in the horizontal direction. Effectively, this flips the grabbed image horizontally.

(summarize)
‡ b c e f g h j k l m o p q r s t u
Click to summarize M_GRAB_DIRECTION_Y

Sets the vertical grab direction. INQ

(summarize)
‡ b c e f g h j k l m n o p q r s t u
Click to summarize M_DEFAULT

Same as M_FORWARD.

 ‡ b c e f g h j k l m n o p q r s t u
Click to summarize M_FORWARD

Specifies to grab from top to bottom, in the vertical direction.

 ‡ b c e f g h j k l m n o p q r s t u
Click to summarize M_REVERSE

Specifies to grab from bottom to top, in the vertical direction. Effectively, this flips the grabbed image vertically.

(summarize)
‡ b c e f g h j k l m n o p q r s t u
Click to summarize M_GRAB_FAIL_CHECK

Sets whether and when to log a grab-fail error. INQ

(summarize)
‡ b
Click to summarize M_DEFAULT

Same as M_FINAL_GRAB.

 ‡ b
Click to summarize M_DISABLE

Specifies not to log grab failures.

 ‡ b
Click to summarize M_ENABLE

Specifies to log all grab failures.

 ‡ b
Click to summarize M_FINAL_GRAB

Specifies to log monoshot grab failures and to log the failure to grab the last frame of a continuous grab.

 ‡ b
Click to summarize M_GRAB_FAIL_RETRY_NUMBER

Sets the number of retries when a field or frame grab fails. INQ

(summarize)
‡ b
Click to summarize M_DEFAULT

Specifies the default value; the default value is 1.

 ‡ b
Click to summarize 0 <= Value <= 255

Specifies the number of times to retry.

 ‡ b
Click to summarize M_GRAB_FIELD_NUM

Sets the number of fields to grab when grabbing data with MdigGrab().

This control type should only be used with interlaced cameras. When using progressive cameras, set this control type to 1. INQ

(summarize)
‡ b e g h i l m n u
Click to summarize M_DEFAULT

Specifies the default value.

(summarize)
‡ b e g h i l m n u
MIL system specific

For interlaced cameras, the default is 2. For progressive cameras, the default is 1.

 ‡ b g h i l m n u

Specifies to use the camera's default value.

 ‡ e
Click to summarize 1

Specifies to grab one field. The grabbed field is written to sequential rows of the grab buffer. When set to 1, each field is treated like a frame and the following digitizer events occur relative to the grabbed field: M_GRAB_FRAME_START, M_GRAB_END, and M_GRAB_FRAME_END.

To achieve 60 fps in NTSC or 50 fps in PAL, M_GRAB_START_MODE must be set to M_FIELD_START.

(summarize)
‡ b e g h i l m n u
Click to summarize 2

Specifies to grab two fields.

 ‡ b e g h i l m n u
Click to summarize M_GRAB_FRAME_MISSED_COUNTER

Sets whether to count the number of frames sent by the camera, but not received by the digitizer when performing a grab operation (that is, MdigGrab(), MdigGrabContinuous(), or MdigProcess()).

To inquire the current value of this counter, use MdigInquire() with M_GRAB_FRAME_MISSED. INQ

(summarize)
‡ j k p q r
Click to summarize M_DEFAULT

Same as M_DISABLE.

 ‡ j k p q r
Click to summarize M_DISABLE

Specifies to disable frames missed detection.

 ‡ j k p q r
Click to summarize M_ENABLE

Specifies to enable frames missed detection.

 ‡ j k p q r
Click to summarize M_GRAB_FRAME_MISSED_RESET

Resets the counter for the number of frames sent by the camera but not received by the digitizer.

(summarize)
‡ j k p q r
Click to summarize M_DEFAULT

Implements the default behavior.

 ‡ j k p q r
Click to summarize M_GRAB_LINE_COUNTER

Sets whether a function hooked to an M_GRAB_END, M_ROTARY_ENCODER, or M_GRAB_FRAME_END event can inquire the number of lines grabbed, performed using MdigGrab(), MdigGrabContinuous(), or MdigProcess(); the function could have been hooked using either MdigProcess() or MdigHookFunction(). To inquire the number of lines grabbed at any other time, use MdigGetHookInfo() with M_GRAB_LINE_COUNT. INQ

(summarize)
‡ j k l m p q r
Click to summarize M_DEFAULT

Same as M_DISABLE.

 ‡ j k l m p q r
Click to summarize M_DISABLE

Specifies that the hooked function cannot inquire the number of lines grabbed.

 ‡ j k l m p q r
Click to summarize M_ENABLE

Specifies that the hooked function can inquire the number of lines grabbed.

 ‡ j k l m p q r
Click to summarize M_GRAB_LUT_PALETTE

Sets which LUT to use.

Note that this control value is only supported on color cameras. INQ

(summarize)
‡ t
Click to summarize M_DEFAULT

Specifies to use a 3-band RGB LUT.

 ‡ t
Click to summarize M_GAMMA

Specifies to use the native Bayer LUT that is applied to the Bayer image before it is converted to an RGB image.

 ‡ t
Click to summarize M_GRAB_MODE

Sets how the grab should be synchronized with the Host when grabbing data with MdigGrab(). Note that this does not affect MdigGrabContinuous(), which always runs asynchronously; otherwise, MdigHalt() could not stop the grab. In addition, this control type does not affect MdigProcess(). INQ

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
MIL system specific

Note that this control type automatically controls your board. It is not available to control the camera.

 ‡ e

Note that, for this control type to function on the Host, you must pass a simulated digitizer (allocated using MdigAlloc() with M_EMULATED).

 ‡ a
Click to summarize M_DEFAULT

Same as M_SYNCHRONOUS.

 ‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize M_ASYNCHRONOUS

Specifies that your application continues after one grab is queued, rather than waiting for the grab to finish. Note that only one MdigGrab() function can be queued at a time. If one MdigGrab() is already queued, subsequent grabs will cause your application to wait until the current grab is finished. This allows the currently queued grab to start.

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize M_ASYNCHRONOUS_QUEUED

Specifies that your application continues after each grab is queued, rather than waiting for the grab to finish. Note that more than one MdigGrab() function can be queued. This causes the grabs to be truly asynchronous.

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize M_SYNCHRONOUS

Specifies that your application is synchronized with the end of a grab operation (that is, your application waits for the grab to finish before returning from the grab function).

 ‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize M_GRAB_SCALE +

Sets the vertical and horizontal scaling factor when grabbing data with MdigGrab(), MdigGrabContinuous(), or MdigProcess().

If the scale entered is not supported, the closest scaling factor will be used instead. If, however, the scale entered is larger than the maximum value supported, an error is generated. INQ

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
MIL system specific

By default, this control type is IIDC camera specific. The camera must support the ability to scale grabbed data for this control type to be available on the camera. This control type is also available on the board.

 ‡ e

Note that, for this control type to function on the Host, you must pass a simulated digitizer (allocated using MdigAlloc() with M_EMULATED).

 ‡ a

Note that this control type will subsample 2 adjacent pixels and 2 adjacent lines.

 ‡ t
Click to summarize M_DEFAULT

Same as 1.

 ‡ t
Click to summarize M_FILL_DESTINATION

Specifies that the scaling factor is calculated and set to fill the destination buffer.

(summarize)
‡ b e g h i j k l m n p q r u
MIL system specific

Note that this control value uses software scaling rather than hardware scaling.

 ‡ i u
Click to summarize 1

Specifies that no scaling is applied.

 ‡ a b c e g h j k l m n o p q r s t
Click to summarize Value = 1.0/n

Specifies to reduce the image size. To reduce the image size, the specified value must always be less than 1.0.

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
MIL system specific

The value of n can be any integer between 1 and 16.

 ‡ e f g h i j k l m n p q r u

The value of n can be any integer between 1.0 and 2.0.

 ‡ t

Note that data grabbed into a YUV buffer can only have a ½ scaling factor.

 ‡ c e f g h i l m n o s t u

The value of n can be any value (including fractional values) between 1 and 64.

 ‡ b
Click to summarize M_GRAB_SCALE_INTERPOLATION_MODE

Sets the interpolation mode used when performing a vertical and/or horizontal scaling. INQ

(summarize)
‡ a i
MIL system specific

Note that, for this control type to function on the Host, you must pass a simulated digitizer (allocated using MdigAlloc() with M_EMULATED).

 ‡ a
Click to summarize M_DEFAULT

Specifies the default value.

(summarize)
‡ a i
MIL system specific

Same as M_AUTOMATIC.

 ‡ i

Same as M_NEAREST_NEIGHBOR.

 ‡ a
Click to summarize M_AUTOMATIC

Specifies that the best interpolation mode is automatically selected, based on the input filter (set using M_INPUT_FILTER).

 ‡ a i
Click to summarize M_AVERAGE

Specifies to use an averaging interpolation. No saturation is performed. The scaling factors for the width and height of the image must be less than or equal to 1. This interpolation mode is software-based.

(summarize)
‡ i
Click to summarize M_BICUBIC

Specifies to use a bicubic interpolation. Saturation is performed according to the type of the destination buffer. This interpolation mode is software-based.

(summarize)
‡ a i
Click to summarize M_BILINEAR

Specifies to use a bilinear interpolation. No saturation is performed. This interpolation mode is software-based.

(summarize)
‡ a i
Click to summarize M_NEAREST_NEIGHBOR +

Specifies to use a nearest neighbor interpolation. No saturation is performed. By default, nearest neighbor interpolation is software-based. To use hardware-based nearest neighbor interpolation, use M_NEAREST_NEIGHBOR + M_FAST.

(summarize)
‡ a i
Click to summarize M_GRAB_SCALE_X +

Sets the horizontal scaling factor when grabbing data.

If the scale entered is not supported, the closest scaling factor will be used instead. If, however, the scale entered is larger than the maximum value supported, an error is generated. INQ

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
MIL system specific

By default, this control type is IIDC camera specific. The camera must support the ability to scale grabbed data for this control type to be available on the camera. This control type is also available on the board.

 ‡ e

Note that, for this control type to function on the Host, you must pass a simulated digitizer (allocated using MdigAlloc() with M_EMULATED).

 ‡ a
Click to summarize M_DEFAULT

Same as 1.

 ‡ t
Click to summarize M_FILL_DESTINATION

See the description of this setting in M_GRAB_SCALE.

 ‡ b e g h i j k l m n p q r u
Click to summarize 1

See the description of this setting in M_GRAB_SCALE.

 ‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize Value = 1.0/n

See the description of this setting in M_GRAB_SCALE.

 ‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize M_GRAB_SCALE_Y +

Sets the vertical scaling factor when grabbing data.

If the scale entered is not supported, the closest scaling factor will be used instead. If, however, the scale entered is larger than the maximum value supported, an error is generated. INQ

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
MIL system specific

By default, this control type is IIDC camera specific. The camera must support the ability to scale grabbed data for this control type to be available on the camera. This control type is also available on the board.

 ‡ e

When down-scaling the image width, a smaller image will result but its scan rate will be proportionally higher than if the image is not scaled.

 ‡ f t

Note that, for this control type to function on the Host, you must pass a simulated digitizer (allocated using MdigAlloc() with M_EMULATED).

 ‡ a
Click to summarize M_FILL_DESTINATION

See the description of this setting in M_GRAB_SCALE.

 ‡ b e g h i j k l m n p q r u
Click to summarize 1

See the description of this setting in M_GRAB_SCALE.

 ‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize Value = 1.0/n

See the description of this setting in M_GRAB_SCALE.

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
MIL system specific

Note that the restriction of using a ½ scaling factor when grabbing into a YUV buffer does not apply.

 ‡ c e f g h j k l m n o p q r s t

With Matrox Iris GT, this control type is limited to the following maximum vertical scaling factors:

Matrox smart camera

Maximum scaling factor (n)

Matrox Iris GT300C

12

Matrox Iris GT1200C

6

Matrox Iris GT1900C

5

Matrox Iris GT5000

13

Note that the limitation for Matrox Iris GT5000 is for monochrome cameras, while all other limitations are only for the color cameras.

 ‡ f
Click to summarize M_GRAB_START_MODE

Sets the type of field on which to grab. Note that this value applies only when dealing with interlaced cameras. INQ

(summarize)
‡ b g h i j l m n p r u
Click to summarize M_DEFAULT

Specifies the default value.

(summarize)
‡ b g h i j l m n p r u
MIL system specific

Same as M_FIELD_START_EVEN.

 ‡ n

Same as M_FIELD_START_ODD.

 ‡ b g h i j l m p r u
Click to summarize M_FIELD_START

Specifies that the grab starts on any field.

 ‡ b g h j l m n p r
Click to summarize M_FIELD_START_EVEN

Specifies that the grab starts on an even field.

 ‡ b g h i j l m n p r u
Click to summarize M_FIELD_START_ODD

Specifies that the grab starts on an odd field.

 ‡ b g h i j l m n p r u
Click to summarize M_GRAB_TIMEOUT

Sets the maximum time to wait for a frame before generating an error.

Note that when used with MdigProcess(), M_GRAB_TIMEOUT sets the time to wait before checking whether a grab occurred. If no grab occurred within this time period, a second time period of the same duration might elapse before an error is generated. INQ

(summarize)
‡ b c e f g h i j k l m n o p q r s t u
Click to summarize M_DEFAULT

Specifies the default amount of time to wait. Note that this is the same as M_INFINITE when performing a triggered grab.

(summarize)
‡ b c e f g h i j k l m n o p q r s t u
MIL system specific

The amount of time is either 5 secs or 5 times the frame period, which ever is higher.

 ‡ c j k l m n o p q r s

The amount of time is 60 times the frame period.

 ‡ b g h

The amount of time is 200 times the frame period.

 ‡ f t

The amount of time is 20 msecs.

 ‡ e

The amount of time is 5000 msecs.

 ‡ i u
Click to summarize M_INFINITE

Specifies to wait indefinitely. This is recommended only for triggered grabs.

(summarize)
‡ b c e f g h i j k l m n o p q r s t u
Click to summarize Value > 0

Specifies the time to wait, in msecs.

 ‡ b c e f g h i j k l m n o p q r s t u
Click to summarize M_HARDWARE_DEINTERLACING

Sets whether hardware deinterlacing is used when the video source is interlaced.

Note that this control type is only available when your DCF uses an interlaced video signal. INQ

(summarize)
‡ i u
Click to summarize M_DEFAULT

Same as M_DISABLE.

 ‡ i u
Click to summarize M_BOB_METHOD +

Specifies to use the BOB algorithm for hardware deinterlacing.

 ‡ i u
Click to summarize M_DISABLE

Specifies that hardware deinterlacing is disabled.

 ‡ i u
Click to summarize M_MADI_METHOD +

Specifies to use the MADI (motion adaptive deinterlacing) algorithm for hardware deinterlacing.

 ‡ i u
Click to summarize M_INPUT_FILTER +

Sets the low-pass filter applied to incoming data. INQ

(summarize)
‡ i l u
MIL system specific

Note that, if no combination constant is used with this control type, it will be applied to all acquisition paths (as if using the combination constant M_ALL_CHANNELS). For more information regarding the low-pass filters, refer to the Installation and hardware reference manual for your Matrox Imaging board.

 ‡ l
Click to summarize M_DEFAULT

Specifies the default value.

(summarize)
‡ i l u
MIL system specific

Same as M_BYPASS.

 ‡ i u

Same as M_LOW_PASS_1.

 ‡ l
Click to summarize M_AUTOMATIC

Specifies that the best hardware filter is automatically selected or the filter is bypassed when the video input is interlaced and hardware deinterlacing is disabled.

(summarize)
‡ i u
MIL system specific

To disable hardware deinterlacing, set M_HARDWARE_DEINTERLACING to M_DISABLE).

 ‡ i
Click to summarize M_BYPASS

Specifies to not use a filter.

 ‡ i l u
Click to summarize M_LOW_PASS_0

Specifies to use the first low-pass filter.

(summarize)
‡ i l u
MIL system specific

Uses a filter of 7.5 MHz.

 ‡ l

Uses a Kaiser filter.

 ‡ i u

Note that this value is not available when the video input is interlaced and hardware deinterlacing is disabled (that is, M_HARDWARE_DEINTERLACING is set to M_DISABLE).

 ‡ i
Click to summarize M_LOW_PASS_1

Specifies to use the second low-pass filter.

(summarize)
‡ i l u
MIL system specific

Uses a filter of 33 MHz.

 ‡ l

Uses a Gaussian filter.

 ‡ i u

Note that this value is not available when the video input is interlaced and hardware deinterlacing is disabled (that is, M_HARDWARE_DEINTERLACING is set to M_DISABLE).

 ‡ i
Click to summarize M_IRIS +

Sets the aperture for the iris of the mechanical lens.

Note that this control type is IIDC camera specific. The camera must support the IRIS IIDC standard feature for this control type to be supported. INQ

(summarize)
‡ e
Click to summarize M_DEFAULT

Specifies to use the camera's default value or, if supported, to enable the camera's auto control state for this feature (that is, the camera adjusts this value automatically).

 ‡ e
Click to summarize M_OFF

Specifies that the camera's feature is turned off.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. By default, when turned on and the camera supports it, the camera adjusts the feature's value automatically.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. aperature <= Value <= Max. aperature

Specifies a value between the minimum and maximum values supported by the camera. Use MdigInquire() to determine these values.

Note that, if using M_IRIS + M_MODE_CONTROL, you must first set M_IRIS to M_ON for the value specified to take effect. In addition, M_AUTO_EXPOSURE must be disabled; otherwise, the aperture for the iris of the mechanical lens is in its auto control state.

(summarize)
‡ e
Click to summarize M_LAST_GRAB_IN_TRUE_BUFFER

Sets whether a monoshot grab is performed when MdigHalt() is called after performing a continuous grab operation. This control type only has an effect if the target image buffer of the continuous grab is selected on a display. When the target buffer is selected on the display, the continuous grab will typically grab into a temporary internal buffer and only update the target image buffer when MdigHalt() is called. This control type establishes how to update to the target image buffer. INQ

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
MIL system specific

Note that, for this control type to function on the Host, you must pass a simulated digitizer (allocated using MdigAlloc() with M_EMULATED).

 ‡ a
Click to summarize M_DEFAULT

Same as M_ENABLE.

 ‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize M_DISABLE

Specifies that the last frame grabbed during the continuous grab operation is copied to the target image buffer, instead of performing one last grab. This setting might reduce the time it takes for the continuous grab to terminate once MdigHalt() is called (since copying a frame tends to take less time than grabbing a frame).

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize M_ENABLE

Specifies that a monoshot grab is performed. Note that after performing a monoshot grab in the target image buffer selected to the display, the display is updated.

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize M_LIGHTING_BRIGHT_FIELD

Sets the intensity of light to emit parallel to the optical axis, making the flat parts of an object stand out in stark contrast in the image.

Note that some consecutive bright field intensity level settings might produce the same result due to the fact that there are only 250 distinct adjustments (adjustments of 0.4% each). INQ

(summarize)
‡ f t
MIL system specific

This control type directly effects the duty cycle of the pulse train generated by the pulse width modulator (PWM) of your Matrox Iris GT; increasing the value of this control type increases the duty cycle. Note that this control type is only for controlling a LED lighting device (strobe light) or lighting controller. For more information, refer to your board's MIL Hardware-specific Notes.

 ‡ f

Increasing the value of this control type increases the intensity of the light transmitted by your lighting controller. Note that this control type is only for controlling the intensity of an LED (as a signal passed to a lighting controller). To control the timing of when the strobe light goes on or off, use M_GRAB_TRIGGER... + M_TIMER_STROBE or M_TIMER_TRIGGER_SOURCE with M_TIMER_STROBE. For more information, refer to your board's MIL Hardware-specific Notes.

 ‡ t
Click to summarize M_DEFAULT

Specifies the default value; the default value is 255.

 ‡ f t
Click to summarize 0 <= Value <= 255

Specifies the intensity of light to be emitted on the flat parts of the object.

 ‡ f t
Click to summarize M_LIGHTING_BRIGHT_FIELD_HIDRIVE

Sets whether to force the connected LED lighting device to emit the maximum intensity of light, for a specified period of time, immediately following timer 2's delay (set using M_TIMER_DELAY + M_TIMER2). This forces the connected LED lighting device to come quickly to its maximum light level and reduces the amount of time required to get to the specified light level (set using M_LIGHTING_BRIGHT_FIELD).

This control type controls a LED lighting device (strobe light) or lighting controller by temporarily maximizing the duty cycle of the pulse train generated by the pulse width modulator (PWM) of your Matrox Iris GT.

To specify the period of time, use M_LIGHTING_BRIGHT_FIELD_HIDRIVE_TIME.

For more information, refer to the Controlling your lighting device directly or indirectly section of Chapter 7: Matrox Iris GT. INQ

(summarize)
‡ f
Click to summarize M_DEFAULT

Same as M_DISABLE.

 ‡ f
Click to summarize M_DISABLE

Specifies not to force the LED lighting device to emit the maximum intensity of light.

 ‡ f
Click to summarize M_ENABLE

Specifies to force the LED lighting device to emit the maximum intensity of light.

 ‡ f
Click to summarize M_LIGHTING_BRIGHT_FIELD_HIDRIVE_TIME

Sets the amount of time to force the maximum intensity of light to be emitted by maximizing the duty cycle of the pulse train generated by the pulse width modulator (PWM) of your Matrox Iris GT.

This control type controls a LED lighting device (strobe light) or lighting controller. For more information, refer to the Controlling your lighting device directly or indirectly section of Chapter 7: Matrox Iris GT. INQ

(summarize)
‡ f
Click to summarize Value >= 0

Specifies the amount of time, in nsecs.

 ‡ f
Click to summarize M_LIGHTING_BRIGHT_FIELD_OFFSET

Sets whether to keep the connected LED lighting device marginally powered by 5% (always on) when M_LIGHTING_BRIGHT_FIELD_HIDRIVE is enabled. Keeping the LED lighting device marginally powered between grabs can reduce the amount of time it takes to bring the light back to the required level of intensity when future grabs are triggered.

This control type controls a LED lighting device (strobe light) or lighting controller. For more information, refer to the Controlling your lighting device directly or indirectly section of Chapter 7: Matrox Iris GT. INQ

(summarize)
‡ f
Click to summarize M_DEFAULT

Same as M_DISABLE.

 ‡ f
Click to summarize M_DISABLE

Specifies that the LED lighting device is not marginally powered. Its intensity is set to 0.

(summarize)
‡ f
Click to summarize M_ENABLE

Specifies that the LED lighting device is kept marginally powered. Its intensity is set to 2.

(summarize)
‡ f
Click to summarize M_LUT_ID

Sets whether to map the input data through the physical LUT of the specified digitizer and the values with which to initialize the LUT. MIL uses the data format (DCF) of the digitizer to determine whether a physical LUT is supported. If it is not, and you try to initialize it, an error is generated.

To learn how the digitizer's physical LUT is configured, refer to Mapping grabbed data through a LUT.

If the destination grab buffer's depth is larger than that of the digitizer's physical LUT, the destination grab buffer's least significant bits are set to zero when the data is grabbed. If the digitizer's physical LUT depth is greater than that of the destination grab buffer, the most-significant bits of the data (the non-zero values) are used when the data is grabbed. INQ

(summarize)
‡ a f k l m p q r t
MIL system specific

Note that if 14-, or 16-bit data is grabbed, the digitizer's physical LUT is not used.

 ‡ k l m p q

Note that if using a 10-tap video source, this value is not available.

 ‡ m

Note that, for this control type to function on the Host, you must pass a simulated digitizer (allocated using MdigAlloc() with M_EMULATED).

 ‡ a
Click to summarize M_DEFAULT

Specifies that the digitizer's physical LUT is not used.

 ‡ a f k l m p q r t
Click to summarize MIL LUT buffer identifier

Specifies the identifier of the LUT buffer (allocated with MbufAlloc...() with M_LUT) with which to initialize the digitizer's physical LUT.

To copy the data from a LUT buffer to the digitizer's physical LUT, the number of entries in the LUT buffer must match those of the digitizer's physical LUT. Note that if the digitizer's physical LUT cannot support the depth of the specified LUT buffer, an error will occur.

LUT buffer data is loaded into the digitizer's physical LUT as follows. In the case where a 1-band LUT buffer is loaded into a 3-band digitizer's physical LUT, the LUT buffer is copied into each component of the digitizer's physical LUT. When a 3-band LUT buffer is loaded into a 1-band digitizer's physical LUT, only the first band of the LUT buffer is copied into the digitizer's physical LUT. In all other cases, each band of the LUT buffer is copied into the associated band of the digitizer's physical LUT.

(summarize)
‡ a f k l m p q r t
MIL system specific

When grabbing 8-bit data, the digitizer's physical LUT has 256 entries.

 ‡ a f k m q

Matrox Iris GTR only supports an 8- or 10-bit LUT buffer.

 ‡ k t

When grabbing 10-bit data, the digitizer's physical LUT has 1024 entries.

When grabbing 12-bit data, the digitizer's physical LUT has 4096 entries.

 ‡ a k l m q

Matrox Radient eV-CXP only supports a 1-band LUT buffer with 1K entries. When grabbing into a 3-band buffer, the LUT is duplicated 3 times. When grabbing 10- or 12-bit data, use a LUT buffer with a data depth of 16-bits; the least-significant bits will be used as the LUT values. The grabbed data depth is specified in the DCF.

 ‡ k q
Click to summarize M_OPTICAL_FILTER +

Sets the optical filter of the camera lens.

Note that this control type is IIDC camera specific. The camera must support the OPTICAL_FILTER IIDC standard feature for this control type to be supported. INQ

(summarize)
‡ e
Click to summarize M_DEFAULT

Specifies to use the camera's default value or, if supported, to enable the camera's auto control state for this feature(that is, the camera adjusts this value automatically).

 ‡ e
Click to summarize M_OFF

Specifies that the camera's feature is turned off.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. By default, when turned on and the camera supports it, the camera adjusts the feature's value automatically.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. filter <= Value <= Max. filter

Specifies a value between the minimum and maximum values supported by the camera. Use MdigInquire() to determine these values.

Note that, if using M_OPTICAL_FILTER + M_MODE_CONTROL, you must first set M_OPTICAL_FILTER to M_ON for the value specified to take effect.

(summarize)
‡ e
Click to summarize M_PAN +

Sets the camera's rotation along its horizontal axis. To rotate the camera on its vertical axis, use M_TILT.

Note that this control type is IIDC camera specific. The camera must support the PAN IIDC standard feature for this control type to be supported. INQ

(summarize)
‡ e
Click to summarize M_DEFAULT

Specifies to use the camera's default value or, if supported, to enable the camera's auto control state for this feature(that is, the camera adjusts this value automatically).

 ‡ e
Click to summarize M_OFF

Specifies that the camera's feature is turned off.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. By default, when turned on and the camera supports it, the camera adjusts the feature's value automatically.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. pan <= Value <= Max. pan

Specifies a value between the minimum and maximum values supported by the camera. Use MdigInquire() to determine these values.

Note that, if using M_PAN + M_MODE_CONTROL, you must first set M_PAN to M_ON for the value specified to take effect.

(summarize)
‡ e
Click to summarize M_POWER_OVER_CABLE

Sets whether to enable PoCL (power over Camera Link) and PoCXP (power over CoaXPress). INQ

(summarize)
‡ j k m p r
MIL system specific

Note that the camera must be PoCL-capable. Once enabled, your PoCL-capable camera receives power over its Camera Link connection.

 ‡ j m p r

Note that the camera must be PoCXP-capable. Once enabled, your PoCXP-capable camera receives power over its CoaXPress connection.

 ‡ k
Click to summarize M_DEFAULT

Same as M_ON.

 ‡ j k m p r
Click to summarize M_OFF

Specifies to disable PoCL/PoCXP.

 ‡ j k m p r
Click to summarize M_ON

Specifies to enable PoCL/PoCXP.

 ‡ j k m p r
Click to summarize M_PROCESS_GRAB_MONITOR

Sets whether to create an internal grab monitoring thread when using MdigProcess() with either M_START or M_SEQUENCE. The internal grab monitoring thread will produce an error if there is no longer any grab activity (for example, when a camera is unplugged) after M_PROCESS_TIMEOUT expires.

A typical use of this control type would be to disable the grab monitoring thread before a camera is unplugged, so that an error is not generated. INQ

(summarize)
‡ b c e f g h i j k l m n o p q r s t u
Click to summarize M_DEFAULT

Same as M_ENABLE.

 ‡ b c e f g h i j k l m n o p q r s t u
Click to summarize M_DISABLE

Specifies not to create a grab monitoring thread.

 ‡ b c e f g h i j k l m n o p q r s t u
Click to summarize M_ENABLE

Specifies to create a grab monitoring thread.

 ‡ b c e f g h i j k l m n o p q r s t u
Click to summarize M_PROCESS_TIMEOUT

Sets the maximum amount of time to wait for MdigProcess() to complete the current grab (M_STOP) or all the queued grabs (M_STOP + M_WAIT), before generating an error. In an ideal situation, MdigProcess() would complete all the queued grabs before this timeout expires. If the timeout does expire either the specified time was too short, or a grab error occurred. INQ

(summarize)
‡ c e f g h i j k l m n o p q r s t u
Click to summarize M_DEFAULT

Same as M_INFINITE.

 ‡ c e f g h i j k l m n o p q r s t u
Click to summarize M_INFINITE

Specifies to wait indefinitely.

 ‡ c e f g h i j k l m n o p q r s t u
Click to summarize Value >= 0

Specifies the time to wait, in msecs.

 ‡ c e f g h i j k l m n o p q r s t u
Click to summarize M_SELECTED_FRAME_RATE

Sets the frame rate of the camera when grabbing in synchronous mode. Typically, this control type is used to reduce the frame rate from the default, which subsequently reduces the amount of bandwidth used by your camera. For more information, see the MIL Hardware-specific Notes for your Matrox Imaging board. INQ

(summarize)
‡ f t
Click to summarize M_DEFAULT

Specifies to use the camera's default frame rate, as specified by the DCF.

 ‡ f t
Click to summarize Value >= 0

Specifies the frame rate to be used by the camera, in frames/sec.

 ‡ f t
Click to summarize M_SHADING_CORRECTION

Sets whether to perform a gain and offset correction per pixel. This shading correction operation is performed by your digitizer when grabbing to a Host buffer, using the following equation:

(Grab Image+M_SHADING_CORRECTION_GAIN_ID) + M_SHADING_CORRECTION_OFFSET_ID

The same row of gain and offset values are applied to each row of the grabbed image.

To set the gain and provide an offset for shading correction, use M_SHADING_CORRECTION_OFFSET_ID and M_SHADING_CORRECTION_GAIN_ID, respectively. INQ

(summarize)
‡ p
Click to summarize M_DISABLE

Disables shading correction.

 ‡ p
Click to summarize M_ENABLE

Enables shading correction.

 ‡ p
Click to summarize M_SHADING_CORRECTION_GAIN_ID

Sets the buffer containing the gain values that your digitizer should use when it performs a shading correction.

To enable on-board shading correction and provide an offset, use M_SHADING_CORRECTION and M_SHADING_CORRECTION_OFFSET_ID, respectively. INQ

(summarize)
‡ p
Click to summarize 0

Specifies to not apply a gain when performing a shading correction.

 ‡ p
Click to summarize ShadingCorrectionGainID

Specifies the identifier of an M_IMAGE buffer containing the gain values. The buffer must be allocated as a single-band buffer. It can have a maximum X-size of 16 384 pixels. Its maximum Y-size is 1 row.

(summarize)
‡ p
Click to summarize M_SHADING_CORRECTION_OFFSET_ID

Sets the buffer containing the offset values, that your digitizer should use when it performs a shading correction.

To enable on-board shading correction and provide a gain, use M_SHADING_CORRECTION and M_SHADING_CORRECTION_GAIN_ID, respectively. INQ

(summarize)
‡ p
Click to summarize 0

Specifies to not apply an offset when performing a shading correction.

 ‡ p
Click to summarize ShadingCorrectionOffsetID

Specifies the identifier of an M_IMAGE buffer containing the offset values. The buffer must be allocated as a single-band buffer. It can have a maximum X-size of 16 384 pixels. Its maximum Y-size is 1 row.

(summarize)
‡ p
Click to summarize M_SHARPNESS +

Sets the sharpness of the image.

Note that this control type is IIDC camera specific. The camera must support the SHARPNESS IIDC standard feature for this control type to be supported. INQ

(summarize)
‡ e
Click to summarize M_DEFAULT

Specifies to use the camera's default value or, if supported, to enable the camera's auto control state for this feature (that is, the camera adjusts this value automatically).

 ‡ e
Click to summarize M_OFF

Specifies that the camera's feature is turned off.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. By default, when turned on and the camera supports it, the camera adjusts the feature's value automatically.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. sharpness <= Value <= Max. sharpness

Specifies a value between the minimum and maximum values supported by the camera. Use MdigInquire() to determine these values.

Note that, if using M_SHARPNESS + M_MODE_CONTROL, you must first set M_SHARPNESS to M_ON for the value specified to take effect.

(summarize)
‡ e
Click to summarize M_SOURCE_COMPENSATION

Sets whether software compensation is possible when cropping the input signal capture window.

With an IEEE 1394 IIDC-compliant device, it is possible to optimize grabs by taking advantage of hardware cropping with a format-7 capable camera. To do so, allocate the camera in format 7. When using the M_SOURCE_SIZE... and M_SOURCE_OFFSET... control types, the cropping will be done by the camera's hardware if it is supported (that is, if the specified offsets and sizes match the boundaries of one of the supported subregions). Under any other circumstance, cropping will be done by software.

This control type can be used to disable software compensation to make sure that hardware cropping is used. INQ

(summarize)
‡ e
Click to summarize M_DEFAULT

Same as M_ENABLE.

 ‡ e
Click to summarize M_DISABLE

Specifies to use hardware to crop the capture window, provided that you are using a format 7-capable camera. In this case, if the capture window specified does not match a tile size (X, Y), an error will be generated.

(summarize)
‡ e
Click to summarize M_ENABLE

Specifies to use software to crop the capture window, if not supported by hardware.

 ‡ e
Click to summarize M_SOURCE_OFFSET_X +

Sets the X-offset of the input signal capture window. INQ

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
MIL system specific

By default, this control type is IIDC camera specific. The camera must support the format 7 video mode and the IMAGE_POSITION IIDC standard feature for this control type to be available on the camera. This value is written to the Left field of the IMAGE_POSITION register. This control type is also available on the board.

 ‡ e

Note that, for this control type to function on the Host, you must pass a simulated digitizer (allocated using MdigAlloc() with M_EMULATED).

 ‡ a

Note that this value must be multiple of 32.

 ‡ t
Click to summarize Value

Specifies the X-offset, in pixels.

 ‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize M_SOURCE_OFFSET_Y +

Sets the Y-offset of the input signal capture window. INQ

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
MIL system specific

By default, this control type is IIDC camera specific. The camera must support the format 7 video mode and the IMAGE_POSITION IIDC standard feature for this control type to be available on the camera. This value is written to the Top field of the IMAGE_POSITION register. This control type is also available on the board.

 ‡ e

Note that, for this control type to function on the Host, you must pass a simulated digitizer (allocated using MdigAlloc() with M_EMULATED).

 ‡ a

Note that this value must be multiple of 2.

 ‡ t
Click to summarize Value

Specifies the Y-offset, in pixels.

 ‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize M_SOURCE_SIZE_X +

Sets the width of the input signal capture window.

Note that certain source sizes, offsets, and destination buffer sizes can affect a grab. Refer to MdigGrab() and MdigGrabContinuous() for more information. INQ

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
MIL system specific

On some GenICam SFNC-compliant cameras, you might not be able to set the width (that is, this information might be read-only).

 ‡ c o s

By default, this control type is IIDC camera specific. The camera must support the format 7 video mode and the IMAGE_SIZE IIDC standard feature for this control type to be available on the camera. This value is written to the Width field of the IMAGE_SIZE register. This control type is also available on the board.

 ‡ e

Note that, for this control type to function on the Host, you must pass a simulated digitizer (allocated using MdigAlloc() with M_EMULATED).

 ‡ a

Note that this value must be multiple of 32.

 ‡ t
Click to summarize Value

Specifies the width, in pixels.

 ‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize M_SOURCE_SIZE_Y +

Sets the height of the input signal capture window.

Note that certain source sizes, offsets, and destination buffer sizes can affect a grab. Refer to MdigGrab() and MdigGrabContinuous() for more information. INQ

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
MIL system specific

On some GenICam SFNC-compliant cameras, you might not be able to set the height (that is, this information might be read-only).

 ‡ c o s

By default, this control type is IIDC camera specific. The camera must support the format 7 video mode and the IMAGE_SIZE IIDC standard feature for this control type to be available on the camera. This value is written to the Height field of the IMAGE_SIZE register. This control type is also available on the board.

 ‡ e

Note that, for this control type to function on the Host, you must pass a simulated digitizer (allocated using MdigAlloc() with M_EMULATED).

 ‡ a

Note that this value must be multiple of 2.

 ‡ t
Click to summarize Value

Specifies the height, in pixels.

 ‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize M_TARGET_TEMPERATURE +

Sets the target temperature for the camera.

If the camera is in an auto control state, the camera attempts to maintain its own internal temperature to match the target temperature set by this control type. If the camera is in a manual control state, the target temperature is ignored and the camera makes no attempt to regulate its own temperature based on the value you provide. Instead, the default behavior of the camera is implemented.

Note that this control type is IIDC camera specific. The camera must support the TEMPERATURE IIDC standard feature for this control type to be supported. INQ

(summarize)
‡ e
Click to summarize M_DEFAULT

Specifies to use the camera's default value or, if supported, to enable the camera's auto control state for this feature (that is, the camera adjusts this value automatically).

 ‡ e
Click to summarize M_OFF

Specifies that the camera's feature is turned off.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. By default, when turned on and the camera supports it, the camera adjusts the feature's value automatically.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. temperature <= Value <= Max. temperature

Specifies a value between the minimum and maximum values supported by the camera. Use MdigInquire() to determine these values.

Note that, if using M_TARGET_TEMPERATURE + M_MODE_CONTROL, you must first set M_TARGET_TEMPERATURE to M_ON for the value specified to take effect.

(summarize)
‡ e
Click to summarize M_TILT +

Sets the camera's vertical angle. To rotate the camera on the horizontal axis, use M_PAN.

Note that this control type is IIDC camera specific. The camera must support the TILT IIDC standard feature for this control type to be supported. INQ

(summarize)
‡ e
Click to summarize M_DEFAULT

Specifies to use the camera's default value or, if supported, to enable the camera's auto control state for this feature(that is, the camera adjusts this value automatically).

 ‡ e
Click to summarize M_OFF

Specifies that the camera's feature is turned off.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. By default, when turned on and the camera supports it, the camera adjusts the feature's value automatically.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. tilt <= Value <= Max. tilt

Specifies a value between the minimum and maximum values supported by the camera. Use MdigInquire() to determine these values.

Note that, if using M_TILT + M_MODE_CONTROL, you must first set M_TILT to M_ON for the value specified to take effect.

(summarize)
‡ e
Click to summarize M_VIDEO_OUTPUT

Sets whether to route the current digitizer's video input signal to a specific analog video output. INQ

(summarize)
‡ h
Click to summarize M_NULL

Specifies that the current digitizer's video input signal is not routed to an analog video output.

 ‡ h
Click to summarize M_CHn

Specifies that the current digitizer's video input signal is routed to analog video output n (VID_OUT n), where n is a value from 0 to 3.

 ‡ h
Click to summarize M_WHITE_BALANCE

Sets whether to perform white balancing.

The white balance coefficients used for white balance correction are taken from an internal buffer, which is created and updated when you specify coefficients (using MdigControl() with M_BAYER_COEFFICIENTS_ID) or when you let the driver calculate them (using this control type with M_CALCULATE).

Note that to use this control type, M_BAYER_CONVERSION must be enabled. INQ

(summarize)
‡ c f k m o p q r s t
MIL system specific

Note that this control type is used to perform Bayer conversion if performed by the Host. To control the Bayer conversion on the camera, use MdigControlFeature(); refer to your camera's documentation for details regarding the features to set.

 ‡ c o s

Note that this control type is only available when using Matrox Iris GT300C, GT1200C, and GT1900C.

 ‡ f

Note that this control type is only available when using Matrox Iris GT300C, GT1300C, and GT2000C.

 ‡ t
Click to summarize M_CALCULATE

Calculates new white balance coefficients, overwriting old coefficients.

Calling MdigControl() with M_WHITE_BALANCE set to M_CALCULATE grabs an image. The image is assumed to be a uniform shade of gray that is not saturated. It is used to calculate the new white balance coefficients.

Use MdigInquire() with M_BAYER_COEFFICIENTS_ID to determine the calculated values.

(summarize)
‡ c f k m o p q r s t
MIL system specific

If the digitizer is configured to perform a software triggered grab, calling MdigControl() with this value will automatically trigger a grab. For more information, see the Correcting the white balance of your Bayer images subsection of the Using images acquired with a Bayer color filter section of Chapter 21: Data buffers.

 ‡ c f o s t
Click to summarize M_DISABLE

Specifies that white balancing is disabled.

 ‡ c f k m o p q r s t
Click to summarize M_ENABLE

Specifies that white balancing is enabled.

If you have not called MdigControl() with M_BAYER_COEFFICIENTS_ID or with M_WHITE_BALANCE set to M_CALCULATE before enabling white balancing, it will automatically calculate the white balance coefficients and then use those coefficients for subsequent images. Note that if M_WHITE_BALANCE is disabled and then re-enabled, the previously calculated coefficients are used.

(summarize)
‡ c f k m o p q r s t
Click to summarize M_WHITE_BALANCE_U +

Sets the white balance coefficient for the U chrominance (color) component of a YUV image.

Note that this control type is IIDC camera specific. The camera must support the WHITE_BALANCE IIDC standard feature for this control type to be supported. INQ

(summarize)
‡ e
Click to summarize M_DEFAULT

Specifies to use the camera's default value or, if supported, to enable the camera's auto control state for this feature(that is, the camera adjusts this value automatically).

 ‡ e
Click to summarize M_OFF

Specifies that the camera's feature is turned off.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. By default, when turned on and the camera supports it, the camera adjusts the feature's value automatically.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. U chrominance <= Value <= Max. U
chrominance

Specifies a value between the minimum and maximum values supported by the camera. Use MdigInquire() to determine these values.

Note that, if using M_WHITE_BALANCE_U + M_MODE_CONTROL, you must first set M_WHITE_BALANCE_U to M_ON for the value specified to take effect.

(summarize)
‡ e
Click to summarize M_WHITE_BALANCE_V +

Sets the white balance coefficient for the V chrominance (color) component of a YUV image.

Note that this control type is IIDC camera specific. The camera must support the WHITE_BALANCE IIDC standard feature for this control type to be supported. INQ

(summarize)
‡ e
Click to summarize M_DEFAULT

Specifies to use the camera's default value or, if supported, to enable the camera's auto control state for this feature(that is, the camera adjusts this value automatically).

 ‡ e
Click to summarize M_OFF

Specifies that the camera's feature is turned off.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. By default, when turned on and the camera supports it, the camera adjusts the feature's value automatically.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. V chrominance <= Value <= Max. V
chrominance

Specifies a value between the minimum and maximum values supported by the camera. Use MdigInquire() to determine these values.

Note that, if using M_WHITE_BALANCE_V + M_MODE_CONTROL, you must first set M_WHITE_BALANCE_V to M_ON for the value specified to take effect.

(summarize)
‡ e
Click to summarize M_ZOOM +

Sets the amount by which the camera's lens should enlarge the image.

Note that this control type is IIDC camera specific. The camera must support the ZOOM IIDC standard feature for this control type to be supported. INQ

(summarize)
‡ e
Click to summarize M_DEFAULT

Specifies to use the camera's default value or, if supported, to enable the camera's auto control state for this feature(that is, the camera adjusts this value automatically).

 ‡ e
Click to summarize M_OFF

Specifies that the camera's feature is turned off.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. By default, when turned on and the camera supports it, the camera adjusts the feature's value automatically.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. zoom <= Value <= Max. zoom

Specifies a value between the minimum and maximum values supported by the camera. Use MdigInquire() to determine these values.

Note that, if using M_ZOOM + M_MODE_CONTROL, you must first set M_ZOOM to M_ON for the value specified to take effect.

(summarize)
‡ e

1 If you are passing the value in a variable, don't enclose it in MIL_TEXT().

Combination value for M_FOCUS.

You can add the following value to the above-mentioned value to specify to wait for the camera to focus.

function map For specifying to wait for the camera to perform its focusing operation.
Click to summarize
Combination value		 Description MIL system-specific
tooltip (‡)
Click to summarize M_WAIT

Waits for the amount of time it takes the camera's lens motor moves the camera to a position that produces optimum focus. When used, this combination constant delays the callback function (hook-handler function) of MdigFocus() a predetermined amount of time.

(summarize)
‡ t
Combination value for M_NEAREST_NEIGHBOR (when ControlType=M_GRAB_SCALE_INTERPOLATION_MODE and ControlValue=M_NEAREST_NEIGHBOR).

You can add the following value to the above-mentioned value to set the speed and precision of the interpolation.

function map For specifying the speed and precision of the interpolation.
Click to summarize
Combination value		 Description MIL system-specific
tooltip (‡)
Click to summarize M_FAST

Uses a fast interpolation.

When dealing with M_GRAB_SCALE_INTERPOLATION_MODE set to M_NEAREST_NEIGHBOR + M_FAST, this value specifies that a fast interpolation is used. Fast interpolation is performed by hardware. Note that this combination is only available when M_INPUT_FILTER is set to M_BYPASS and hardware interpolation is available.

(summarize)
‡ i
Combination value for M_BLACK_REF; M_INPUT_FILTER; M_WHITE_REF.

You can add the following value to the above-mentioned values to specify which component(s) to affect.

function map For specifying the acquisition path
Click to summarize
Combination value		 Description MIL system-specific
tooltip (‡)
Click to summarize M_CHn

Applies the setting to acquisition path n.

When adding this combination constant to M_INPUT_FILTER, n can be a value from 0 to 3.

More than one acquisition path can be specified by adding them together (for example, M_CH0 + M_CH1).

(summarize)
‡ l
Combination values for M_OPEN (when ControlType=M_GC_FEATURE_BROWSER and ControlValue=M_OPEN).

You must add one of the following values to the above-mentioned value to set whether the Feature Browser should be synchronous or asynchronous.

[Matrox Solios ecl/xcl/ev-cl]

Note that these values are only supported on Matrox Solios eV-CL.

function map For specifying whether the Feature Browser should be synchronous or asynchronous
Click to summarize
Combination value		 Description MIL system-specific
tooltip (‡)
Click to summarize M_ASYNCHRONOUS

Specifies that this function returns immediately once the feature browser window opens.

 ‡ c k m o q s u
Click to summarize M_SYNCHRONOUS

Specifies that this function is blocked until the feature browser window closes.

This is the default value.

(summarize)
‡ c k m o q s u
Combination values for M_BOB_METHOD (when ControlType=M_HARDWARE_DEINTERLACING and ControlValue=M_BOB_METHOD); M_MADI_METHOD (when ControlType=M_HARDWARE_DEINTERLACING and ControlValue=M_MADI_METHOD).

You can add one or more of the following values to the above-mentioned values to specify whether anti-aliasing and/or dithering is enabled.

function map For specifying whether to enable anti-aliasing and/or dithering
Click to summarize
Combination value		 Description MIL system-specific
tooltip (‡)
Click to summarize M_ANTIALIASING

Specifies that anti-aliasing is enabled.

 ‡ i
Click to summarize M_DITHERING

Specifies that dithering is enabled.

 ‡ i

The following control types and control values set (if available) the reference levels used to digitize the analog signal received from a camera. These control types are specific to analog input devices. Depending on the type of digitizer and input signal, some reference types are not applicable. The smallest voltage increment supported by your board can differ such that consecutive reference-level settings might produce the same result. Note, some digitizers might take a few milliseconds before the reference level stabilizes.

[Matrox Solios eA/XA]

For more information about reference levels, refer to Adjusting the reference levels, in the Frame Grabbers chapter of your board's Installation and Hardware Guide. There are three ways to change the input signal's gain:

The first method is to set M_BLACK_REF and M_WHITE_REF to specific values (between M_MIN_LEVEL and M_MAX_LEVEL). This method is commonly used interactively (for example, in an application that allows you to change the settings until you are satisfied with the image quality). Note that the black reference level must always be less than the white level. Do not use M_GRAB_INPUT_GAIN if you are using this method since the gain will be adjusted automatically.

The second method is to set the black and the white reference levels in Volts. By adding M_VOLTAGE to the reference level, the optimum levels for the offset and gain controllers will be calculated automatically. This is more useful if you know the actual input signal voltages.

The third method is to set M_BLACK_REF, and then set M_GRAB_INPUT_GAIN to a value from M_MIN_LEVEL to M_MAX_LEVEL. This method corresponds more closely to the actual hardware that controls the reference levels. The hardware has an offset controller followed by a gain controller; the analog-to-digital converter cannot be programmed directly with the reference levels. Note that when using this method, you should not specify a white reference level because it would cause the gain to be altered.

To inquire the maximum and minimum levels for your camera, set the reference level to M_MIN_LEVEL or M_MAX_LEVEL, and then inquire the reference level (for example, set M_BLACK_REF to M_MIN_LEVEL, and then use MdigInquire() with M_BLACK_REF to return the minimum level for the black reference level).

[Matrox GigE Vision driver; Matrox GigE Vision driver (requires Update 25); Matrox IEEE 1394 IIDC driver; Matrox USB3 Vision driver (requires Update 19)]

Note that the following reference types are only available if they are supported by the camera. Refer to your camera's documentation for more details.

[Matrox Clarity UHD (requires Update 36); Matrox Orion HD]

Note that the following reference levels are only supported for standard definition (SD) analog inputs.

[All except Matrox GPU processing driver, Host system, Matrox Radient eCL, Matrox Radient eV-CL (requires Update 27), Matrox Radient eV-CLHS (requires Update 21), Matrox Radient eV-CXP, Matrox RadientPro-CL (requires Update 7), and Matrox Solios ecl/xcl/ev-cl]

Note that the following reference types are only available when grabbing from an analog input.

function map For the general reference settings
Click to summarize
ControlType		 Description MIL system-specific
tooltip (‡)
ControlValue
Click to summarize M_BLACK_OFFSET

Sets the offset to the black level of the image in hardware before the image reaches the digitization module of the sensor. INQ

(summarize)
‡ t
Click to summarize Min. black level <= Value <= Max. black level

Specifies the value of the black offset.

 ‡ t
Click to summarize M_BLACK_REF +

Sets the input signal's digitization black reference level. Note that when setting black and white reference levels, always set black reference levels first. INQ

(summarize)
‡ c f l n o s
MIL system specific

Note that this reference type is only available when your DCF uses either an analog RGB video signal or a monochrome via RGB video signal.

 ‡ n
Click to summarize M_DEFAULT

Specifies the default reference level for the specified digitizer data format.

 ‡ f l n
Click to summarize M_AUTOMATIC

Sets the reference level automatically.

 ‡ c o s
Click to summarize M_MAX_LEVEL

Specifies the maximum value.

 ‡ l n
Click to summarize M_MIN_LEVEL

Specifies the minimum value.

 ‡ l n
Click to summarize 0 <= Value <= 255

Specifies the camera's digitization black reference level.

Note that some consecutive black reference level settings might produce the same result due to the fact that there are only 98 distinct adjustments (adjustments of 10.23 mV each).

(summarize)
‡ f
Click to summarize M_MIN_LEVEL <= Value <= M_MAX_LEVEL

Specifies the black reference level. Note that the black reference level must be lower than the white reference level.

Note that some consecutive black reference level settings might produce the same result due to the fact that there are only 98 distinct adjustments (adjustments of 10.23 mV each).

To calculate the value to pass to M_BLACK_REF, use the following equation with the appropriate voltages for your particular board.

(summarize)
‡ l n
Click to summarize Min. black level <= Value <= Max. black level

Specifies the black reference level.

Note that to determine the camera-specific minimum and maximum black reference level, use MdigInquire() with M_BLACK_REF + M_MAX_VALUE or + M_MIN_VALUE, respectively.

(summarize)
‡ c o s
Click to summarize Min. voltage <= Value <= Max. voltage

Specifies the black reference level in Volts. Note that the black reference level must be lower than the white reference level.

Note that you can only specify the reference level in Volts if using M_BLACK_REF + M_VOLTAGE.

(summarize)
‡ l n
MIL system specific

The reference levels are from -1.0 V to +1.0 V.

 ‡ l

The reference levels are from 0.0 V to 1.0 V.

 ‡ n
Click to summarize M_BRIGHTNESS +

Sets the brightness value of the image by modifying the amount of black in the image.

Note that this control type is IIDC camera specific. The camera must support the BRIGHTNESS IIDC standard feature for this control type to be supported.

To control the brightness of other Matrox Imaging boards, use M_BRIGHTNESS_REF. INQ

(summarize)
‡ e
Click to summarize M_DEFAULT

Specifies to use the camera's default value or, if supported, or to enable the camera's auto control state for this feature (that is, the camera adjusts this value automatically).

 ‡ e
Click to summarize M_OFF

Specifies that the camera's feature is turned off.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. By default, when turned on and the camera supports it, the camera adjusts the feature's value automatically.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. brightness <= Value <= Max. brightness

Specifies the brightness reference level.

Note that, if using M_BRIGHTNESS + M_MODE_CONTROL, you must first set M_BRIGHTNESS to M_ON for the value specified to take effect.

(summarize)
‡ e
Click to summarize M_BRIGHTNESS_REF

Sets the brightness level for composite input signals. INQ

(summarize)
‡ b e g h i n u
MIL system specific

Note that this reference type is only available when using a DCF that uses a composite video signal.

 ‡ n
Click to summarize M_DEFAULT

Specifies the default reference level for the specified digitizer data format.

 ‡ e g h i n u
Click to summarize M_MAX_LEVEL

Specifies the maximum value.

 ‡ b g h i n u
Click to summarize M_MIN_LEVEL

Specifies the minimum value.

 ‡ b g h i n u
Click to summarize M_MIN_LEVEL <= Value <= M_MAX_LEVEL

Specifies the brightness reference level.

 ‡ b g h i n u
Click to summarize M_CONTRAST_REF

Sets the contrast level for composite input signals. INQ

(summarize)
‡ b g h i n u
MIL system specific

Note that this reference type is only available when using a DCF that uses a composite video signal.

 ‡ i n u
Click to summarize M_DEFAULT

Specifies the default reference level for the specified digitizer data format.

 ‡ b g h i n u
Click to summarize M_MAX_LEVEL

Specifies the maximum value.

 ‡ b g h i n u
Click to summarize M_MIN_LEVEL

Specifies the minimum value.

 ‡ b g h i n u
Click to summarize M_MIN_LEVEL <= Value <= M_MAX_LEVEL

Specifies the contrast reference level.

 ‡ b g h i n u
Click to summarize M_HUE +

Sets the color phase with which to adjust the image. For a more conventional technique of setting camera hue with analog digitizers, use M_HUE_REF.

Note that this control type is IIDC camera specific. The camera must support the HUE IIDC standard feature for this control type to be supported. INQ

(summarize)
‡ e
Click to summarize M_DEFAULT

Specifies to use the camera's default value or, if supported, to enable the camera's auto control state for this feature (that is, the camera adjusts this value automatically).

 ‡ e
Click to summarize M_OFF

Specifies that the camera's feature is turned off.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. By default, when turned on and the camera supports it, the camera adjusts the feature's value automatically.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. hue <= Value <= Max. hue

Specifies the color phase.

Note that, if using M_HUE + M_MODE_CONTROL, you must first set M_HUE to M_ON for the value specified to take effect.

(summarize)
‡ e
Click to summarize M_HUE_REF

Sets the hue level for composite input signals.

M_HUE_REF is available when grabbing color data (not monochrome data). INQ

(summarize)
‡ b e g h i n u
MIL system specific

Note that this reference type is only available when using a DCF that uses a composite video signal.

 ‡ i n u
Click to summarize M_DEFAULT

Specifies the default reference level for the specified digitizer data format.

 ‡ b e g h i n u
Click to summarize M_MAX_LEVEL

Specifies the maximum value.

 ‡ b g h i n u
Click to summarize M_MIN_LEVEL

Specifies the minimum value.

 ‡ b g h i n u
Click to summarize M_MIN_LEVEL <= Value <= M_MAX_LEVEL

Specifies the hue level.

 ‡ b g h i n u
Click to summarize M_SATURATION +

Sets the color saturation value for the image. For a more conventional technique of setting the saturation values with analog digitizers, use M_SATURATION_REF.

Note that this control type is IIDC camera specific. The camera must support the SATURATION IIDC standard feature for this control type to be supported. INQ

(summarize)
‡ e
Click to summarize M_DEFAULT

Specifies to use the camera's default value or, if supported, to enable the camera's auto control state for this feature (that is, the camera adjusts this value automatically).

 ‡ e
Click to summarize M_OFF

Specifies that the camera's feature is turned off.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. By default, when turned on and the camera supports it, the camera adjusts the feature's value automatically.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. saturation <= Value <= Max. saturation

Specifies the color saturation value.

Note that, if using M_SATURATION + M_MODE_CONTROL, you must first set M_SATURATION to M_ON for the value specified to take effect.

(summarize)
‡ e
Click to summarize M_SATURATION_REF

Sets the saturation level for composite input signals.

M_SATURATION_REF is available when grabbing color data (not monochrome data). INQ

(summarize)
‡ b e g h i n u
MIL system specific

Note that this reference type is only available when using a DCF that uses a composite video signal.

 ‡ i n u
Click to summarize M_DEFAULT

Specifies the default reference level for the specified digitizer data format.

 ‡ b e g h i n u
Click to summarize M_MAX_LEVEL

Specifies the maximum value.

 ‡ b e g h i n u
Click to summarize M_MIN_LEVEL

Specifies the minimum value.

 ‡ b e g h i n u
Click to summarize M_MIN_LEVEL <= Value <= M_MAX_LEVEL

Specifies the saturation level.

 ‡ b e g h i n u
Click to summarize M_WHITE_REF +

Sets the input signal's digitization white reference level. Note that when setting black and white reference levels, always set black reference levels first. INQ

(summarize)
‡ c f l n o s
MIL system specific

Note that this reference type is only available when your DCF uses either an analog RGB video signal or a monochrome via RGB video signal.

 ‡ n
Click to summarize M_DEFAULT

Specifies the default reference level for the specified digitizer data format.

 ‡ c f l n o s
Click to summarize M_AUTOMATIC

Sets the reference level automatically.

 ‡ c o s
Click to summarize M_MAX_LEVEL

Specifies the maximum value.

 ‡ f l n
Click to summarize M_MIN_LEVEL

Specifies the minimum value.

 ‡ f l n
Click to summarize M_MIN_LEVEL <= Value <= M_MAX_LEVEL

Specifies the white reference level. Note that the white reference level must be higher than the black reference level.

(summarize)
‡ f l n
MIL system specific

Note that some consecutive white reference level settings might produce the same result due to the fact that there are only 16 distinct adjustments (adjustments of 10.23 mV each).

 ‡ f

To calculate the value to pass to M_WHITE_REF, use the following equation with the appropriate voltages for your particular board.

 ‡ l n
Click to summarize Min. voltage <= Value <= Max. voltage

Specifies the white reference level in Volts. Note that the white reference level must be higher than the black reference level.

Note that you can only specify the reference level in Volts if using M_WHITE_REF + M_VOLTAGE.

(summarize)
‡ l n
MIL system specific

The reference levels are from -1.0V to +1.0V.

 ‡ l

The reference levels are from 0.0V to 1.0V.

 ‡ n
Click to summarize Min. white level <= Value <= Max. white level

Specifies the white reference level.

Note that to determine the camera-specific minimum and maximum white reference level, use MdigInquire() with M_WHITE_REF + M_MAX_VALUE or + M_MIN_VALUE, respectively.

(summarize)
‡ c o s
Combination values for M_BLACK_REF; M_WHITE_REF.

You can add one of the following values to the above-mentioned values to set the reference level of a specific acquisition path when using RGB or multi-tap input.

function map For controlling the reference level of a specific acquisition path
Click to summarize
Combination value		 Description MIL system-specific
tooltip (‡)
Click to summarize M_ALL_REF

Sets the reference level on all available acquisition paths.

(summarize)
‡ c l n o s
MIL system specific

Note that this reference type is only available when using a DCF that uses an RGB video signal.

 ‡ n
Click to summarize M_CH0_REF

Sets the reference level on acquisition path 0.

(summarize)
‡ c l n o s
MIL system specific

Note that this reference type is only available when using a DCF that uses an RGB video signal.

 ‡ n
Click to summarize M_CH1_REF

Sets the reference level on acquisition path 1.

(summarize)
‡ c l n o s
MIL system specific

Note that this reference type is only available when using a DCF that uses an RGB video signal.

 ‡ n
Click to summarize M_CH2_REF

Sets the reference level on acquisition path 2.

(summarize)
‡ c l n o s
MIL system specific

Note that this reference type is only available when using a DCF that uses an RGB video signal.

 ‡ n
Click to summarize M_CH3_REF

Sets the reference level on acquisition path 3.

 ‡ l
Combination value for M_BLACK_REF; M_WHITE_REF.

You can add the following value to the above-mentioned values to specify the reference level in Volts.

function map For specifying the reference level in Volts
Click to summarize
Combination value		 Description MIL system-specific
tooltip (‡)
Click to summarize M_VOLTAGE

Sets the reference level in Volts.

 ‡ l n

The following control types allow you to control the input gain.

function map For controlling the input gain
Click to summarize
ControlType		 Description MIL system-specific
tooltip (‡)
ControlValue
Click to summarize M_GAIN +

Sets the input gain with which to amplify the input signal. Note that gain affects the acquisition path before the data is digitized, and is applied to all the color bands of the image. INQ

(summarize)
‡ c e o s t
MIL system specific

For a more conventional technique of setting the gain, use MdigControl() with M_GRAB_INPUT_GAIN.

Note that this control type is IIDC camera specific. The camera must support the GAIN IIDC standard feature for this control type to be supported.

 ‡ e
Click to summarize M_DEFAULT

Specifies to use the camera's default value or, if supported, to enable the camera's auto control state for this feature (that is, the camera adjusts this value automatically).

 ‡ c e o s t
Click to summarize M_OFF

Specifies that the camera's feature is turned off.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. By default, when turned on and the camera supports it, the camera adjusts the feature's value automatically.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. gain <= Value <= Max. gain

Specifies a value between the minimum and maximum values supported by the camera. Use MdigInquire() to determine these values.

(summarize)
‡ c e o s t
MIL system specific

Note that, if using M_GAIN + M_MODE_CONTROL, you must first set M_GAIN to M_ON for the value specified to take effect. In addition, M_AUTO_EXPOSURE must be disabled; otherwise, the input gain with which to amplify the input signal is in its auto control state.

 ‡ e
Click to summarize M_GRAB_AUTOMATIC_INPUT_GAIN +

Sets whether the input gain should be automatically set. INQ

(summarize)
‡ b c g h i n o s u
MIL system specific

If enabled, the on-board decoder automatically sets the input gain.

 ‡ b g h n

By default, this setting is applied to both Y (luminance) and C (chrominance) components (for composite, after separation). To apply this setting to a specific component, see combination values below.

 ‡ g h

To manually set your input gain, use M_GRAB_INPUT_GAIN.

 ‡ b g h n

This value is supported only if using a DCF that supports grabbing from the RGB or composite analog path.

 ‡ n

This value is supported only when grabbing an analog input signal.

 ‡ i u
Click to summarize M_DEFAULT

Same as M_ENABLE.

 ‡ b c g h i n o s u
Click to summarize M_DISABLE

Specifies that the input gain is not automatically set.

 ‡ b c g h i n o s u
Click to summarize M_ENABLE

Specifies that the input gain is automatically set.

 ‡ b c g h i n o s u
Click to summarize M_GRAB_INPUT_GAIN +

Sets the input gain with which to amplify the input signal. This allows you to optimize the amplitude of the analog video input signal so that the full dynamic range of the component digitizing the video is used. INQ

(summarize)
‡ b e f g h i l n u
MIL system specific

By default, this setting is applied to all acquisition paths used by the digitizer or to both Y (luminance) and C (chrominance) components (for composite, after separation). To apply this setting to a specific acquisition path or component, see combination values below.

 ‡ g l n

This control type affects the black reference, set using M_BLACK_REF. Note that you can also change this value by modifying the DCF.

 ‡ l

This control type cannot be changed if M_GRAB_TRIGGER_STATE is set to M_ENABLE.

 ‡ f

This control type is a more conventional technique; to use a more camera-specific technique to set the camera's input gain, use M_GAIN.

 ‡ e

To automatically set your input gain, use M_GRAB_AUTOMATIC_INPUT_GAIN.

To manually set your input gain, M_GRAB_AUTOMATIC_INPUT_GAIN must first be disabled.

 ‡ b g h n

Note that this control type is IIDC camera specific. The camera must support the GAIN IIDC standard feature for this control type to be supported. The IIDC standard feature's input gain factor maps to a range from 0 to 100, while the MIL input gain factor maps to a range from 0 to 255.

 ‡ e

Note that this control type is only available when your DCF uses an analog input signal.

 ‡ i n u
Click to summarize M_DEFAULT

Specifies the default input gain factor.

(summarize)
‡ b e f g h i l u
MIL system specific

The exact gain level varies depending on the board.

 ‡ b g

Same as the input gain factor specified by the DCF.

 ‡ f g h l

Specifies the camera's default input gain factor (if supported).

 ‡ e

When dealing with a composite or RGB analog input signal, the input gain factor is 128.

 ‡ i u
Click to summarize M_GAIN0

Specifies the first input gain supported.

(summarize)
‡ i l n
MIL system specific

Sets a gain of 1. This should be used when the input voltage is 0.0 - 1.0 Vpp.

 ‡ l

Sets a gain of 0.5. Note that this control value is only available when your DCF uses an analog input signal.

 ‡ i

Sets a gain of 1. Note that this is only available when using a DCF that uses an RGB video signal.

 ‡ n
Click to summarize M_GAIN1

Specifies the second input gain supported.

(summarize)
‡ i l n
MIL system specific

Sets a gain of 2. Note that this control value is only available when your DCF uses an analog input signal.

 ‡ i

Sets a gain of 2. This should be used when the input voltage is 0.0 - 0.5 Vpp.

 ‡ l

Sets a gain of 2. Note that this is only available when using a DCF that uses an RGB video signal.

 ‡ n
Click to summarize M_GAIN2

Specifies the third input gain supported.

(summarize)
‡ i l
MIL system specific

Sets a gain of 2.8. Note that this control value is only available when your DCF uses an analog input signal.

 ‡ i

Sets a gain of 3. This should be used when the input voltage is 0.0 - 0.333 Vpp.

 ‡ l
Click to summarize M_GAIN3

Specifies the fourth input gain supported.

(summarize)
‡ i l
MIL system specific

Sets a gain of 4.0. Note that this control value is only available when your DCF uses an analog input signal.

 ‡ i

Sets a gain of 3.99. This should be used when the input voltage is 0.0 - 0.25 Vpp.

 ‡ i
Click to summarize M_MAX_LEVEL

Specifies the maximum input gain factor.

 ‡ b e f g h i l n u
Click to summarize M_MIN_LEVEL

Specifies the minimum input gain factor.

 ‡ b e f g h i l n u
Click to summarize 0 <= Value <= 255

Specifies an integer value which is used to determine the input gain factor. With this range, 0 is mapped to the minimum gain factor supported by the camera, while 255 is mapped to the maximum gain factor supported by the camera.

(summarize)
‡ b e f g h i l n u
MIL system specific

This value is supported only when using a DCF that uses a composite or RGB video signal.

 ‡ n

This value is supported only when using a DCF that uses either a composite or RGB analog video signal.

 ‡ i u

The following is a list of optimal ranges for the input gain factor based on your Matrox Iris GT camera type.

On Matrox Iris GT1200, the input gain factor must be from 64 to 255.

On Matrox Iris GT1900, the input gain factor must be from 20 to 255.

On Matrox Iris GT300, the input gain factor can be from 0 to 255.

On Matrox Iris GT5000, the input gain factor should be set to M_DEFAULT.

 ‡ f
Combination values for M_GRAB_INPUT_GAIN.

You can add one of the following values to the above-mentioned value to specify which component(s) to affect.

function map For specifying the acquisition path for the input gain
Click to summarize
Combination value		 Description MIL system-specific
tooltip (‡)
Click to summarize M_ALL_CHANNELS

Applies the setting to all available acquisition paths used by the specified digitizer.

 ‡ l
Click to summarize M_CHn

Applies the setting to acquisition path n, where n is a value from 0 to 2.

More than one acquisition path can be specified by adding them together (for example, M_CH0 + M_CH1).

(summarize)
‡ l n
MIL system specific

Note that, this combination constant is available only when using the analog path and a DCF that supports grabbing RGB.

 ‡ n
Combination values for M_GRAB_AUTOMATIC_INPUT_GAIN; M_GRAB_INPUT_GAIN.

You can add one of the following values to the above-mentioned values to specify the specific video signal component to apply the input-gain setting.

Note that these combination constants are only available if your DCF uses a composite color input signal.

function map For specifying the specific video signal component to apply the input-gain setting
Click to summarize
Combination value		 Description MIL system-specific
tooltip (‡)
Click to summarize M_CHROMINANCE

Applies the input-gain setting to the chrominance component of the video signal. The gain setting is applied only after the composite signal is separated into its components.

(summarize)
‡ g h i n
Click to summarize M_LUMINANCE

Applies the input-gain setting to the luminance component of the video signal. The gain setting is applied only after the composite signal is separated into its components.

(summarize)
‡ g h i n

The following control types allow you to set the mode and the purpose of your Matrox imaging board's I/O signals (such as, auxiliary, Camera Link control, and transport layer trigger signal). Once the format, routing, and mode are determined for an I/O signal, you can further control the I/O signal using the control types described in the following tables: For setting the state of specified user-bits in a static-user-output register, For controlling the settings of a timer, For controlling the camera's exposure, and For controlling the settings to grab using a trigger.

Note that for all MIL supported hardware that have I/O signals, but are not supported with the constants below, see MsysControl().

Each Matrox imaging board and MIL driver has its own list of limitations regarding the signals you can control with this function. While general limitations are listed in the table below, for a complete list of the available signals and their limitations, see the Connectors and signal names section of the MIL Hardware-specific Notes chapter for your Matrox imaging board or MIL driver.

function map For routing I/O signals and setting their mode
Click to summarize
ControlType		 Description MIL system-specific
tooltip (‡)
ControlValue
Click to summarize M_IO_FORMAT +

Sets whether to enable a specific transmitter/receiver for an I/O signal, on systems whose transmitters/receivers are enabled through software and where the option of two or more signal formats are possible. Note that some signals cannot be affected individually. In this case, if you affect any one of the signals in the group, they will all be affected. For more information, refer to the Technical information appendix in the Installation and Hardware Reference manual for your Matrox imaging board. INQ


You must specify a combination value from the following table:
(summarize)
‡ c l o s
Click to summarize M_DEFAULT

Same as the transmitter/receiver for the I/O signal specified by the DCF.

 ‡ l
Click to summarize M_DISABLE

Specifies that the specified I/O signal is not available for use.

 ‡ c o s
Click to summarize M_LVDS

Specifies to use the LVDS transmitter/receiver for the I/O signal.

(summarize)
‡ c l o s
MIL system specific

Uses the LVDS signal on external auxiliary I/O connector 0 (HB-44), instead of the TTL signal.

 ‡ l
Click to summarize M_OPEN_DRAIN

Specifies to use the open collector (open drain) transmitter/receiver for the specified I/O signal.

 ‡ c o s
Click to summarize M_OPTO

Specifies to use the opto-coupled transmitter/receiver for the specified I/O signal.

 ‡ c o s
Click to summarize M_RS422

Specifies to use the RS-422 transmitter/receiver for the specified I/O signal.

 ‡ c o s
Click to summarize M_TRI_STATE

Specifies to use the tri-state transmitter/receiver for the specified I/O signal.

 ‡ c o s
Click to summarize M_TTL

Specifies to use the TTL transmitter/receiver for the specified I/O signal.

(summarize)
‡ c l o s
MIL system specific

Uses the TTL signal on external auxiliary I/O connector 0 (HB-44), instead of the LVDS signal.

 ‡ l
Click to summarize M_IO_INTERRUPT_ACTIVATION +

Sets the signal transition upon which to generate an interrupt, if interrupt generation has been enabled for the specified I/O signal. Use M_IO_INTERRUPT_STATE to enable interrupt generation.

Note that this only applies to input signals.

Note that this control type only has an effect when M_IO_INTERRUPT_STATE is enabled. INQ


You must specify a combination value from the following table:
(summarize)
‡ c l o s
Click to summarize M_DEFAULT

Same as the signal transition specified by the DCF. If this value is not specified in the DCF, the default is the same as M_EDGE_RISING.

(summarize)
‡ c l o s
Click to summarize M_ANY_EDGE

Specifies to generate an interrupt upon both a low-to-high and a high-to-low signal transition.

 ‡ c l o s
Click to summarize M_EDGE_FALLING

Specifies that an interrupt will be generated upon a high-to-low signal transition.

 ‡ c l o s
Click to summarize M_EDGE_RISING

Specifies that an interrupt will be generated upon a low-to-high signal transition.

 ‡ c l o s
Click to summarize M_IO_INTERRUPT_STATE +

Sets whether to generate an interrupt upon the specified transition of the I/O signal. Use M_IO_INTERRUPT_ACTIVATION to specify the transition. Note that this only applies to input signals, or I/O signals set to input (using M_IO_MODE). INQ


You must specify a combination value from the following table:
(summarize)
‡ c l o s
Click to summarize M_DEFAULT

Same as the transition specified by the DCF. If this value is not specified in the DCF, the default is the same as M_DISABLE.

(summarize)
‡ c l o s
Click to summarize M_DISABLE

Specifies not to generate an interrupt.

 ‡ c l o s
Click to summarize M_ENABLE

Specifies to generate an interrupt.

 ‡ c l o s
Click to summarize M_IO_MODE +

Sets the mode of the specified I/O signal. Note that you can only change the mode of a bidirectional (I/O) signal. INQ


You must specify a combination value from the following table:
(summarize)
‡ c k l m o p q r s
Click to summarize M_DEFAULT

Same as the mode specified by the DCF, or disabled when dealing with a tri-state I/O signal.

 ‡ l o p q r
Click to summarize M_INPUT

Specifies that the signal is for input.

 ‡ c k l m o p q r s
Click to summarize M_OUTPUT

Specifies that the signal is for output.

 ‡ c k l m o p q r s
Click to summarize M_IO_SOURCE +

Sets the type of signal to route to an output signal, or a bidirectional signal set to output mode. INQ


You must specify a combination value from the following table:
(summarize)
‡ c j k l m o p q r s
Click to summarize M_DEFAULT

Same as the type of signal specified by the DCF.

If this value is not specified in the DCF and dealing with an auxiliary signal, the default is M_USER_BITn, where n is the number of the user-bit that can drive the output signal.

For the number of the user-bit that can drive the specified output signal, see the Connectors and signal names section of the MIL Hardware-specific Notes chapter for your Matrox imaging board or MIL driver.

(summarize)
‡ c j k l m o p q r s
MIL system specific

If this value is not specified in the DCF and dealing with a Camera Link camera control output signal, the default is M_USER_BIT_CC_IOn, where n is either 0 or 1.

 ‡ j m p r
Click to summarize M_AUX_IOn

Specifies to reroute auxiliary input signal n to the output signal, where n is the number of the auxiliary input signal. Note that the specified auxiliary signal can also be a bidirectional signal set to input (using M_IO_MODE set to M_INPUT).

You can typically reroute an auxiliary input signal to an output signal that is hard-wired to the camera (for example, a Camera Control (CC) output signal or a transport layer (TL) trigger signal). Note that you cannot reroute auxiliary input signals to auxiliary output signals.

(summarize)
‡ c j k l m o p q r s
MIL system specific

For a list of the available auxiliary I/O signals, see the Connectors and signal names section of the MIL Hardware-specific Notes chapter for your Matrox imaging board or MIL driver.

 ‡ j k m p q r

With a GenICam SFNC-compliant camera, n is a number from 0 to 31.

 ‡ c o s

The only output signal on which an auxiliary input signal can be routed to is a TL signal (using M_IO_SOURCE + M_TL_TRIGGER).

 ‡ k q

The only output signal on which an auxiliary input signal can be routed to is a CC signal (using M_IO_SOURCE + M_CC_IOn). For more information, refer to the Connectors and signal names section of the MIL Hardware-specific Notes chapter for your Matrox hardware.

 ‡ j m p r
Click to summarize M_DISABLE

Specifies to not route any signal to the specified signal.

 ‡ c j k l m o p q r s
Click to summarize M_HSYNC

Specifies to route the horizontal synchronization signal of the camera.

Note that instead of using an auxiliary signal to output the HSYNC signal, you can use the dedicated HSYNC output signal; refer to the Installation and hardware reference manual for the list of available dedicated signals.

(summarize)
‡ l m
Click to summarize M_PIXCLK

Specifies to route the pixel clock signal of the camera.

Note that instead of using an auxiliary signal to output the pixel clock signal, you can use the dedicated pixel clock output signal; refer to the Installation and hardware reference manual for the list of available dedicated signals.

(summarize)
‡ l m
Click to summarize M_TIMERn

Specifies to route the output of timer n, where n is the number of timers available.

(summarize)
‡ c j k l m o p q r s
MIL system specific

In this case, n can be a value from 1 to 4.

 ‡ j k m p q r

With a GenICam SFNC-compliant camera, n can be a value from 0 to 8.

 ‡ c o s
Click to summarize M_TL_TRIGGER

Specifies to use the transport layer trigger signal (input mode only). The transport layer trigger signal is an embedded bidirectional signal from the physical transport layer connection of your camera. Typically, the TL Trigger is reserved for trigger information and is sent with other control and data signals along the same cable.

(summarize)
‡ k q
Click to summarize M_USER_BIT_CC_IOn

Specifies to route the state of bit n of the camera control static-user-output register, where n is a value from 0 to 1. Note that you can route a bit from the camera control static-user-output register to any of the 4 Camera Link camera control output signals (such as routing bit 0 to the M_CC_IO1 signal).

Note that there is one camera control static-user-output register per acquisition path.

(summarize)
‡ j m p r
Click to summarize M_USER_BIT_TL_TRIGGER

Specifies to route the state of the bit of the TL trigger static-user-output register.

 ‡ k q
Click to summarize M_USER_BITn

Specifies to route the state of bit n of the main static-user-output register, where n is the bit number.

Note that there is one main static-user-output register per acquisition path. However, if one of its bits can be routed to a signal that is shared across acquisition paths, changing that bit in one register affects the register of all the other acquisition paths.

For the number of the user-bit that can drive the specified output signal, see the Connectors and signal names section of the MIL Hardware-specific Notes chapter for your Matrox imaging board or MIL driver.

(summarize)
‡ c j k l m o p q r s
MIL system specific

With a GenICam SFNC-compliant camera, n is a number from 0 to 31.

 ‡ c o s
Click to summarize M_VSYNC

Specifies to route the vertical synchronization signal of the camera.

Note that instead of using an auxiliary signal to output the VSYNC signal, you can use the dedicated VSYNC output signal; refer to the Installation and hardware reference manual for the list of available dedicated signals.

(summarize)
‡ l m
Combination values for M_IO_FORMAT; M_IO_INTERRUPT_ACTIVATION; M_IO_INTERRUPT_STATE; M_IO_MODE; M_IO_SOURCE.

You must add one of the following values to the above-mentioned values to set the type and number of the I/O signal to affect.

function map For specifying the type and number of the I/O signal to affect
Click to summarize
Combination value		 Description MIL system-specific
tooltip (‡)
Click to summarize M_AUX_IOn

Specifies to affect auxiliary signal n, where n is the signal number.

Note that, when using this value with M_IO_SOURCE, the auxiliary signal n must be an output signal, or an I/O signal set to output (using M_IO_MODE).

(summarize)
‡ c j k l m o p q r s
MIL system specific

For a list of the available auxiliary I/O signals, see the Connectors and signal names section of the MIL Hardware-specific Notes chapter for your Matrox imaging board or MIL driver.

 ‡ j k l m p q r

With a GenICam SFNC-compliant camera, n is a number from 0 to 31.

 ‡ c o s
Click to summarize M_CC_IOn

Specifies to affect Camera Link camera control signal n, where n is a value from 1 to 4.

Note that this value is only available when using M_IO_SOURCE.

For a list of the available camera control signals, see the Connectors and signal names section of the MIL Hardware-specific Notes chapter for your Matrox imaging board or MIL driver.

(summarize)
‡ j m p r
Click to summarize M_TL_TRIGGER

Specifies to affect the transport layer trigger signal. The transport layer trigger signal is an embedded bidirectional signal from the physical transport layer connection of your camera. Typically, the TL trigger signal is reserved for trigger information and is sent with other control and data signals along the same cable.

Note that this value is not available when using M_IO_FORMAT.

(summarize)
‡ k q

The following control types and control values allow you to set the bits in a static-user-output register. You can route the bits to output signals or I/O signals set to output; to do so, use M_IO_SOURCE with M_USER_BIT...). To establish which user-bits can be routed to a specific signal, see the connectors and signal names section of the MIL Hardware-specific Notes chapter for your Matrox imaging board.

Note that for all MIL supported hardware that have I/O signals, but are not supported with the constants below, see MsysControl().

function map For setting the state of specified user-bits in a static-user-output register
Click to summarize
ControlType		 Description MIL system-specific
tooltip (‡)
ControlValue
Click to summarize M_USER_BIT_STATE +

Sets the state of the specified bit of a static-user-output register. INQ


You must specify a combination value from the following table:
(summarize)
‡ c j k l m o p q r s
Click to summarize M_OFF

Specifies that the specified bit is set to off.

 ‡ c j k l m o p q r s
Click to summarize M_ON

Specifies that the specified bit is set to on.

 ‡ c j k l m o p q r s
Click to summarize M_USER_BIT_STATE_ALL +

Sets the state of all the bits of the main static-user-output register or another specified static-user-output register. INQ

(summarize)
‡ c j k l m o p q r s
MIL system specific

To affect a static-user-output register other than the main one, use one of the combination values documented below.

 ‡ k q
Click to summarize Value

Specifies a bit-encoded value that establishes the value of all the bits of the specified static-user-output register. It is recommended to specify the value in hexadecimal notation (0x), so that it is more legible to what you are setting each bit of the register.

(summarize)
‡ c j k l m o p q r s
Combination values for M_USER_BIT_STATE.

You must add one of the following values to the above-mentioned value to specify the static-user-output register and bit to affect.

function map For specifying the bit in a static-user-output register to affect
Click to summarize
Combination value		 Description MIL system-specific
tooltip (‡)
Click to summarize M_USER_BIT_CC_IOn

Specifies which bit of the camera control static-user-output register to affect, where n is a value from 0 to 1. In this case, n represents the bit in the camera control static-user-output register.

Note that there is one camera control static-user-output register per acquisition path.

(summarize)
‡ j m p r
Click to summarize M_USER_BIT_TL_TRIGGER0

Specifies to affect the bit of the TL trigger static-user-output register.

 ‡ k q
Click to summarize M_USER_BITn

Specifies to affect bit n of the main static-user-output register.

Note that there is one main static-user-output register per acquisition path. However, if one of its bits can be routed to a signal that is shared across acquisition paths, changing that bit in one register affects the register of all the other acquisition paths.

(summarize)
‡ c j k l m o p q r s
MIL system specific

With a GenICam SFNC-compliant camera, n is a number from 0 to 31.

 ‡ c o s
Combination values for M_USER_BIT_STATE_ALL.

You can add one of the following values to the above-mentioned value to specify the static-user-output register to affect, if you don't want to affect the main static-user-output register.

function map For specifying the static-user-output register
Click to summarize
Combination value		 Description MIL system-specific
tooltip (‡)
Click to summarize M_USER_BIT

Specifies to control the main static-user-output register.

This is the default value.

(summarize)
‡ j k l m p q r
Click to summarize M_USER_BIT_CC_IO

Specifies to control the static-user-output register associated with Camera Link camera control signals (the camera control static-user-output register).

 ‡ j m p r
Click to summarize M_USER_BIT_TL_TRIGGER

Specifies to control the static-user-output register associated with TL trigger signals (the TL trigger static-user-output register).

 ‡ k q

The following control types and control values allow you to set the controls associated with triggered grabbing. For more information, see the Grabbing with triggers section of Chapter 25: Grabbing with your digitizer.

[Matrox Morphis]

Triggered grabs are not supported on Matrox Morphis Quad.

function map For controlling the settings to grab using a trigger
Click to summarize
ControlType		 Description MIL system-specific
tooltip (‡)
ControlValue
Click to summarize M_GRAB_CONTINUOUS_END_TRIGGER

Sets whether to automatically generate a trigger after MdigHalt() is issued when performing a triggered continuous grab. INQ

(summarize)
‡ c e f g h i j k l m n o p q r s t u
Click to summarize M_DEFAULT

Specifies the default value.

M_ENABLE is the default for a software triggered grab.

M_DISABLE is the default for a hardware triggered grab.

(summarize)
‡ c e f g h i j k l m n o p q r s t u
Click to summarize M_DISABLE

Specifies not to generate the trigger automatically.

With a software triggered continuous grab operation, MdigHalt() will wait indefinitely until a software trigger is issued on a separate thread.

With a hardware triggered continuous grab operation, MdigHalt() will wait indefinitely until a hardware trigger is generated before invoking the last grab.

(summarize)
‡ c e f g h i j k l m n o p q r s t u
Click to summarize M_ENABLE

Specifies to generate the trigger automatically.

With a software or hardware triggered continuous grab operation, MdigHalt() will generate a software trigger that invokes the last grab.

(summarize)
‡ c e f g h i j k l m n o p q r s t u
Click to summarize M_GRAB_TRIGGER_ACTIVATION +

Sets the signal transition upon which to generate a grab trigger. Use M_GRAB_TRIGGER_STATE to enable triggered grabbing. INQ

(summarize)
‡ b c e f g j k l m o p q r s t
MIL system specific

Note that this control type is IIDC camera specific. The camera must support the TRIGGER_MODE IIDC standard feature for this control type to be supported.

 ‡ e
Click to summarize M_DEFAULT

Same as the signal transition specified by the DCF. If the transition upon which to generate a grab trigger is not in the DCF, M_EDGE_RISING is the default.

(summarize)
‡ b e f g j k l m p q r t
Click to summarize M_ANY_EDGE

Specifies that a trigger will be generated upon both a low-to-high and a high-to-low signal transition.

 ‡ c o s
Click to summarize M_EDGE_FALLING

Specifies that a trigger will be generated upon a high-to-low signal transition.

 ‡ b c e f g j k l m o p q r s t
Click to summarize M_EDGE_RISING

Specifies that a trigger will be generated upon a low-to-high signal transition.

 ‡ b c e f g j k l m o p q r s t
Click to summarize M_LEVEL_HIGH

Specifies that a trigger is continuously issued during a high signal polarity.

 ‡ b c g j k l m o p q r s t
Click to summarize M_LEVEL_LOW

Specifies that a trigger is continuously issued during a low signal polarity.

 ‡ b c g j k l m o p q r s t
Click to summarize M_GRAB_TRIGGER_DELAY

Sets the delay between the trigger and the grab.

Note, an error is generated if the specified delay cannot be respected. INQ

(summarize)
‡ c o s
Click to summarize Value >= 0

Specifies the delay, in nsecs.

 ‡ c o s
Click to summarize M_GRAB_TRIGGER_MISSED

Sets whether the number of grab triggers missed should be counted. INQ

(summarize)
‡ f t
Click to summarize M_DISABLE

Specifies to not count the number of grab triggers missed.

This is the default value.

(summarize)
‡ f t
Click to summarize M_ENABLE

Specifies to count the number of grab triggers missed.

 ‡ f t
Click to summarize M_GRAB_TRIGGER_OVERLAP

Sets whether to allow the exposure phase of a triggered grab to occur while the previous image is still being transferred to the Host. If disabled, the exposure phase and the data transfer phase will occur sequentially.

If the exposure phase ends before the previously grabbed image is transferred to the Host, disabling this control type can lead to dropped frames. If, however, the exposure phase ends after the previously grabbed image is transferred to the Host, disabling this control type can increase the speed of your application. INQ

(summarize)
‡ c f o s
Click to summarize M_DEFAULT

Same as M_ENABLE.

 ‡ f
Click to summarize M_DISABLE

Specifies that a triggered grab will not overlap the transfer of the previous image. Note that, when grab trigger overlap is disabled, the exposure phase and the data transfer phase will occur sequentially.

(summarize)
‡ c f o s
Click to summarize M_ENABLE

Specifies that a triggered grab can overlap the transfer of the previous image.

 ‡ c f o s
Click to summarize M_GRAB_TRIGGER_SOFTWARE

Issues a software trigger.

To use this control type, the trigger source must be set to software (M_GRAB_TRIGGER_SOURCE set to M_SOFTWARE).

The call to issue a software trigger should be made in a thread separate from the thread performing the continuous grab operation (or the series of asynchronous grabs) to be triggered. If using MdigProcess(), the grab operation is automatically performed in a separate thread from the software trigger (along with any other issued M_GRAB_TRIGGER... controls); whereas, MdigGrabContinuous() and MdigGrab() are performed in the same thread as the software trigger, unless otherwise programmed.

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
MIL system specific

Note that, for this control type to function on the Host, you must pass a simulated digitizer (allocated using MdigAlloc() with M_EMULATED).

 ‡ a
Click to summarize M_ACTIVATE

Specifies the default behavior.

 ‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize M_GRAB_TRIGGER_SOURCE +

Sets the signal source of the grab trigger when there are multiple sources available. INQ

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
MIL system specific

Note that this control type is IIDC camera specific. The camera must support the TRIGGER_MODE IIDC standard feature for this control type to be supported.

 ‡ e

Note that, when using an external trigger source to control both your external lighting source and your Matrox Iris's grab, if one out of x grabbed images is significantly darker (insufficiently lit), your external trigger source might be triggering faster than your Matrox Iris can grab, transfer the image, and prepare to grab again.

 ‡ f t
Click to summarize M_DEFAULT

Same as the one specified by the DCF.

 ‡ b g h j k l m n p q r t
Click to summarize M_AUX_IOn

Specifies to use auxiliary input signal n as the trigger source, where n is the number of the auxiliary signal.

(summarize)
‡ b c e f g j k l m o p q r s t
MIL system specific

Note that the specified auxiliary signal can also be a bidirectional signal set to input (using M_IO_MODE set to M_INPUT).

 ‡ c l o p q r s

With a Matrox Radient eV-CxP, n is a number from 0 to 31.

 ‡ k q

With a Matrox Solios eCL/XCL-B, n is a number from 0 to 2.

 ‡ m

With a GenICam SFNC-compliant camera, n is a number from 0 to 31.

 ‡ c o s

With an IIDC camera, the exact number of trigger controllers available is determined by your camera.

 ‡ e

With Matrox Iris GTR, n is a number from 3 to 6.

 ‡ t

This value can only be set to M_AUX_IO8.

 ‡ f
Click to summarize M_HSYNC

Specifies to use the horizontal synchronization signal of the camera as the trigger source.

 ‡ j l m p r
Click to summarize M_IO_COMMAND_LIST1 +

Specifies to route the output a bit of the I/O command register of I/O command list 1.


You must specify a combination value from the following table:
(summarize)
‡ t
Click to summarize M_ROTARY_ENCODER

Specifies to use the output of the default rotary decoder (set with M_ROTARY_ENCODER_OUTPUT_MODE) as the trigger source.

(summarize)
‡ j k m p q r t
MIL system specific

This control type specifies to use the rotary decoder corresponding to 1+ the device number of the specified digitizer (DigId) will be used. For example, when the device number of the specified digitizer is M_DEV2, rotary decoder M_ROTARY_ENCODER3 is used.

 ‡ k q
Click to summarize M_ROTARY_ENCODERn

Specifies to use rotary decoder n as the trigger source, where n is a number between 1 and 4.

To use the output of the default rotary decoder, use M_ROTARY_ENCODER.

(summarize)
‡ k q t
MIL system specific

With Matrox Iris GTR, n must be 1.

 ‡ t
Click to summarize M_SOFTWARE

Specifies to use a software trigger as the trigger source. Use M_GRAB_TRIGGER_SOFTWARE to issue the trigger.

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize M_SOFTWAREn

Specifies to use the software trigger being used for the grab of another digitizer (on the same board) as the trigger source. With this control value, n corresponds to 1+ the device number of the digitizer that is (by default) associated with the specified software trigger, and can be from 1 to 4.

(summarize)
‡ k q
Click to summarize M_TIMERn

Specifies to use the output signal of the specified timer as the trigger source. Use the M_TIMER_... to set up the timer.

(summarize)
‡ c j k l m o p q r s t
MIL system specific

In this case, n can be a value from 1 to 2.

 ‡ l

In this case, n can be a value from 1 to 4.

 ‡ j k m p q r

With Matrox Iris GTR, n is a number from 1 to 8.

 ‡ t

With a GenICam SFNC-compliant camera, n can be a value from 0 to 8.

 ‡ c o s
Click to summarize M_TL_TRIGGER

Specifies to use the transport layer trigger signal. The transport layer trigger signal is an embedded bidirectional signal from the physical transport layer connection of your camera. Typically, the TL Trigger is reserved for trigger information and is sent with other control and data signals along the same cable.

(summarize)
‡ k q
Click to summarize M_VSYNC

Specifies to use the vertical synchronization signal of the camera as the trigger source.

 ‡ j l m p r
Click to summarize M_GRAB_TRIGGER_STATE +

Sets whether, when a grab command is issued (for example, MdigGrab()) to wait for a trigger before grabbing. If your Matrox frame grabber supports trigger input, you can set up your digitizer to perform a triggered grab, that is, to grab a frame upon the occurrence of an event. In this case, nothing is grabbed when you call MdigGrab() or MdigGrabContinuous() or MdigProcess(), until a specified event occurs. When grabbing continuously, the digitizer waits for a trigger before grabbing each frame; you must still call MdigHalt() after grabbing all required frames.

Note that, you can specify the number of frames to grab per trigger received (using MdigProcess() with M_FRAMES_PER_TRIGGER()) or only use a single trigger to start the grab (using MdigProcess() with M_TRIGGER_FOR_FIRST_GRAB). INQ

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
MIL system specific

Use M_GRAB_TRIGGER_SOURCE to specify the trigger source.

 ‡ b c e f g o s t

The trigger source is automatically set to use a software trigger.

 ‡ a b e i u

Note that, when dealing with a software trigger (that is, when M_GRAB_TRIGGER_SOURCE is set to M_SOFTWARE), this control type is IIDC camera specific. The camera must support the TRIGGER_MODE IIDC standard feature for this control type to be supported.

 ‡ e

Note that, for this control type to function on the Host, you must pass a simulated digitizer (allocated using MdigAlloc() with M_EMULATED).

 ‡ a
Click to summarize M_DEFAULT

Same as the state specified by the DCF or, if none specified, M_DISABLE.

 ‡ b e f g i j k l m p q r t u
Click to summarize M_DISABLE

Specifies that, when a grab command is issued, the grab occurs without waiting for a trigger.

Note that, this is the default behavior when using a software trigger.

(summarize)
‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize M_ENABLE

Specifies that, when a grab command is issued, the grab waits for a trigger before occurring.

 ‡ a b c e f g h i j k l m n o p q r s t u
Click to summarize M_OFF

Specifies that the camera's feature is turned off. Note that, using this value instead of M_DISABLE, the mechanism that receives the trigger on your camera might differ from the methodologies used by MIL. See your camera's documentation for more information.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. Note that, using this value instead of M_ENABLE, the mechanism that receives the trigger on your camera might differ from the methodologies used by MIL. See your camera's documentation for more information.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Combination value for M_IO_COMMAND_LIST1 (when ControlType= M_GRAB_TRIGGER_SOURCE and ControlValue=M_IO_COMMAND_LIST1).

You must add the following value to the above-mentioned value to specify which I/O command register bit to use.

function map For specifying which I/O command register bit to use
Click to summarize
Combination value		 Description MIL system-specific
tooltip (‡)
Click to summarize M_IO_COMMAND_BITn

Specifies I/O command register bit n, where n represents the bit number.

With Matrox Iris GTR, n can be a value from 0 to 4.

(summarize)
‡ t

The following control types and control values specify the settings for controlling timers and the signals generated from a timer (timer output signals). For more information, see the Grabbing with triggers section of Chapter 25: Grabbing with your digitizer.

function map For controlling the settings of a timer
Click to summarize
ControlType		 Description MIL system-specific
tooltip (‡)
ControlValue
Click to summarize M_TIMER_CLOCK_SOURCE +

Specifies the source of the clock that drives the specified timer.

The clock source must have a frequency greater than or equal to 1 Hz. INQ


You must specify a combination value from the following table:
(summarize)
‡ j k l m p q r
Click to summarize M_DEFAULT

Specifies to use the most appropriate clock source (as determined by the driver).

 ‡ j k l m p q r
Click to summarize M_HSYNC

Specifies to use the horizontal synchronization frequency of your camera.

 ‡ j l m p r
Click to summarize M_PIXCLK

Specifies to use the pixel clock frequency of your camera.

 ‡ j l m p r
Click to summarize M_SYSCLK

Specifies to use the frequency of the allocated system's clock source.

(summarize)
‡ j k l m p q r
MIL system specific

The frequency is programmable in the DCF.

 ‡ j l m p r

For Matrox Radient eV-CXP, the frequency is set to 125MHz, and it cannot be changed.

 ‡ k q
Click to summarize M_TIMERn

Specifies to use the frequency of the output of the specified timer, where n is the timer number. Note that, in this case, the timer output pulse is used as a clock tick. The specified timer should be in continuous mode (that is, M_TIMER_TRIGGER_SOURCE is set to M_CONTINUOUS).

Only a continuous timer can clock another timer. References where timer 1 points to timer 2, and timer 2 points back to timer 1, are not supported and will generate an error.

(summarize)
‡ j k l m p q r
MIL system specific

With Matrox Solios eA/XA, n can be a value from 1 to 2.

 ‡ l

In this case, n can be a value from 1 to 4.

 ‡ j k m p q r
Click to summarize M_VSYNC

Specifies to use the vertical synchronization frequency of your camera.

 ‡ j l m p r
Click to summarize M_TIMER_DELAY +

Sets the delay between the timer trigger and the active portion of the timer output signal.

Note, an error is generated if the specified delay cannot be respected. INQ


You must specify a combination value from the following table:
(summarize)
‡ c e f j k l m o p q r s t
Click to summarize M_DEFAULT

Specifies the default value.

(summarize)
‡ f j k l m p q r t
MIL system specific

Same as the delay specified by the DCF.

 ‡ j k l m p q r
Click to summarize 0

Specifies that there is no delay.

 ‡ c f o s t
Click to summarize Value > 0

Specifies the delay, in nsecs.

 ‡ c e f j k l m o p q r s t
Click to summarize M_TIMER_DURATION +

Sets the duration for the active portion of the timer output signal.

Note, an error is generated if the specified duration cannot be respected. INQ


You must specify a combination value from the following table:
(summarize)
‡ c e f j k l m o p q r s t
MIL system specific

Unlike with other products, when using the grab trigger signal to trigger timer 2, the specified duration of timer 2's output signal specifies how long the timer should remain active during the exposure period. The active period of timer 2's output will actually start after the specified delay, but the count for how long it should remain active only starts when the camera starts exposing its CCD. Once counting begins, the signal will typically be active for the specified duration. If the duration of timer 2 is greater than the exposure time, timer 2's output signal will end when the exposure time ends (set using M_EXPOSURE_TIME).

 ‡ f

Unlike with other products, when using the grab trigger signal to trigger the strobe, the specified duration of the strobe's timer output signal specifies how long the timer should remain active during the exposure period. The active period of the strobe's timer output will actually start after the specified delay, but the count for how long it should remain active only starts when the camera starts exposing its CCD. Once counting begins, the signal will typically be active for the specified duration. If the duration of the strobe's timer is greater than the exposure time, the strobe's timer's output signal will end when the exposure time ends (set using M_EXPOSURE_TIME).

 ‡ t
Click to summarize M_DEFAULT

Specifies to use the duration specified by the DCF.

 ‡ f j k l m p q r t
Click to summarize M_INFINITE

Specifies to not set a limit on the duration of the active portion of the timer output signal. Use M_TIMER_STATE with M_DISABLE to disable the timer and its output.

(summarize)
‡ f
Click to summarize Value > 0

Specifies the duration of the active portion of the timer output signal, in nsecs.

 ‡ c e f j k l m o p q r s t
Click to summarize M_TIMER_OUTPUT_INVERTER +

Sets whether the output of the timer should be inverted. This causes the low portion of the signal (the delay period) to be high and the high portion of the signal (the active portion) to be low. INQ


You must specify a combination value from the following table:
(summarize)
‡ e f j k l m p q r t
Click to summarize M_DEFAULT

Specifies the default value.

(summarize)
‡ f j k l m p q r
MIL system specific

Same as the value specified by the DCF.

 ‡ j k l m p q r

Same as M_DISABLE.

 ‡ f
Click to summarize M_DISABLE

Specifies not to invert the output of the timer.

 ‡ e f j k l m p q r t
Click to summarize M_ENABLE

Specifies to invert the output of the timer.

 ‡ e f j k l m p q r t
Click to summarize M_TIMER_STATE +

Sets the state of the specified timer.

When a timer is enabled, the timer waits for a trigger to be received. To set the source of the trigger, use M_TIMER_TRIGGER_SOURCE. Once the trigger is received, the timer starts by outputting a low signal. This lasts for the duration of the delay period (set using M_TIMER_DELAY). The timer then changes to output a high signal for the duration of the active period (set using M_TIMER_DURATION). To invert this signal, use M_TIMER_OUTPUT_INVERTER. INQ


You must specify a combination value from the following table:
(summarize)
‡ c e f j k l m o p q r s t
Click to summarize M_DEFAULT

Specifies the default value.

(summarize)
‡ f j k l m p q r t
MIL system specific

Same as the state specified by the DCF.

 ‡ j k l m p q r

Same as M_TIMER_STATE set to M_DISABLE.

 ‡ f t
Click to summarize M_DISABLE

Specifies that the timer is disabled.

 ‡ c e f j k l m o p q r s t
Click to summarize M_ENABLE

Specifies that the timer is enabled.

 ‡ c e f j k l m o p q r s t
Click to summarize M_TIMER_TRIGGER_ACTIVATION +

Sets the signal variation upon which to generate a timer trigger, if the specified timer is enabled. Use M_TIMER_STATE to enable the timer. INQ


You must specify a combination value from the following table:
(summarize)
‡ c e j k l m o p q r s
Click to summarize M_DEFAULT

Specifies the default value.

(summarize)
‡ c j k l m o p q r s
MIL system specific

Same as the signal variation specified by the DCF.

 ‡ j k l m p q r

Same as M_EDGE_RISING.

 ‡ c o s
Click to summarize M_ANY_EDGE

Specifies that a timer trigger will be generated both upon a high-to-low and a low-to-high signal transition.

 ‡ c e j k l m o p q r s
Click to summarize M_EDGE_FALLING

Specifies that a timer trigger will be generated upon a high-to-low signal transition.

 ‡ c e j k l m o p q r s
Click to summarize M_EDGE_RISING

Specifies that a timer trigger will be generated upon a low-to-high signal transition.

 ‡ c e j k l m o p q r s
Click to summarize M_LEVEL_HIGH

Specifies that a timer trigger is continuously issued during a high signal polarity.

 ‡ c o s
Click to summarize M_LEVEL_LOW

Specifies that a timer trigger is continuously issued during a low signal polarity.

 ‡ c o s
Click to summarize M_TIMER_TRIGGER_MISSED +

Sets whether to count the number of trigger pulses missed. INQ


You must specify a combination value from the following table:
(summarize)
‡ f j k l m p q r
Click to summarize M_DEFAULT

Same as M_DISABLE.

 ‡ f j k l m p q r
Click to summarize M_DISABLE

Specifies not to count the number of trigger pulses missed.

 ‡ f j k l m p q r
Click to summarize M_ENABLE

Specifies to count the number of trigger pulses missed.

 ‡ f j k l m p q r
Click to summarize M_TIMER_TRIGGER_RATE_DIVIDER +

Sets the frequency to accept trigger pulses (for example, if set to 2, the first trigger pulse is ignored and the second is accepted). INQ


You must specify a combination value from the following table:
(summarize)
‡ j k l m p q r
Click to summarize M_DEFAULT

Specifies the default value; the default value is 1.

 ‡ j k l m p q r
Click to summarize 1; 2; 4; 8; 16

Specifies the frequency with which to accept a trigger out of a series of trigger pulses. Note that, if set to 1, all trigger pulses are accepted.

(summarize)
‡ j k l m p q r
Click to summarize M_TIMER_TRIGGER_SOFTWARE +

Issues a software trigger for the specified timer.

To use this setting, the timer's trigger source must be set to software (M_TIMER_TRIGGER_SOURCE set to M_SOFTWARE).


You must specify a combination value from the following table:
(summarize)
‡ c e f j k l m o p q r s
Click to summarize M_ACTIVATE

Specifies the default behavior.

 ‡ c e f j k l m o p q r s
Click to summarize M_TIMER_TRIGGER_SOURCE +

Selects the trigger source for the specified timer when there are multiple sources available. INQ


You must specify a combination value from the following table:
(summarize)
‡ c e f j k l m o p q r s t
MIL system specific

This control type is not supported on third-party IEEE 1394 IIDC-compliant network boards.

 ‡ e
Click to summarize M_DEFAULT

Same as the one specified by the DCF.

 ‡ c j k l m o p q r s
Click to summarize M_NULL

Specifies that no trigger source is specified.

 ‡ j k l m p q r
Click to summarize M_AUX_IOn

Specifies to use auxiliary input signal n as the trigger source for the specified timer, where n is the number of the auxiliary signal. Note that the specified auxiliary signal can also be a bidirectional signal set to input (using M_IO_MODE set to M_INPUT).

For a list of the available auxiliary I/O signals, see the Connectors and signal names section of the MIL Hardware-specific Notes chapter for your Matrox imaging board or MIL driver.

(summarize)
‡ c e j k l m o p q r s
Click to summarize M_CONTINUOUS

Specifies to run the specified timer in periodic mode; no actual trigger signal is used. The timer is automatically reset after the timer's duration expires. The timer loops between a delay and an active period.

(summarize)
‡ c e j k l m o p q r s
Click to summarize M_EXPOSURE_END

Specifies to use the exposure end signal as the trigger source. The exposure end signal is a quick pulse that occurs when the exposure ends.

(summarize)
‡ c o s
Click to summarize M_EXPOSURE_START

Specifies to use the exposure start signal as the trigger source. The exposure start signal is a quick pulse that occurs when the exposure starts.

(summarize)
‡ c f o s t
Click to summarize M_GRAB_TRIGGER

Specifies to use the grab trigger source signal as the trigger source. To set the grab trigger source signal, use M_GRAB_TRIGGER_SOURCE.

(summarize)
‡ c f o s t
Click to summarize M_HSYNC

Specifies to use the horizontal synchronization signal as the trigger source.

 ‡ j l m p r
Click to summarize M_ROTARY_ENCODER

Specifies to use the output of the default rotary decoder (set with M_ROTARY_ENCODER_OUTPUT_MODE) as the trigger source.

(summarize)
‡ j k m p q r
MIL system specific

This control type specifies to use the rotary decoder corresponding to 1+ the device number of the specified digitizer (DigId) will be used. For example, when the device number of the specified digitizer is M_DEV2, rotary decoder M_ROTARY_ENCODER3 is used.

 ‡ k q
Click to summarize M_ROTARY_ENCODERn

Specifies to use rotary decoder n, where n is a number between 1 and 4.

To use the output of the default rotary decoder, use M_ROTARY_ENCODER.

(summarize)
‡ k q
Click to summarize M_SOFTWARE

Specifies to use a software trigger as the trigger source. Use M_TIMER_TRIGGER_SOFTWARE to issue the trigger.

(summarize)
‡ c e f j k l m o p q r s
Click to summarize M_TIMERn

Specifies to use the output signal of the specified timer as the trigger source, where n is the timer number.

(summarize)
‡ c e j k l m o p q r s
MIL system specific

With Matrox Solios eA/XA, n can from 1 to 2.

 ‡ l

In this case, n can be a value from 1 to 4.

 ‡ j k m p q r

With a GenICam SFNC-compliant camera, n can be a value from 0 to 8.

 ‡ c o s
Click to summarize M_TL_TRIGGER

Specifies to use the transport layer trigger signal. The transport layer trigger signal is an embedded bidirectional signal from the physical transport layer connection of your camera. Typically, the TL Trigger is reserved for trigger information and is sent with other control and data signals along the same cable.

(summarize)
‡ k q
Click to summarize M_VSYNC

Specifies to use the vertical synchronization signal as the trigger source.

 ‡ j l m p r

The following control types and control values specify the settings for controlling the camera's exposure. For more information, see the MIL Hardware-specific Notes for your Matrox Imaging board.

function map For controlling the camera's exposure
Click to summarize
ControlType		 Description MIL system-specific
tooltip (‡)
ControlValue
Click to summarize M_AUTO_EXPOSURE +

Sets the automatic exposure mode of the camera. INQ

(summarize)
‡ c e o s
MIL system specific

This control type sets whether the camera controls the gain, iris, and shutter features automatically. To manually set these camera controls, use M_GAIN, M_IRIS, and M_SHUTTER.

Note that this control type is IIDC camera specific. The camera must support the AUTO_EXPOSURE IIDC standard feature for this control type to be supported.

 ‡ e
Click to summarize M_DEFAULT

Specifies to use the camera's default values or, if supported, to enable the camera's auto control state for the gain, iris, and shutter features (that is, the camera adjusts these values automatically).

 ‡ c e o s
Click to summarize M_AUTOMATIC

Specifies that the camera's exposure duration is constantly adapted by the device to maximize its effect.

 ‡ c o s
Click to summarize M_DISABLE

Specifies that the camera will not control the gain, iris, and shutter settings automatically.

 ‡ c o s
Click to summarize M_ENABLE

Specifies that the camera controls the gain, iris, and shutter settings automatically.

 ‡ c o s
Click to summarize M_OFF

Specifies that the camera's auto-exposure feature is turned off; this allows the gain, iris, and shutter features to be controlled manually. Note that, using this value instead of M_DISABLE, the mechanism that receives the trigger on your camera might differ from the methodologies used by MIL. See your camera's documentation for more information.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's gain, iris, and shutter features are turned on. Note that, using this value instead of M_ENABLE, the mechanism that receives the trigger on your camera might differ from the methodologies used by MIL. See your camera's documentation for more information.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. exposure <= Value <= Max. exposure

Specifies a value between the minimum and maximum values supported by the camera.

With IIDC cameras, the auto-exposure value specifies the gain. Use MdigInquire() with M_GAIN to determine these values. The shutter and iris settings will be adjusted automatically by the camera as long as M_AUTO_EXPOSURE is set to M_ON.

(summarize)
‡ e
Click to summarize M_EXPOSURE_DELAY

Sets the required delay between the exposure trigger and the start of your camera's CCD being exposed.

Note, an error is generated if the specified delay cannot be respected. INQ

(summarize)
‡ f t
Click to summarize M_DEFAULT

Specifies the default value; the default value is 0 nsec.

 ‡ f t
Click to summarize Value >= 0

Specifies the delay, in nsecs.

 ‡ f t
Click to summarize M_EXPOSURE_MODE

Sets whether the exposure duration is set using an exposure timer or using the width of the trigger signal. INQ

(summarize)
‡ t
Click to summarize M_TIMED

Specifies to use M_EXPOSURE_TIME to control the length of the exposure.

 ‡ t
Click to summarize M_TRIGGER_WIDTH

Specifies to use duration of the active portion of the grab trigger's output signal to control the length of the exposure.

Use M_GRAB_TRIGGER_ACTIVATION to specify the signal transition upon which to generate a grab trigger. Note that, M_TRIGGER_WIDTH can only be used when M_GRAB_TRIGGER_ACTIVATION is set to M_LEVEL_HIGH or M_LEVEL_LOW.

(summarize)
‡ t
Click to summarize M_EXPOSURE_TIME

Sets the amount of time to expose the camera's CCD.

Note, an error is generated if the specified duration cannot be respected. INQ

(summarize)
‡ c f o s t
Click to summarize M_DEFAULT

Specifies to use the camera's default exposure time, as specified by the DCF.

 ‡ f t
Click to summarize Value >= 0

Specifies the amount of time to expose the camera's CCD, in nsecs.

 ‡ c f o s t
Click to summarize M_SHUTTER +

Sets the amount of time that the shutter will remain open. This value determines the amount of incoming light.

Note that this control type is IIDC camera specific. The camera must support the SHUTTER IIDC standard feature for this control type to be supported.

To set the exposure automatically, use M_AUTO_EXPOSURE. INQ

(summarize)
‡ e
Click to summarize M_DEFAULT

Specifies to use the camera's default value or, if supported, to enable the camera's auto control state for this feature (that is, the camera adjusts this value automatically).

The default value is determined by the following calculation ((max-min)/2)+min , where max is the longest possible exposure time permitted by the camera and min is the shortest.

(summarize)
‡ e
Click to summarize M_OFF

Specifies that the camera's feature is turned off.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize M_ON

Specifies that the camera's feature is turned on. By default, when turned on and the camera supports it, the camera adjusts the feature's value automatically.

Note that this control value is only available when the M_MODE_CONTROL combination constant is used.

(summarize)
‡ e
Click to summarize Min. shutter <= Value <= Max. shutter

Specifies a value between the minimum and maximum values supported by the camera. Use MdigInquire() to determine these values.

Note that, if using M_SHUTTER + M_MODE_CONTROL, you must first set M_SHUTTER to M_ON for the value specified to take effect. In addition, M_AUTO_EXPOSURE must be disabled; otherwise, the shutter is in its auto control state.

(summarize)
‡ e
Combination value for M_AUTO_EXPOSURE; M_BRIGHTNESS; M_CAPTURE_QUALITY; M_CAPTURE_SIZE; M_FOCUS; M_GAIN; M_GAMMA; M_GRAB_TRIGGER_STATE; M_HUE; M_IRIS; M_OPTICAL_FILTER; M_PAN; M_SATURATION; M_SHARPNESS; M_SHUTTER; M_TARGET_TEMPERATURE; M_TILT; M_WHITE_BALANCE_U; M_WHITE_BALANCE_V; M_ZOOM.

You can add the following value to the above-mentioned values to specify whether a feature can be turned on or off.

function map For specifying whether an IIDC camera specific feature can be turned on or off
Click to summarize
Combination value		 Description MIL system-specific
tooltip (‡)
Click to summarize M_MODE_CONTROL

Allows the IIDC camera-specific feature to be set to M_ON, M_OFF.

For more information on how using mode control changes the behavior of the control type specified, refer to your camera's documentation.

(summarize)
‡ e
Combination values for M_AUTO_EXPOSURE; M_GRAB_SCALE; M_GRAB_SCALE_X; M_GRAB_SCALE_Y; M_GRAB_TRIGGER_ACTIVATION; M_GRAB_TRIGGER_SOURCE; M_GRAB_TRIGGER_STATE; M_SOURCE_OFFSET_X; M_SOURCE_OFFSET_Y; M_SOURCE_SIZE_X; M_SOURCE_SIZE_Y; M_TIMER_DELAY; M_TIMER_OUTPUT_INVERTER; M_TIMER_STATE; M_TIMER_TRIGGER_ACTIVATION; M_TIMER_TRIGGER_SOURCE.

You can add one of the following values to the above-mentioned values to specify whether the control type relates to the camera or the board.

function map For specifying whether the control type relates to the camera or the board
Click to summarize
Combination value		 Description MIL system-specific
tooltip (‡)
Click to summarize M_BOARD

Specifies that this is a value for your interface board and not the connected camera.

 ‡ e
Click to summarize M_CAMERA

Specifies that this is a value for the connected camera and not your interface board.

When using this combination constant, the control type must be supported by the camera. Refer to your camera's documentation for more information.

This is the default value.

(summarize)
‡ e

The following control types allow you to control the settings of a rotary decoder.

function map For controlling the settings of a rotary decoder
Click to summarize
ControlType		 Description MIL system-specific
tooltip (‡)
ControlValue
Click to summarize M_ROTARY_ENCODER_BIT0_SOURCE

Specifies the auxiliary input signal on which to receive bit 0 of the 2-bit Gray code.

Note that if the auxiliary input signal for bit 0 is set using this constant, the corresponding auxiliary input signal for bit 1 will automatically be assigned; you do not need to specify it using M_ROTARY_ENCODER_BIT1_SOURCE. INQ

(summarize)
‡ j p r
Click to summarize M_DEFAULT

Same as DCF.

 ‡ j p r
Click to summarize M_AUX_IOn

Specifies the auxiliary input signal to use. The auxiliary input signal must support bit 0 of quadrature input.

(summarize)
‡ j p r
Click to summarize M_ROTARY_ENCODER_BIT1_SOURCE

Specifies the auxiliary input signal on which to receive bit 1 of the 2-bit Gray code.

Note that if the auxiliary input signal for bit 1 is set using this constant, the corresponding auxiliary input signal for bit 0 will automatically be assigned; you do not need to specify it using M_ROTARY_ENCODER_BIT0_SOURCE. INQ

(summarize)
‡ j p r
Click to summarize M_DEFAULT

Same as DCF.

 ‡ j p r
Click to summarize M_AUX_IOn

Specifies the auxiliary input signal to use. The auxiliary input signal must support bit 1 of quadrature input.

(summarize)
‡ j p r
Click to summarize M_ROTARY_ENCODER_DIRECTION +

Specifies the direction of movement occurring when the Gray code sequence received by the rotary decoder is 00 - 01 - 11 - 10; this essentially establishes whether to increment or decrement the counter when receiving this sequence. A forward direction increments; while a backward direction decrements. For more information on how to set the direction, refer to the Interpreting the direction of movement from the Gray code subsection of the Using quadrature input from a rotary encoder section of Chapter 26: I/O signals and communicating with external devices. INQ

(summarize)
‡ j k m p q r
Click to summarize M_DEFAULT

Same as DCF.

 ‡ j k m p q r
Click to summarize M_BACKWARD

Specifies a backward direction of movement and to decrement the counter when the Gray code sequence is 00 - 01 - 11 - 10.

 ‡ j k m p q r
Click to summarize M_FORWARD

Specifies a forward direction of movement and to increment the counter when the Gray code sequence is 00 - 01 - 11 - 10.

 ‡ j k m p q r
Click to summarize M_ROTARY_ENCODER_FORCE_VALUE_SOURCE +

Sets the signal source to use to set the rotary decoder's counter to 0xFFFFFFFF. The rotary decoder will set the counter to this value on the rising edge of a signal transition of the selected source. INQ

(summarize)
‡ j k m p q r
Click to summarize M_DEFAULT

Specifies to use the source set in the DCF.

 ‡ j k m p q r
Click to summarize M_NULL

Specifies not to set the counter to 0xFFFFFFFF upon a signal.

 ‡ j k m p q r
Click to summarize M_AUX_IOn

Specifies to use an auxiliary input signal or an auxiliary bidirectional signal set to input (using M_IO_MODE set to M_INPUT).

(summarize)
‡ j k m p q r
MIL system specific

Only auxiliary input signals M_AUX_IO2 and M_AUX_IO7 can be specified.

 ‡ j m p r
Click to summarize M_COUNTER_OVERFLOW

Specifies to set the counter to 0xFFFFFFFF and keep it at this value after the counter increments past 0x7FFFFFFF. To reset the counter to 0, use M_ROTARY_ENCODER_POSITION.

(summarize)
‡ j k m p q r
Click to summarize M_POSITION_TRIGGER

Specifies to use the trigger signal generated by the rotary decoder when the counter reaches the value specified with M_ROTARY_ENCODER_POSITION_TRIGGER.

 ‡ j k m p q r
Click to summarize M_STEP_BACKWARD_WHILE_POSITIVE

Specifies to set the counter to 0xFFFFFFFF upon a decrement, only if the counter value is in the range of 0x0 to 0x7FFFFFFF before the decrement occurs; when interpreting the counter value as signed, this would be the positive counter value range.

A typical use of this control value is to identify the number of steps taken backwards by the rotary encoder, so that the corresponding lines of data are not regrabbed. For a complete example, refer to the Using the rotary decoder's output to trigger a timer or a grab subsection of the Using quadrature input from a rotary encoder section of Chapter 26: I/O signals and communicating with external devices.

(summarize)
‡ j k m p q r
Click to summarize M_TL_TRIGGER

Specifies to use a transport layer trigger input signal.

 ‡ k q
Click to summarize M_ROTARY_ENCODER_FRAME_END_READ +

Sets whether to enable the rotary decoder to store the counter value at the end of the last grab or frame interrupt. If enabled, the value of the counter can be inquired at anytime using MdigInquire() with M_ROTARY_ENCODER_FRAME_END_POSITION, or retrieved at the end of the last grab from a hooked function, using MdigGetHookInfo() with M_ROTARY_ENCODER_FRAME_END_POSITION. INQ

(summarize)
‡ j k m p q r
Click to summarize M_DEFAULT

Same as M_DISABLE.

 ‡ j k m p q r
Click to summarize M_DISABLE

Specifies that the counter value will not be available to be inquired at the end of the last frame grabbed.

 ‡ j k m p q r
Click to summarize M_ENABLE

Specifies to enable the rotary decoder to store the counter value at the end of the last grabbed frame, so that it can be inquired.

 ‡ j k m p q r
Click to summarize M_ROTARY_ENCODER_MULTIPLIER

Specifies to apply a multiplying factor to each increment/decrement of the rotary decoder's counter for every rotary encoder step (change in position); this in turn applies a multiplying factor to the number of pulses that the rotary decoder outputs per step. For example, if this control value is set to 4, and M_ROTARY_ENCODER_OUTPUT_MODE is set to M_STEP_ANY, the rotary decoder will increment its counter by 4 and output 4 pulses for every rotary encoder step. INQ

(summarize)
‡ j p r
Click to summarize M_DEFAULT

Specifies the default value; the default value is 1.

 ‡ j p r
Click to summarize 0 <= Value <= 4096

Specifies the multiplying factor to use.

 ‡ j p r
Click to summarize M_ROTARY_ENCODER_OUTPUT_MODE +

Specifies the rotary decoder's counter value and/or the direction of movement upon which the rotary decoder should output a pulse. The pulse can be used to trigger a timer or a grab. To trigger a timer or a grab, set M_TIMER_TRIGGER_SOURCE or M_GRAB_TRIGGER_SOURCE (respectively) to M_ROTARY_ENCODER.

To decimate (subsample) the rotary decoder output signal before sending it to a timer or a grab controller, set this control type to M_POSITION_TRIGGER and set M_ROTARY_ENCODER_POSITION_TRIGGER to the required decimation value. For more information, refer to the Pixel aspect ratio subsection of the Using quadrature input from a rotary encoder section of Chapter 26: I/O signals and communicating with external devices. INQ

(summarize)
‡ j k p q r
Click to summarize M_DEFAULT

Same as DCF.

 ‡ j k p q r
Click to summarize M_POSITION_TRIGGER

Specifies to output a pulse upon the trigger generated by M_ROTARY_ENCODER_POSITION_TRIGGER.

 ‡ j k p q r
Click to summarize M_STEP_ANY

Specifies to output a pulse upon any change in the rotary decoder's counter value (position change in any direction).

 ‡ j k p q r
Click to summarize M_STEP_ANY_WHILE_POSITIVE

Specifies to output a pulse upon any change in the rotary decoder's counter value (position change in any direction), only if the counter value is in the range of 0x0 to 0x7FFFFFFF before the increment or decrement occurs; when interpreting the counter value as signed, this would be the positive counter value range.

Note that, if the counter value is treated as a signed integer and the counter is 0x7FFFFFFF, the next incremented value is 0x80000000 (falling into the negative counter value range). If you want to remain in the positive range, reset the counter to 0 using either M_ROTARY_ENCODER_POSITION or M_ROTARY_ENCODER_RESET_SOURCE.

(summarize)
‡ j k p q r
Click to summarize M_STEP_FORWARD

Specifies to output a pulse upon a rotary decoder counter increment only.

 ‡ j k p q r
Click to summarize M_STEP_FORWARD_WHILE_POSITIVE

Specifies to output a pulse upon a rotary decoder counter increment, only if the counter value is in the range of 0x0 to 0x7FFFFFFF before the increment occurs; when interpreting the counter value as signed, this would be the positive counter value range.

Note that, if the counter value is treated as a signed integer and the counter is 0x7FFFFFFF, the next incremented value is 0x80000000 (falling into the negative counter value range). If you want to remain in the positive range, reset the counter to 0 using either M_ROTARY_ENCODER_POSITION or M_ROTARY_ENCODER_RESET_SOURCE.

(summarize)
‡ j k p q r
Click to summarize M_ROTARY_ENCODER_POSITION +

Resets the rotary decoder's counter to 0 immediately.

To reset the counter to 0 upon a signal, use M_ROTARY_ENCODER_RESET_SOURCE.

Note that a call to MdigInquire() with M_ROTARY_ENCODER_POSITION inquires the current value of the rotary decoder counter.

(summarize)
‡ j k m p q r
Click to summarize Value = 0

Implements the default behavior. Note that, if a non-zero value is specified, an error is generated.

(summarize)
‡ j k m p q r
Click to summarize M_ROTARY_ENCODER_POSITION_TRIGGER +

Specifies the rotary decoder's counter value upon which a trigger is generated.

You can hook a function to the trigger generated, using MdigHookFunction() with M_ROTARY_ENCODER. You can also output this trigger to a timer or a grab controller using M_ROTARY_ENCODER_OUTPUT_MODE set to M_POSITION_TRIGGER. INQ

(summarize)
‡ j k m p q r
Click to summarize 0 <= Value <= 0xFFFFFFFF

Specifies the value of the counter upon which a trigger is generated. If a value beyond the supported range is specified, an error is generated.

If you are treating the counter values as a signed range of values (for example, forcing the counter to reset to 0 at 0x80000000) and you want to generate a trigger upon a negative value, specify the equivalent value in the range of 0x80000000 to 0xFFFFFFFF.

(summarize)
‡ j k m p q r
Click to summarize M_ROTARY_ENCODER_RESET_SOURCE +

Specifies the signal source to use to reset the rotary decoder's counter to 0. The rotary decoder will reset the counter on the rising edge of a signal transition of the selected source.

Alternatively, you can immediately reset the counter to 0 (without using a signal to trigger the reset), using M_ROTARY_ENCODER_POSITION. INQ

(summarize)
‡ j k m p q r
Click to summarize M_DEFAULT

Specifies to use the source set in the DCF.

 ‡ j k m p q r
Click to summarize M_NULL

Specifies not to reset using a hardware signal source.

 ‡ j k m p q r
Click to summarize M_AUX_IOn

Specifies to use an auxiliary input signal or an auxiliary bidirectional signal set to input (using M_IO_MODE set to M_INPUT).

(summarize)
‡ j k m p q r
MIL system specific

Only auxiliary input signals M_AUX_IO2 and M_AUX_IO7 can be specified.

 ‡ j m p r
Click to summarize M_POSITION_TRIGGER

Specifies to use the trigger signal generated by the rotary decoder when the counter reaches the value specified with M_ROTARY_ENCODER_POSITION_TRIGGER.

 ‡ j k m p q r
Click to summarize M_TL_TRIGGER

Specifies to use a transport layer trigger input signal.

 ‡ k q
Combination value for M_ROTARY_ENCODER_DIRECTION; M_ROTARY_ENCODER_FORCE_VALUE_SOURCE; M_ROTARY_ENCODER_FRAME_END_READ; M_ROTARY_ENCODER_OUTPUT_MODE; M_ROTARY_ENCODER_POSITION; M_ROTARY_ENCODER_POSITION_TRIGGER; M_ROTARY_ENCODER_RESET_SOURCE.

You can add the following value to the above-mentioned values to specify which rotary decoder to set.

function map For specifying which rotary decoder to set
Click to summarize
Combination value		 Description MIL system-specific
tooltip (‡)
Click to summarize M_ROTARY_ENCODERn

Specifies to set rotary decoder n, where n is a number between 1 and 4.

Note that if you do not use this combination constant to specify a rotary decoder, the rotary decoder corresponding to 1+ the device number of the specified digitizer (DigId) will be used. For example, when the device number of the specified digitizer is M_DEV2, rotary decoder M_ROTARY_ENCODER3 is used.

(summarize)
‡ k q

The following control types allow you to control the settings for one of the data latches of your installed MIL board. Data latches store information specific to a grabbed frame when the latch is triggered; the data latch is reset at the end of every grabbed frame. To retrieve information from a data latch, use MdigGetHookInfo() with M_DATA_LATCH.... Note that data latch information is only available when MdigGetHookInfo() is called from a function hooked to an end of grabbed frame event using MdigHookFunction() with M_GRAB_FRAME_END or from the hook-handler function (callback function) of MdigProcess().

Note that you can only use data latches in association with the MIL digitizer allocated using MdigAlloc() with M_DEV0.

function map For controlling a data latch
Click to summarize
ControlType		 Description MIL system-specific
tooltip (‡)
ControlValue
Click to summarize M_DATA_LATCH_MODE +

Configures whether to latch data from the point when the grab is queued until the start of the first frame of a series of queued grabs or grab sequence.

If calls to MdigGrab() occur while no other grab is currently being performed and M_DATA_LATCH_MODE is set to M_PREFETCH, events that occur, from the moment the grab command is issued until the start of the grabbed frame, can also trigger a data latch and be retrieved at the end of the grabbed frame, for each MdigGrab() call. INQ


You must specify a combination value from the following table:
(summarize)
‡ p q r
Click to summarize M_DEFAULT

Same as M_NORMAL.

 ‡ p q r
Click to summarize M_NORMAL

Specifies not to latch before the start of the first grabbed frame.

 ‡ p q r
Click to summarize M_PREFETCH

Specifies to latch data before the start of the first grabbed frame.

 ‡ p q r
Click to summarize M_DATA_LATCH_STATE +

Sets the state of the specified data latch. INQ


You must specify a combination value from the following table:
(summarize)
‡ p q r
Click to summarize M_DEFAULT

Same as M_DISABLE.

 ‡ p q r
Click to summarize M_DISABLE

Disables the data latch.

 ‡ p q r
Click to summarize M_ENABLE

Enables the data latch.

 ‡ p q r
Click to summarize M_DATA_LATCH_TRIGGER_ACTIVATION +

Sets the trigger signal transition upon which to store the specified information to the specified data latch. Note that this is only useful when M_DATA_LATCH_TRIGGER_SOURCE is set to M_AUX_IOn or M_TIMER_ACTIVE.

To set the signal with which to trigger the data latch, use M_DATA_LATCH_TRIGGER_SOURCE. INQ


You must specify a combination value from the following table:
(summarize)
‡ p q r
Click to summarize M_DEFAULT

Same as M_EDGE_RISING.

 ‡ p q r
Click to summarize M_EDGE_FALLING

Specifies to store the specified information to the data latch upon a high-to-low signal transition.

 ‡ p q r
Click to summarize M_EDGE_RISING

Specifies to store the specified information to the data latch upon a low-to-high signal transition.

 ‡ p q r
Click to summarize M_DATA_LATCH_TRIGGER_SOURCE +

Sets what triggers storing the specified information to the specified data latch. Use M_DATA_LATCH_TYPE to specify the type of information to store. INQ


You must specify a combination value from the following table:
(summarize)
‡ p q r
Click to summarize M_DEFAULT

Same as M_GRAB_FRAME_END.

 ‡ p q r
Click to summarize M_AUX_IOn

Specifies to use auxiliary signal n as the trigger source, where n is the auxiliary signal number. Note that the specified auxiliary signal can also be a bidirectional signal set to input (using M_IO_MODE set to M_INPUT).

For a list of the available auxiliary I/O signals, see the Connectors and signal names section of the MIL Hardware-specific Notes chapter for your Matrox imaging board or MIL driver.

To specify the signal transition, use M_DATA_LATCH_TRIGGER_ACTIVATION.

(summarize)
‡ p q r
Click to summarize M_GRAB_FRAME_END

Specifies to trigger the data latch on the event that occurs at the end of each grabbed frame; this event occurs when the frame grabber receives the last pixels (or packet) of a frame from the camera. Note that, in this case, the grabbed data might not be completely transferred to the Host.

(summarize)
‡ p q r
Click to summarize M_GRAB_FRAME_START

Specifies to trigger the data latch on the event that occurs at the start of each grabbed frame.

 ‡ p q r
Click to summarize M_GRAB_LINE

Specifies to trigger the data latch on the event that occurs at the end of each grabbed line; this event occurs when the frame grabber receives the last pixels (or packet) of a line from the camera. Note that, in this case, the grabbed data might not be completely transferred to the Host.

(summarize)
‡ p q r
Click to summarize M_ROTARY_ENCODERn

Specifies to use rotary decoder n as the trigger source, where n is the rotary decoder number.

To configure the rotary decoder, use the M_ROTARY_ENCODER... control types. To establish when the rotary decoder issues a trigger, use M_ROTARY_ENCODER_POSITION_TRIGGER.

(summarize)
‡ p q r
Click to summarize M_TIMER_ACTIVE +

Specifies to trigger the data latch on the event that occurs when the specified timer is active. This can be at the start of the active period or the end of the active period, depending on how you set M_DATA_LATCH_TRIGGER_ACTIVATION.


You must specify a combination value from the following table:
(summarize)
‡ p q r
Click to summarize M_DATA_LATCH_TYPE +

Sets the type of information to store in the specified data latch. Note that each type of information can only be associated with one data latch, except for timestamp, which can be associated with up to four data latches. MIL returns an error when this limitation is not respected. INQ


You must specify a combination value from the following table:
(summarize)
‡ p q r
Click to summarize M_IO_STATUS_ALL

Stores the status of all the auxiliary I/O signals.

 ‡ p q r
Click to summarize M_ROTARY_ENCODERn

Stores the value of the counter of rotary decoder n, where n is a number between 1 and 4. To configure the rotary decoder, use the M_ROTARY_ENCODER... control types.

(summarize)
‡ p q r
Click to summarize M_TIME_STAMP

Stores the timestamp upon which the data latch is triggered, in ticks. Up to four separate data latches can store a timestamp.

To convert a timestamp from clock ticks to seconds, use the following equation: Timestamp * ( TimestampFrequencyInHz). To inquire the clock frequency, use MdigInquire() with M_DATA_LATCH_CLOCK_FREQUENCY.

(summarize)
‡ p q r
Combination value for the values listed in For controlling a data latch.

You must add the following value to the above-mentioned values to specify which data latch to affect.

function map For specifying the data latch to affect
Click to summarize
Combination value		 Description MIL system-specific
tooltip (‡)
Click to summarize M_LATCHn

Specifies which data latch to affect, where n is a value from 0 to 15.

 ‡ p q r
Combination values for M_TIMER_ACTIVE (when ControlType=M_DATA_LATCH_TRIGGER_SOURCE and ControlValue=M_TIMER_ACTIVE); M_TIMER_CLOCK_SOURCE; M_TIMER_DELAY; M_TIMER_DURATION; M_TIMER_OUTPUT_INVERTER; M_TIMER_STATE; M_TIMER_TRIGGER_ACTIVATION; M_TIMER_TRIGGER_MISSED; M_TIMER_TRIGGER_RATE_DIVIDER; M_TIMER_TRIGGER_SOFTWARE; M_TIMER_TRIGGER_SOURCE.

You must add one of the following values to the above-mentioned values to specify which on-board timer to control.

function map For specifying which on-board timer to control
Click to summarize
Combination value		 Description MIL system-specific
tooltip (‡)
Click to summarize M_TIMER_STROBE

Specifies the strobe timer.

 ‡ t
Click to summarize M_TIMERn

Specifies on-board timer n, where n is one of the timers available on your Matrox imaging board or the hardware associated with your MIL driver.

Note that, when dealing with timers (excluding M_DATA_LATCH_TRIGGER_SOURCE with M_TIMER_ACTIVE) only a continuous timer can clock another timer. In addition, references where timer 1 points to timer 2, and timer 2 points back to timer 1, are not supported and will generate an error.

(summarize)
‡ c e f j k l m o p q r s
MIL system specific

With Matrox Solios eA/XA, n can be a value from 1 to 2.

 ‡ l

With Matrox Iris GT, n must be set to 2.

 ‡ f

With the Matrox Radient family of boards, n can be a value from 1 to 4.

 ‡ j k m p q r

With a GenICam SFNC-compliant camera, n can be a value from 0 to 8.

 ‡ c o s
Type specific versions of the function when using a C compiler under 64-bit
void MdigControlDouble (MIL_ID DigId, MIL_INT64 ControlType, MIL_DOUBLE ControlValue)
Details
Parameters

DigId

See DigId of the main function for a description.

ControlType

See ControlType of the main function for a description.

ControlValue

See ControlValue of the main function for a description.
void MdigControlInt64 (MIL_ID DigId, MIL_INT64 ControlType, MIL_INT64 ControlValue)
Details
Parameters

DigId

See DigId of the main function for a description.

ControlType

See ControlType of the main function for a description.

ControlValue

See ControlValue of the main function for a description.
Compilation information
Header Include mil.h.
Library Use mil.lib.
DLL Requires mil.dll.
BAYER COEFFICIENTS ID DEFAULT FLOAT BAYER CONVERSION DEFAULT DISABLE ENABLE CAMERA COLOR LOCK DEFAULT DISABLE ENABLE CAMERA LOCK DEFAULT DISABLE ENABLE CAMERA LOCK SENSITIVITY DEFAULT CAMERA UNLOCK SENSITIVITY DEFAULT CAPTURE QUALITY DEFAULT OFF ON CAPTURE SIZE DEFAULT OFF ON CHANNEL DEFAULT CH0 CH1 CH2 CH3 CH4 CH5 CH6 CH7 CH8 CH9 CH10 CH11 CH12 CH13 CH14 CH15 COMMAND QUEUE MODE DEFAULT IMMEDIATE QUEUED CORRUPTED FRAME ERROR DEFAULT DISABLE ENABLE DIGITIZER INTERNAL BUFFERS NUM DEFAULT FIX PATTERN NOISE CORRECTION DEFAULT PREPROCESSING SENSOR FOCUS DEFAULT OFF ON GAMMA DEFAULT OFF ON GC CLPROTOCOL DEFAULT DISABLE ENABLE GC CLPROTOCOL DEVICE ID DEFAULT" GC FEATURE BROWSER DEFAULT CLOSE OPEN GC FEATURE POLLING DEFAULT DISABLE ENABLE GC FRAME MAX RETRIES DEFAULT GC PACKET MAX RETRIES GC FRAME TIMEOUT DEFAULT GC HEARTBEAT STATE DEFAULT DISABLE ENABLE GC HEARTBEAT TIMEOUT DEFAULT GC INTER PACKET DELAY GC MAX NBR PACKETS OUT OF ORDER DEFAULT GC MESSAGE CHANNEL MULTICAST ADDRESS STRING GC MESSAGE PORT GC PACKET MAX RETRIES DEFAULT GC FRAME MAX RETRIES GC PACKET RESEND DISABLE ENABLE GC PACKET SIZE GC PACKET TIMEOUT DEFAULT GC PIXEL FORMAT DEFAULT GC PIXEL FORMAT SWITCHING DEFAULT DISABLE ENABLE GC STATISTICS RESET DEFAULT GC STREAM CHANNEL MULTICAST ADDRESS STRING GC STREAM PORT GC STREAMING MODE DEFAULT AUTOMATIC MANUAL GC STREAMING START DEFAULT GC STREAMING STOP DEFAULT GC STREAMING STOP CHECK PERIOD DEFAULT GC STREAMING STOP DELAY DEFAULT GC UPDATE MULTICAST INFO DEFAULT GC USER NAME GRAB ABORT DEFAULT GRAB DIRECTION X DEFAULT FORWARD REVERSE GRAB DIRECTION Y DEFAULT FORWARD REVERSE GRAB FAIL CHECK DEFAULT DISABLE ENABLE FINAL GRAB GRAB FAIL RETRY NUMBER DEFAULT GRAB FIELD NUM DEFAULT GRAB FRAME MISSED COUNTER DEFAULT DISABLE ENABLE GRAB FRAME MISSED RESET DEFAULT GRAB LINE COUNTER DEFAULT DISABLE ENABLE GRAB LUT PALETTE DEFAULT GAMMA GRAB MODE DEFAULT ASYNCHRONOUS ASYNCHRONOUS QUEUED SYNCHRONOUS GRAB SCALE DEFAULT FILL DESTINATION GRAB SCALE INTERPOLATION MODE DEFAULT AUTOMATIC AVERAGE BICUBIC BILINEAR NEAREST NEIGHBOR GRAB SCALE X DEFAULT FILL DESTINATION GRAB SCALE Y FILL DESTINATION GRAB START MODE DEFAULT FIELD START FIELD START EVEN FIELD START ODD GRAB TIMEOUT DEFAULT INFINITE HARDWARE DEINTERLACING DEFAULT BOB METHOD DISABLE MADI METHOD INPUT FILTER DEFAULT AUTOMATIC BYPASS LOW PASS 0 LOW PASS 1 IRIS DEFAULT OFF ON LAST GRAB IN TRUE BUFFER DEFAULT DISABLE ENABLE LIGHTING BRIGHT FIELD DEFAULT LIGHTING BRIGHT FIELD HIDRIVE DEFAULT DISABLE ENABLE LIGHTING BRIGHT FIELD HIDRIVE TIME LIGHTING BRIGHT FIELD OFFSET DEFAULT DISABLE ENABLE LUT ID DEFAULT OPTICAL FILTER DEFAULT OFF ON PAN DEFAULT OFF ON POWER OVER CABLE DEFAULT OFF ON PROCESS GRAB MONITOR DEFAULT DISABLE ENABLE PROCESS TIMEOUT DEFAULT INFINITE SELECTED FRAME RATE DEFAULT SHADING CORRECTION DISABLE ENABLE SHADING CORRECTION GAIN ID SHADING CORRECTION OFFSET ID SHARPNESS DEFAULT OFF ON SOURCE COMPENSATION DEFAULT DISABLE ENABLE SOURCE OFFSET X SOURCE OFFSET Y SOURCE SIZE X SOURCE SIZE Y TARGET TEMPERATURE DEFAULT OFF ON TILT DEFAULT OFF ON VIDEO OUTPUT NULL CHn WHITE BALANCE CALCULATE DISABLE ENABLE WHITE BALANCE U DEFAULT OFF ON WHITE BALANCE V DEFAULT OFF ON ZOOM DEFAULT OFF ON WAIT FAST CHn ASYNCHRONOUS SYNCHRONOUS ANTIALIASING DITHERING BLACK OFFSET BLACK REF DEFAULT AUTOMATIC MAX LEVEL MIN LEVEL MIN LEVEL <= Value <= M MAX LEVEL BRIGHTNESS DEFAULT OFF ON BRIGHTNESS REF DEFAULT MAX LEVEL MIN LEVEL MIN LEVEL <= Value <= M MAX LEVEL CONTRAST REF DEFAULT MAX LEVEL MIN LEVEL MIN LEVEL <= Value <= M MAX LEVEL HUE DEFAULT OFF ON HUE REF DEFAULT MAX LEVEL MIN LEVEL MIN LEVEL <= Value <= M MAX LEVEL SATURATION DEFAULT OFF ON SATURATION REF DEFAULT MAX LEVEL MIN LEVEL MIN LEVEL <= Value <= M MAX LEVEL WHITE REF DEFAULT AUTOMATIC MAX LEVEL MIN LEVEL MIN LEVEL <= Value <= M MAX LEVEL ALL REF CH0 REF CH1 REF CH2 REF CH3 REF VOLTAGE GAIN DEFAULT OFF ON GRAB AUTOMATIC INPUT GAIN DEFAULT DISABLE ENABLE GRAB INPUT GAIN DEFAULT GAIN0 GAIN1 GAIN2 GAIN3 MAX LEVEL MIN LEVEL ALL CHANNELS CHn CHROMINANCE LUMINANCE IO FORMAT DEFAULT DISABLE LVDS OPEN DRAIN OPTO RS422 TRI STATE TTL IO INTERRUPT ACTIVATION DEFAULT ANY EDGE EDGE FALLING EDGE RISING IO INTERRUPT STATE DEFAULT DISABLE ENABLE IO MODE DEFAULT INPUT OUTPUT IO SOURCE DEFAULT AUX IOn DISABLE HSYNC PIXCLK TIMERn TL TRIGGER USER BIT CC IOn USER BIT TL TRIGGER USER BITn VSYNC AUX IOn CC IOn TL TRIGGER USER BIT STATE OFF ON USER BIT STATE ALL USER BIT CC IOn USER BIT TL TRIGGER0 USER BITn USER BIT USER BIT CC IO USER BIT TL TRIGGER GRAB CONTINUOUS END TRIGGER DEFAULT DISABLE ENABLE GRAB TRIGGER ACTIVATION DEFAULT ANY EDGE EDGE FALLING EDGE RISING LEVEL HIGH LEVEL LOW GRAB TRIGGER DELAY GRAB TRIGGER MISSED DISABLE ENABLE GRAB TRIGGER OVERLAP DEFAULT DISABLE ENABLE GRAB TRIGGER SOFTWARE ACTIVATE GRAB TRIGGER SOURCE DEFAULT AUX IOn HSYNC IO COMMAND LIST1 ROTARY ENCODER ROTARY ENCODERn SOFTWARE SOFTWAREn TIMERn TL TRIGGER VSYNC GRAB TRIGGER STATE DEFAULT DISABLE ENABLE OFF ON IO COMMAND BITn TIMER CLOCK SOURCE DEFAULT HSYNC PIXCLK SYSCLK TIMERn VSYNC TIMER DELAY DEFAULT TIMER DURATION DEFAULT INFINITE TIMER OUTPUT INVERTER DEFAULT DISABLE ENABLE TIMER STATE DEFAULT DISABLE ENABLE TIMER TRIGGER ACTIVATION DEFAULT ANY EDGE EDGE FALLING EDGE RISING LEVEL HIGH LEVEL LOW TIMER TRIGGER MISSED DEFAULT DISABLE ENABLE TIMER TRIGGER RATE DIVIDER DEFAULT TIMER TRIGGER SOFTWARE ACTIVATE TIMER TRIGGER SOURCE DEFAULT NULL AUX IOn CONTINUOUS EXPOSURE END EXPOSURE START GRAB TRIGGER HSYNC ROTARY ENCODER ROTARY ENCODERn SOFTWARE TIMERn TL TRIGGER VSYNC AUTO EXPOSURE DEFAULT AUTOMATIC DISABLE ENABLE OFF ON EXPOSURE DELAY DEFAULT EXPOSURE MODE TIMED TRIGGER WIDTH EXPOSURE TIME DEFAULT SHUTTER DEFAULT OFF ON MODE CONTROL BOARD CAMERA ROTARY ENCODER BIT0 SOURCE DEFAULT AUX IOn ROTARY ENCODER BIT1 SOURCE DEFAULT AUX IOn ROTARY ENCODER DIRECTION DEFAULT BACKWARD FORWARD ROTARY ENCODER FORCE VALUE SOURCE DEFAULT NULL AUX IOn COUNTER OVERFLOW POSITION TRIGGER STEP BACKWARD WHILE POSITIVE TL TRIGGER ROTARY ENCODER FRAME END READ DEFAULT DISABLE ENABLE ROTARY ENCODER MULTIPLIER DEFAULT ROTARY ENCODER OUTPUT MODE DEFAULT POSITION TRIGGER STEP ANY STEP ANY WHILE POSITIVE STEP FORWARD STEP FORWARD WHILE POSITIVE ROTARY ENCODER POSITION ROTARY ENCODER POSITION TRIGGER ROTARY ENCODER RESET SOURCE DEFAULT NULL AUX IOn POSITION TRIGGER TL TRIGGER ROTARY ENCODERn DATA LATCH MODE DEFAULT NORMAL PREFETCH DATA LATCH STATE DEFAULT DISABLE ENABLE DATA LATCH TRIGGER ACTIVATION DEFAULT EDGE FALLING EDGE RISING DATA LATCH TRIGGER SOURCE DEFAULT AUX IOn GRAB FRAME END GRAB FRAME START GRAB LINE ROTARY ENCODERn TIMER ACTIVE DATA LATCH TYPE IO STATUS ALL ROTARY ENCODERn TIME STAMP LATCHn TIMER STROBE TIMERn M_CHn M_CHn M_CHn M_AUX_IOn M_TIMERn M_USER_BIT_CC_IOn M_USER_BITn M_AUX_IOn M_CC_IOn M_USER_BIT_CC_IOn M_USER_BITn M_AUX_IOn M_ROTARY_ENCODERn M_SOFTWAREn M_TIMERn M_IO_COMMAND_BITn M_TIMERn M_AUX_IOn M_ROTARY_ENCODERn M_TIMERn M_AUX_IOn M_AUX_IOn M_AUX_IOn M_AUX_IOn M_ROTARY_ENCODERn M_AUX_IOn M_ROTARY_ENCODERn M_ROTARY_ENCODERn M_LATCHn M_TIMERn