| MIL 10 Reference
| Customize Help
| Save Settings

MdigInquire


See also
Availability
Available in MIL-Lite
Available in MIL

Available on Windows
Available on Linux

Not supported on:
Not supported on Matrox GPU processing driver
Partially supported on:
Partially supported on Host system
Partially supported on Matrox CronosPlus
Partially supported on Matrox GigE Vision driver
Partially supported on Matrox IEEE 1394 IIDC driver
Partially supported on Matrox Iris GT
Partially supported on Matrox Morphis
Partially supported on Matrox Morphis QxT
Partially supported on Matrox Orion HD
Partially supported on Matrox Radient eCL
Partially supported on Matrox Radient eV-CXP
Partially supported on Matrox Solios eA/XA
Partially supported on Matrox Solios ecl/xcl/ev-cl
Partially supported on Matrox USB3 Vision driver (requires Update 19)
Partially supported on Matrox Vio

For any information regarding a MIL system added during a MIL Update, see the MIL system’s release note

Available on Non-Matrox computer
Available on Matrox 4Sight-X
Available on Matrox 4Sight GP
Available on Matrox Supersight
function map Function map
Function Map
Syntax
Description
Parameters
- DigId
- InquireType
- UserVarPtr
Parameter Associations
Table: For the general digitizer settings
+ combination: For specifying the speed and precision of the interpolation
+ combination: For specifying the acquisition path
+ combination: For inquiring additional allocation details
+ combination: For specifying the multicast master-slave relationship
+ combination: Returns the format of the planar color buffer
+ combination: Returns the format of the packed color buffer
+ combination: For specifying which Camera Link camera to inquire
+ combination: For specifying whether anti-aliasing and/or dithering is enabled
Table: For the general reference settings
+ combination: For specifying which acquisition path is inquired
+ combination: For specifying the black and white reference level in Volts
Table: For inquiring the input gain
+ combination: For specifying the specific video signal component to apply the input-gain setting
Table: For inquiring I/O signals and their mode
+ combination: For specifying the type and number of the I/O signal to inquire
+ combination: For specifying the type of I/O signal to inquire
Table: For inquiring the state of specified user-bits in a static-user-output register
+ combination: For inquiring the bit in the static-user-output register
+ combination: For inquiring the static-user-output register type to inquire
Table: For inquiring the settings to grab using a trigger
+ combination: For specifying whether an IIDC camera specific feature can turned on or off
Table: For inquiring the settings of a timer
+ combination: For determining the largest or smallest values supported
+ combination: For specifying which on-board timer to inquire
Table: For inquiring the camera's exposure
+ combination: For specifying whether the inquire type relates to the card or the board
Table: For inquiring the settings of a rotary decoder
+ combination: For specifying which rotary decoder to inquire
Return value
Compilation information
Examples
MdigHookFunction
MdigInquireFeature
Synopsis
Inquire about a digitizer setting.
Syntax
MIL_INT MdigInquire(
MIL_ID DigId, //in
MIL_INT64 InquireType, //in
void *UserVarPtr //out
)
Description

This function allows you to inquire about various digitizer settings.

Note that you can use MdigControl() to control specific digitizer settings.

You can also interactively inquire most of the digitizer settings in real-time, using Matrox Intellicam's Feature Browser.

[Matrox IEEE 1394 IIDC driver]

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

In addition, the inquire 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 inquire 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 MdigInquireFeature().

Note that there are several inquire types that are available on a Host system, even without any additional Matrox imaging boards; these are to inquire a simulated digitizer (allocated using MdigAlloc() with M_EMULATED). To see the inquire types available to inquire 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 23: Grabbing with your digitizer.

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.

InquireType

Specifies the digitizer setting to inquire.

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

UserVarPtr
Accepts the address of one of the following (see the Parameter associations section for specifics on which is expected):
  • array of type MIL_TEXT_CHAR
  • array of type MIL_TEXT_PTR
  • MIL_DOUBLE
  • MIL_ID
  • MIL_INT
  • MIL_INT64
  • MIL_TEXT_PTR

Specifies the address in which to write the requested information. When the requested information is not an array of type MIL_TEXT_CHAR, the function will also return the requested information; so, you can set this parameter to M_NULL and just use the return value.

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

Parameter associations

The tables below list possible values for the InquireType parameter and possible values returned to the UserVarPtr parameter.

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

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_INT.

function map For the general digitizer settings
CollapseInquireType Description
MIL system-specific
tooltip (†)
UserVarPtr
- Possible values returned
Collapse M_BAYER_COEFFICIENTS_ID

Inquires a MIL identifier of the internal buffer containing the white balance coefficients used when grabbing from a camera with a Bayer color filter. Note that you cannot free the retrieved buffer. SET

(summarize)
† c f k m o q s
MIL system specific

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

 † k m q

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

 † c o s

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

 † m

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

 † f
Collapse UserVarPtr data type info

Data type: MIL_ID

† c f k m o q s
Collapse M_NULL

Specifies that you have set M_WHITE_BALANCE to M_DISABLE.

 † c f k m o q s
Collapse MIL array buffer identifier

Specifies the identifier of an internally allocated M_ARRAY buffer containing the white balance coefficients.

 † c f k m o q s
Collapse M_BAYER_CONVERSION

Inquires whether a Bayer color conversion is performed by your digitizer. SET

(summarize)
† c f k m o q s
MIL system specific

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

 † k m q

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

 † c o s

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

 † m

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

 † f
Collapse M_DISABLE

Specifies to not perform Bayer conversion on the grabbed image.

 † c f k m o q s
Collapse M_ENABLE

Specifies to perform Bayer conversion on the grabbed image. INFO

 † c f k m o q s
Collapse M_BAYER_PATTERN

Inquires the Bayer pattern used by the camera. SET

(summarize)
† c e f k m o q s
MIL system specific

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

 † k m q

Refer to your camera's hardware manual for more details.

 † c o s

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

 † m

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

 † f

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

 † e
Collapse M_NULL

Specifies that no Bayer pattern is used by the camera.

 † c e f k m o q s
Collapse M_BAYER_BG

Specifies the Bayer pattern that has the top-left pixel as the blue component and the next pixel as the green component. INFO

 † c e f k m o q s
Collapse M_BAYER_GB

Specifies the Bayer pattern that has the top-left pixel as the green component and the next pixel as the blue component. INFO

 † c e f k m o q s
Collapse M_BAYER_GR

Specifies the Bayer pattern that has the top-left pixel as the green component and the next pixel as the red component. INFO

 † c e f k m o q s
Collapse M_BAYER_RG

Specifies the Bayer pattern that has the top-left pixel as the red component and the next pixel as the green component. INFO

 † c e f k m o q s
Collapse M_BOARD_REVISION

Inquires the revision number of your digitizer.

(summarize)
† f
Collapse Value

Specifies the revision number.

 † f
Collapse M_CAMERA_COLOR_LOCK

Inquires whether a color-lock check is done before starting each grab. Note that this is only applicable when the digitizer uses a composite or Y/C color DCF. To establish if the camera lock was successful use M_CAMERA_LOCK. SET

(summarize)
† b g
Collapse M_DISABLE

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

 † b g
Collapse M_ENABLE

Specifies that a color-lock check will be done.

 † b g
Collapse M_CAMERA_COLOR_LOCKED

Inquires whether a color-lock is currently active. Note that this is only applicable when the digitizer uses a composite or Y/C color DCF.

(summarize)
† b g h n
Collapse M_NO

Specifies that color-lock is not active.

 † b g h n
Collapse M_YES

Specifies that color-lock is active.

 † b g h n
Collapse M_CAMERA_LOCK

Inquires whether to check if the camera is locked with the digitizer after channel-switching. SET

(summarize)
† b g l n
Collapse M_DISABLE

Specifies that the grab operation (such as, MdigGrab()) grabs without verifying whether the digitizer is locked with the camera. INFO

 † b g l n
Collapse 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
Collapse M_CAMERA_LOCK_SENSITIVITY

Inquires how sensitive the digitizer is to locking with the next camera, during a channel switch when M_CAMERA_LOCK is enabled. SET

(summarize)
† g n
Collapse 0 <= Value <= 511

Specifies the camera line-lock sensitivity level. INFO

 † g n
Collapse M_CAMERA_LOCKED

Inquires whether the digitizer is locked to the camera.

(summarize)
† a b g h i l n
Collapse M_NO

Specifies that a camera lock failed.

 † a b g h i l n
Collapse M_YES

Specifies that a camera lock succeeded.

 † a b g h i l n
Collapse M_CAMERA_MODEL

Inquires the name of the camera model.

(summarize)
† c e o s
MIL system specific

Note that this inquire type is IIDC camera specific. The camera must support the MODEL_NAME_LEAF IIDC standard feature for this inquire type to be available on the camera.

 † e
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_CHAR
Array size: Determine by calling MdigInquire() with M_CAMERA_MODEL_SIZE

† c e o s
Collapse Value

Specifies the name of the camera model.

 † c e o s
Collapse M_CAMERA_MODEL_SIZE

Inquires the maximum number of characters in the string returned by M_CAMERA_MODEL.

(summarize)
† c e o s
MIL system specific

Note that this inquire type is IIDC camera specific. The camera must support the MODEL_NAME_LEAF IIDC standard feature for this inquire type to be available on the camera.

 † e
Collapse Value

Specifies the number of characters the name of the camera model.

 † c e o s
Collapse M_CAMERA_PRESENT

Inquires whether a camera is present. Note that this does not indicate that a camera is locked.

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse M_NO

Specifies that no camera is present.

 † a b c e g h i j k l m n o p q r s
Collapse M_YES

Specifies that a camera is present.

 † a b c e f g h i j k l m n o p q r s
Collapse M_CAMERA_UNLOCK_SENSITIVITY

Inquires the sensitivity of the frame grabber to unlocking from the camera, during a channel switch. Note that M_CAMERA_LOCK must be enabled for this to have an effect. The unlock sensitivity determines how quickly an unlock can occur and how reliable the unlock is. SET

(summarize)
† g
Collapse 0 <= Value <= 255

Specifies the camera line-unlock sensitivity level. INFO

 † g
Collapse M_CAMERA_VENDOR

Inquires the name of the camera vendor.

(summarize)
† c e o s
MIL system specific

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

 † e
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_CHAR
Array size: Determine by calling MdigInquire() with M_CAMERA_VENDOR_SIZE

† c e o s
Collapse "String"

Specifies the name of the camera vendor.

 † c e o s
Collapse M_CAMERA_VENDOR_SIZE

Inquires the number of characters in the string returned by M_CAMERA_VENDOR.

(summarize)
† c e o s
MIL system specific

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

 † e
Collapse Value

Specifies the number of characters in the name of the camera vendor.

 † c e o s
Collapse M_CAPTURE_QUALITY +

Inquires the capture quality of the image.

Note that this inquire type is IIDC camera specific. The camera must support the CAPTURE_QUALITY_INQ IIDC standard feature for this inquire type to be supported. SET

(summarize)
† e
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e
Collapse Min. quality <= Value <= Max. quality

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

 † e
Collapse M_CAPTURE_SIZE +

Inquires the capture size of the image.

Note that this inquire type is IIDC camera specific. The camera must support the CAPTURE_SIZE_INQ IIDC standard feature for this inquire type to be supported. SET

(summarize)
† e
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e
Collapse Min. size <= Value <= Max. size

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

 † e
Collapse M_CHANNEL

Inquires the channel on which the digitizer is to acquire data.

Note that typically, this inquire type is only available when the specified digitizer uses acquisition paths with several multiplexed data inputs. SET

(summarize)
† b e g i l n
Collapse UserVarPtr data type info

Data type: MIL_INT64

† b e g i l n
Collapse M_CH0

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

 † b e g i l n
Collapse M_CH1

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

 † b g i l n
Collapse M_CH2

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

 † b g i
Collapse M_CH3

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

 † b g
Collapse M_CH4

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

 † g
Collapse M_CH5

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

 † g
Collapse M_CH6

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

 † g
Collapse M_CH7

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

 † g
Collapse M_CH8

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

 † g
Collapse M_CH9

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

 † g
Collapse M_CH10

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

 † g
Collapse M_CH11

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

 † g
Collapse M_CH12

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

 † g
Collapse M_CH13

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

 † g
Collapse M_CH14

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

 † g
Collapse M_CH15

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

 † g
Collapse M_CHANNEL_NUM

Inquires the number of available channels on the digitizer.

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse Value

Specifies the number of channels.

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

Matrox Iris GT has 1 channel.

 † f
Collapse M_CHANNEL_SYNC

Inquires the channel currently being used as a synchronization channel instead of a data channel. Note that using a digitizer as an external synchronization signal renders the digitizer of that signal "occupied" and not available for allocating as a digitizer.

(summarize)
† b c e g h i l n o s
Collapse UserVarPtr data type info

Data type: MIL_INT64

† b c e g h i l n o s
Collapse M_CHn

Specifies the channel used for synchronization, where n is the channel number.

 † b c e g h i l n o s
Collapse M_COMMAND_QUEUE_MODE

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

(summarize)
† j k l m n p q r
Collapse 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. INFO

 † j k l m n p q r
Collapse 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. INFO

 † j k l m n p q r
Collapse M_CORRUPTED_FRAME_ERROR

Inquires whether an error is generated when a corrupted or incomplete frame is grabbed. SET

(summarize)
† c f i o s
Collapse M_DISABLE

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

 † c f i o s
Collapse M_ENABLE

Specifies to generate an error when grabbing a corrupted frame.

 † c f i o s
Collapse M_DIG_PROCESS_IN_PROGRESS

Inquires whether MdigProcess() is currently running.

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse M_FALSE

MdigProcess() is not running.

 † a b c e f g h i j k l m n o p q r s
Collapse M_TRUE

MdigProcess() is running.

 † a b c e f g h i j k l m n o p q r s
Collapse M_DIGITIZER_INTERNAL_BUFFERS_NUM

Inquires the number of internal grab buffers allocated and used when MIL cannot grab directly into the specified buffers. SET

(summarize)
† c o s
Collapse Value >= 0

Specifies the number of internal grab buffers.

 † c o s
Collapse M_DIGITIZER_TYPE

Inquires the type of frame grabber(s) available to allocate a digitizer on the system.

The type of frame grabber is established by the type of sensor, so this inquire type returns the type of sensor.

(summarize)
† f
Collapse M_IRIS + M_GT300

Specifies Matrox Iris GT300.

 † f
Collapse M_IRIS + M_GT1200

Specifies Matrox Iris GT1200.

 † f
Collapse M_IRIS + M_GT1900

Specifies Matrox Iris GT1900.

 † f
Collapse M_IRIS + M_GT5000

Specifies Matrox Iris GT5000.

 † f
Collapse M_EFFECTIVE_SIZE_BIT

Inquires the effective depth per band.

Note that when dealing with camera formats that use more than 8 bits, this value can be an even number between 10 and 16, inclusively.

Note that this inquire type inquires the effective depth of the pixels retrieved by your board.

(summarize)
† e
Collapse Value

Specifies the effective depth per band, in bits.

 † e
Collapse M_EXTENDED_INIT_FLAG

Inquires the digitizer initialization flag. SET

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse UserVarPtr data type info

Data type: MIL_INT64

† a b c e f g h i j k l m n o p q r s
Collapse M_DEFAULT

Specifies the default value. INFO

 † a b c e f g h i j k l m n o p q r s
Collapse M_DEV_NUMBER +

Specifies that the digitizer was allocated for the camera with the specified device number. INFO

 † c o s
Collapse M_EMULATED

Specifies that the digitizer was allocated as a simulated digitizer.

 † a
Collapse M_GC_DEVICE_IP_ADDRESS +

Specifies that the digitizer was allocated for the camera at the specified IP address. INFO

 † c s
Collapse M_GC_DEVICE_USER_NAME +

Specifies that the digitizer was allocated for the camera with the specified device's user name. INFO

 † c o s
Collapse M_MINIMAL

Specifies that grabbing is not permitted with the allocated digitizer. INFO

 † i
Collapse M_FOCUS +

Inquires the lens focus capabilities.

Note that this inquire type is IIDC camera specific. The camera must support the FOCUS_INQ IIDC standard feature for this inquire type to be available on the camera. SET

(summarize)
† e
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e
Collapse Min. focus <= Value <= Max. focus

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

 † e
Collapse M_FORMAT

Inquires the digitizer data format. SET

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_CHAR
Array size: M_FORMAT_SIZE

† a b c e f g h i j k l m n o p q r s
Collapse M_NULL
//For monochrome or color cameras.

Specifies the data format is set by the digitizer allocated as the multicast master. INFO

 † c s
Collapse MIL_TEXT("DCF File name") 1
//For monochrome or color cameras.

Specifies the path and file name of the DCF (for example: "C:\mydirectory\myfile"). INFO

 † b c f g h i j k l m n o p q r s
Collapse MIL_TEXT("Image path[@n]") 1
//For monochrome or color cameras.

Specifies the path of the directory from which to retrieve image files (or an AVI file) when allocating a simulated digitizer (for example, "C:\mydirectory\"), where n is the frame rate; the information in brackets is optional (for example, "C:\mydirectory\@30". INFO

 † a
Collapse MIL_TEXT("M_CCIR") 1
//For monochrome cameras.

Specifies a DCF for a CCIR, 768x576, 14.75 MHz, analog camera.

 † b g h l n
Collapse MIL_TEXT("M_DEFAULT") 1
//For monochrome or color cameras.

Specifies the default digitizer format. INFO

 † a b c e f g h i j k l m n o p q r s
Collapse MIL_TEXT("M_DEFAULT_1394") 1
//For monochrome or color cameras.

Specifies the format with the largest image dimensions possible with the highest available frame rate for the connected IEEE 1394-compliant camera. INFO

 † e
Collapse MIL_TEXT("M_NTSC") 1
//For color cameras.

Specifies a DCF for a composite NTSC 640x480, 12.27 MHz camera. INFO

 † b e g h n
Collapse MIL_TEXT("M_NTSC_RGB") 1
//For color cameras.

Specifies a DCF for a component RGB, 640x480, 12.27 MHz camera. INFO

 † l n
Collapse MIL_TEXT("M_NTSC_YC") 1
//For color cameras.

Specifies a DCF for a component NTSC Y/C (SVHS), 640x480, 12.27 MHz camera.

 † b g n
Collapse MIL_TEXT("M_PAL") 1
//For color cameras.

Specifies a DCF for a composite PAL 768x576, 14.75 MHz camera.

 † b g h n
Collapse MIL_TEXT("M_PAL_RGB") 1
//For color cameras.

Specifies a DCF for a component RGB, 768x576, 14.75 MHz camera. INFO

 † l n
Collapse MIL_TEXT("M_PAL_YC") 1
//For color cameras.

Specifies a DCF for a PAL Y/C, 768x576, 14.75 MHz camera.

 † b g n
Collapse MIL_TEXT("M_RS170") 1
//For monochrome cameras.

Specifies a DCF for an RS-170, 640x480, 12.27 MHz, analog camera. INFO

 † b e g h l n
Collapse MIL_TEXT("M_xXy_data_FORMAT_7_z") 1
//For monochrome or color cameras.

Specifies the string format for format 7 cameras, where x is SizeX in pixels, y is SizeY in pixels, data_FORMAT_7 is the image data format (for example, YUV, RGB...), and z is the format 7 mode (for example, "M_640X480_YUV411_FORMAT_7_1", "M_320X240_YUV422_FORMAT_7_2", and "M_1024X768_YUV_FORMAT_7_0" are accepted strings from one type of camera). INFO

 † e
Collapse MIL_TEXT("M_xXy_data[@z[FPS]]") 1
//For monochrome or color cameras.

Specifies the string format, where x is SizeX in pixels, y is SizeY in pixels, data is the image data format (for example, YUV, RGB...), and z is the frame rate; the information in brackets is optional (for example, "M_640X480_YUV411@30FPS", "M_320x240_YUV422@7.5", and "M_1024X768_YUV" are accepted strings from one type of camera).

 † e
Collapse MIL_TEXT("SDCF File name") 1
//For monochrome or color cameras.

Specifies the path and file name of the simulated DCF for use with a simulated digitizer (for example: "C:\mydirectory\myfile"). INFO

 † a
Collapse M_FORMAT7_TILE_SIZE_X

Inquires the horizontal tile size.

Note that this inquire type is IIDC camera specific. The camera must support the UNIT_SIZE_INQ IIDC standard feature for this inquire type to be available on the camera.

(summarize)
† e
Collapse Value

Specifies the horizontal tile size.

 † e
Collapse M_FORMAT7_TILE_SIZE_Y

Inquires the vertical tile size.

Note that this inquire type is IIDC camera specific. The camera must support the UNIT_SIZE_INQ IIDC standard feature for this inquire type to be available on the camera.

(summarize)
† e
Collapse Value

Specifies the vertical tile size.

 † e
Collapse M_FORMAT_DETECTED

Inquires the detected DCF name.

(summarize)
† i
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_CHAR
Array size: Determine by calling MdigInquire() with M_FORMAT_DETECTED_SIZE

† i
Collapse Value

Specifies the detected DCF name.

 † i
Collapse M_FORMAT_DETECTED_SIZE

Inquires the number of characters in the string returned by M_FORMAT_DETECTED.

(summarize)
† i
Collapse Value

Specifies the number of characters in the DCF name.

 † i
Collapse M_FORMAT_SIZE

Inquires the number of characters in the string returned by M_FORMAT.

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse Value

Specifies the number of characters.

 † a b c e f g h i j k l m n o p q r s
Collapse M_FORMAT_SUPPORTED

Inquires the names of all supported formats that can be accepted by MdigAlloc() for your 1394 DCS-compliant digital camera. SET

(summarize)
† e
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_CHAR
Array size: To determine the number of formats supported, call MdigInquire()M_FORMAT_SUPPORTED_NUM. To determine the longest string required to store the formats supported, call MdigInquire() with M_FORMAT_SUPPORTED_SIZE.

† e
Collapse MIL_TEXT("M_DEFAULT") 1
//For monochrome or color cameras.

Specifies the default digitizer format. INFO

 † e
Collapse MIL_TEXT("M_DEFAULT_1394") 1
//For monochrome or color cameras.

Specifies the format with the largest image dimensions possible with the highest available frame rate for the connected IEEE 1394-compliant camera. INFO

 † e
Collapse MIL_TEXT("M_NTSC") 1
//For color cameras.

Specifies a DCF for a composite NTSC 640x480, 12.27 MHz camera. INFO

 † e
Collapse MIL_TEXT("M_RS170") 1
//For monochrome cameras.

Specifies a DCF for an RS-170, 640x480, 12.27 MHz, analog camera. INFO

 † e
Collapse MIL_TEXT("M_xXy_data_FORMAT_7_z") 1
//For monochrome or color cameras.

Specifies the string format for format 7 cameras, where x is SizeX in pixels, y is SizeY in pixels, data_FORMAT_7 is the image data format (for example, YUV, RGB...), and z is the format 7 mode (for example, "M_640X480_YUV411_FORMAT_7_1", "M_320X240_YUV422_FORMAT_7_2", and "M_1024X768_YUV_FORMAT_7_0" are accepted strings from one type of camera). INFO

 † e
Collapse MIL_TEXT("M_xXy_data[@z[FPS]]") 1
//For monochrome or color cameras.

Specifies the string format, where x is SizeX in pixels, y is SizeY in pixels, data is the image data format (for example, YUV, RGB...), and z is the frame rate; the information in brackets is optional (for example, "M_640X480_YUV411@30FPS", "M_320x240_YUV422@7.5", and "M_1024X768_YUV" are accepted strings from one type of camera).

 † e
Collapse M_FORMAT_SUPPORTED_NUM

Inquires the number of supported strings.

(summarize)
† e
Collapse Value

Specifies the number of supported strings.

 † e
Collapse M_FORMAT_SUPPORTED_SIZE

Inquires the maximum number of characters for the longest format supported.

(summarize)
† e
Collapse Value

Specifies the number of characters in the longest format supported.

 † e
Collapse M_GAMMA +

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

Note that this inquire type is IIDC camera specific. The camera must support the GAMMA_INQ IIDC standard feature for this inquire type to be available on the camera. SET

(summarize)
† e
Collapse UserVarPtr data type info

Data type: MIL_DOUBLE

† e
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e
Collapse Min. gamma <= Value <= Max. gamma

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

 † e
Collapse M_GC_CLPROTOCOL

Inquires whether the GenICam CLProtocol module is enabled.

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

(summarize)
† j m p r
Collapse M_DISABLE

Specifies that the GenICam CLProtocol module is disabled.

 † j m p r
Collapse M_ENABLE

Specifies that the GenICam CLProtocol module is enabled.

 † j m p r
Collapse M_GC_CLPROTOCOL_DEVICE_ID +

Inquires an identifier of a Camera Link camera and its associated GenICam CLProtocol library, from the list of available identifiers given the list of GenICam CLProtocol libraries installed on your computer.

Note that, this inquire type is only available if you first install a third-party, vendor-supplied, standard complaint CLPROTOCOL library.


You must specify a combination value from the following table:
(summarize)
† j m p r
Collapse UserVarPtr data type info

Data type: MIL_TEXT_PTR

† j m p r
Collapse M_GC_CLPROTOCOL_DEVICE_ID_DEFAULT +

Inquires the currently used identifier of the Camera Link camera and its corresponding GenICam CLProtocol library.

Note that, this inquire type is only available if you first install a 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 MdigControl() M_GC_CLPROTOCOL set to M_ENABLE.


You must specify a combination value from the following table:
(summarize)
† j m p r
Collapse UserVarPtr data type info

Data type: MIL_TEXT_PTR

† j m p r
Collapse Value

Specifies the number of characters in the IP address (including the dots).

 † j m p r
Collapse M_GC_CLPROTOCOL_DEVICE_ID_NUM

Inquires the number of GenICam CLProtocol camera identifiers available, given the list of the GenICam CLProtocol libraries installed on your computer.

Note that this inquire type can be used to enumerate the complete list of camera identifiers installed on your computer, using M_GC_CLPROTOCOL_DEVICE_ID. For more information, refer to the Using MIL with GenICam section of Chapter 23: Grabbing with your digitizer.

Note that, this inquire type is only available if you first install a third-party, vendor-supplied, standard complaint CLPROTOCOL library.

(summarize)
† j m p r
Collapse Value

Specifies the number of the GenICam CLProtocol libraries.

 † j m p r
Collapse M_GC_CLPROTOCOL_DEVICE_ID_SIZE_MAX

Inquires the maximum number of characters required to store the GenICam CLProtocol camera identification string.

Note that this inquire value can be used to enumerate the complete list of camera identifiers installed on your computer, using M_GC_CLPROTOCOL_DEVICE_ID. For more information, refer to the Using MIL with GenICam section of Chapter 23: Grabbing with your digitizer.

Note that, this inquire type is only available if you first install a third-party, vendor-supplied, standard complaint CLPROTOCOL library.

(summarize)
† j m p r
Collapse Value

Specifies the maximum number of characters required.

 † j m p r
Collapse M_GC_COUNTER_TICK_FREQUENCY

Inquires the camera's counter tick frequency. Note that a value of 0 Hz indicates that the camera does not support time stamps.

(summarize)
† c o s
Collapse UserVarPtr data type info

Data type: MIL_INT64

† c o s
Collapse Value

Specifies the camera's counter tick frequency, in Hz.

 † c o s
Collapse M_GC_FEATURE_POLLING

Inquires whether specific camera features will be periodically polled for updates when the limited version of Matrox Intellicam's Feature Browser is open (launched using MdigControl() with M_GC_FEATURE_BROWSER). SET

(summarize)
† c j k m o p q r s
Collapse M_DISABLE

Specifies that specific camera features will not be polled.

 † c j k m o p q r s
Collapse M_ENABLE

Specifies that specific camera features will be polled.

 † c j k m o p q r s
Collapse M_GC_FRAME_MAX_RETRIES

Inquires the maximum number of times packets should be re-sent before flagging their associated frame as corrupt. SET

(summarize)
† c s
Collapse Value >= M_GC_PACKET_MAX_RETRIES

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

 † c s
Collapse M_GC_FRAME_STATUS_CODE

Inquires the status code from the last grabbed image.

(summarize)
† c o s
Collapse Value

Specifies the status code.

 † c o s
Collapse M_GC_FRAME_TIMEOUT

Inquires the maximum amount of time to wait for the remaining packets of a frame, after receiving the trailer packet. SET

(summarize)
† c s
Collapse Value >= 0

Specifies the maximum time to wait, in msecs.

 † c s
Collapse M_GC_FRAME_TIMESTAMP

Inquires the timestamp of the last frame grabbed.

(summarize)
† c o s
Collapse UserVarPtr data type info

Data type: MIL_DOUBLE

† c o s
Collapse Value

Specifies the timestamp of the last frame grabbed, in secs.

 † c o s
Collapse M_GC_HEARTBEAT_STATE

Inquires whether the heartbeat mechanism is used to keep the GenICam SFNC-compliant camera active. SET

(summarize)
† c s
Collapse M_DISABLE

Specifies that the heartbeat mechanism is disabled. INFO

 † c s
Collapse M_ENABLE

Specifies that the heartbeat mechanism is enabled. INFO

 † c s
Collapse M_GC_HEARTBEAT_TIMEOUT

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

(summarize)
† c s
Collapse Value >= 0

Specifies the amount of time, in msecs.

 † c s
Collapse M_GC_INTER_PACKET_DELAY

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

If you require 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 M_GC_COUNTER_TICK_FREQUENCY), and n is your inter-packet delay value. SET

(summarize)
† c s
Collapse Value >= 0

Specifies the delay, in timestamp ticks.

 † c s
Collapse M_GC_INTERFACE_NAME

Inquires the name of the device to which your GenICam SFNC-compliant camera is connected, such as the name of the Ethernet controller used by the camera.

(summarize)
† c s
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_CHAR
Array size: Determined by calling MdigInquire() with M_GC_INTERFACE_NAME_SIZE

† c s
Collapse M_GC_INTERFACE_NAME_SIZE

Inquires the number of characters in the string returned by M_GC_INTERFACE_NAME.

(summarize)
† c s
Collapse Value

Specifies the number of characters in the interface name.

 † c s
Collapse M_GC_IP_ADDRESS_STRING

Inquires the IP address (IPv4) of the GenICam SFNC-compliant camera, as a string.

(summarize)
† c s
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_CHAR
Array size: Determined by calling MdigInquire() with M_GC_IP_ADDRESS_STRING_SIZE

† c s
Collapse MIL_TEXT("nnn.nnn.nnn.nnn") 1

Specifies the IP address of the GenICam SFNC-compliant camera as a string. The address string is expressed in dotted decimal notation, where each dotted decimal value (nnn) is a number between 0 and 255.

(summarize)
† c s
Collapse M_GC_IP_ADDRESS_STRING_SIZE

Inquires the size of the string containing the IP address of the GenICam SFNC-compliant camera.

(summarize)
† c s
Collapse Value

Specifies the number of characters in the IP address (including the dots).

 † c s
Collapse M_GC_MAC_ADDRESS_STRING

Inquires the MAC address of the GenICam SFNC-compliant camera, as a string.

(summarize)
† c s
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_CHAR
Array size: Determined by calling MdigInquire() with M_GC_MAC_ADDRESS_STRING_SIZE

† c s
Collapse MIL_TEXT("nn-nn-nn-nn-nn-nn") 1

Specifies the MAC address of the GenICam SFNC-compliant camera, as a string. The address string is expressed in hexadecimal pairs, where each pair (nn) is a hexadecimal number between 00 and FF.

(summarize)
† c s
Collapse M_GC_MAC_ADDRESS_STRING_SIZE

Inquires the size of the string containing the MAC address of the GenICam SFNC-compliant camera.

(summarize)
† c s
Collapse Value

Specifies the number of characters in the MAC address (including the dashes).

 † c s
Collapse M_GC_MAX_NBR_PACKETS_OUT_OF_ORDER

Inquires the maximum number of packets that can be received out-of-order, before the associated frame is marked as corrupt. SET

(summarize)
† c s
Collapse Value >= 0

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

 † c s
Collapse M_GC_MESSAGE_CHANNEL_MULTICAST_ADDRESS_STRING

Inquires the IP address used for the multicast message channel of your GenICam SFNC-compliant camera.

This inquire type is only available when dealing with a multicast master, or multicast monitor (allocated using MdigAlloc() with M_GC_MULTICAST_MASTER or M_GC_MULTICAST_MONITOR, respectively). SET

(summarize)
† c s
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_CHAR
Array size: Determined by calling MdigInquire() with M_GC_MESSAGE_CHANNEL_MULTICAST_ADDRESS_STRING_SIZE

† c s
Collapse MIL_TEXT("2nn.nnn.nnn") 1

Specifies the IP address in dotted decimal notation.

 † c s
Collapse M_GC_MESSAGE_CHANNEL_MULTICAST_ADDRESS_STRING_SIZE

Inquires the size of the string containing the multicast IP address of the GenICam SFNC-compliant camera.

(summarize)
† c s
Collapse Value

Specifies the number of characters in the IP address (including the dots).

 † c s
Collapse M_GC_MESSAGE_PORT

Inquires the UDP port number used for the multicast message channel for your GenICam SFNC-compliant camera.

This inquire type is only available when dealing with a multicast master, or multicast monitor (allocated using MdigAlloc() with M_GC_MULTICAST_MASTER or M_GC_MULTICAST_MONITOR, respectively). SET

(summarize)
† c s
Collapse Value >= 0

Specifies the UDP port number to use.

 † c s
Collapse M_GC_MULTICAST_MASTER_CONNECTED

Inquires whether a multicast master digitizer is connected to the camera. Note that this can only be inquired from a digitizer allocated as a slave (using MdigAlloc() with M_GC_MULTICAST_SLAVE).

(summarize)
† c s
Collapse M_FALSE

Specifies that a multicast master is not connected to the camera.

 † c s
Collapse M_TRUE

Specifies that a multicast master is connected to the camera.

 † c s
Collapse M_GC_NIC_IP_ADDRESS_STRING

Inquires the IP address of the Host's network adapter, connected to the GenICam SFNC-compliant camera.

(summarize)
† c s
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_CHAR
Array size: Determined by calling MdigInquire() with M_GC_NIC_IP_ADDRESS_STRING_SIZE

† c s
Collapse MIL_TEXT("nnn.nnn.nnn.nnn") 1

Specifies the IP address of the GenICam SFNC-compliant camera, as a string. The address string is expressed in dotted decimal notation, where each dotted decimal (nnn) is a number between 000 and 255.

(summarize)
† c s
Collapse M_GC_NIC_IP_ADDRESS_STRING_SIZE

Inquires the size of the string containing the IP address of the Host's network adapter.

(summarize)
† c s
Collapse Value

Specifies the number of characters in the IP address (including the dots).

 † c s
Collapse M_GC_NIC_MAC_ADDRESS_STRING

Inquires the MAC address of the Host's network adapter, connected to the GenICam SFNC-compliant camera.

(summarize)
† c s
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_CHAR
Array size: Determined by calling MdigInquire() with M_GC_NIC_MAC_ADDRESS_STRING_SIZE

† c s
Collapse MIL_TEXT("nn-nn-nn-nn-nn-nn") 1

Specifies the MAC address of the Host's network adapter, as a string. The address string is expressed in hexadecimal pairs, where each pair (nn) is a hexadecimal number between 00 and FF.

(summarize)
† c s
Collapse M_GC_NIC_MAC_ADDRESS_STRING_SIZE

Inquires the size of the string containing the MAC address of the Host's network adapter.

(summarize)
† c s
Collapse Value

Specifies the number of characters in the MAC address (including the dashes).

 † c s
Collapse M_GC_NUMBER_OF_STREAM_CHANNELS

Inquires the number of image streams available.

(summarize)
† c o s
Collapse Value

Specifies the number of image streams available.

 † c o s
Collapse M_GC_PACKET_MAX_RETRIES

Inquires the maximum number of times a packet can be re-sent. SET

(summarize)
† c s
Collapse Value >= M_GC_FRAME_MAX_RETRIES

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

 † c s
Collapse M_GC_PACKET_RESEND

Inquires whether to request packets be re-sent from your GenICam SFNC-compliant camera, if the packets are not receive properly (for example, when the packets are received out-of-order, or a packet timeout occurs). SET

(summarize)
† c s
Collapse M_DISABLE

Specifies that packets should never be re-sent.

 † c s
Collapse M_ENABLE

Specifies that packets should be re-sent as required.

 † c s
Collapse M_GC_PACKET_SIZE

Inquires the packet size that is used by the GigE Vision-compliant camera when streaming data to the Host. SET

(summarize)
† c s
Collapse Value >= 0

Specifies the packet size, in bytes. INFO

 † c s
Collapse M_GC_PACKET_TIMEOUT

Inquires the maximum amount of time to wait before flagging a packet as dropped. SET

(summarize)
† c s
Collapse Value >= 0

Specifies the maximum time to wait, in msecs.

 † c s
Collapse M_GC_PAYLOAD_SIZE

Inquires the number of bytes for each image transferred using the stream channel of your GenICam SFNC-compliant camera. Note that, if GenICam "chunk mode" is enabled on the camera, then this inquire returns the number of bytes in each chunk as well as the image transferred.

(summarize)
† c o s
Collapse Value

Specifies the number of bytes transferred per image or chunk.

 † c o s
Collapse M_GC_PIXEL_FORMAT

Inquires 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. SET

(summarize)
† c s
Collapse Value

Specifies the data depth and raw color format to use to create the internal buffers. INFO

 † c s
Collapse M_GC_PIXEL_FORMAT_SWITCHING

Inquires whether to allow the camera's pixel format to change to automatically match the current grab buffer. SET

(summarize)
† c o s
Collapse M_DISABLE

Specifies to disable automatic pixel format switching.

 † c o s
Collapse M_ENABLE

Specifies to enable automatic pixel format switching.

 † c o s
Collapse M_GC_SCHEMA_MAJOR

Inquires the major version number of the schema used by the camera. The version number of the schema is structured as M_GC_SCHEMA_MAJOR. M_GC_SCHEMA_MINOR.

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

Note that, this inquire type is only available if you first install a 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 MdigControl() M_GC_CLPROTOCOL set to M_ENABLE.

 † j p r
Collapse Value

Specifies the major number of the schema version.

 † c j k o p q r s
Collapse M_GC_SCHEMA_MINOR

Inquires the minor version number of the schema used by the camera. The version number of the schema is structured as M_GC_SCHEMA_MAJOR. M_GC_SCHEMA_MINOR.

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

Note that, this inquire type is only available if you first install a 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 MdigControl() M_GC_CLPROTOCOL set to M_ENABLE.

 † j p r
Collapse Value

Specifies the minor number of the schema version.

 † c j k o p q r s
Collapse M_GC_SERIAL_NUMBER

Inquires the serial number for the camera.

(summarize)
† c o s
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_CHAR
Array size: Determined by calling MdigInquire() with M_GC_SERIAL_NUMBER_SIZE

† c o s
Collapse "String"

Specifies the serial number for the camera.

 † c o s
Collapse M_GC_SERIAL_NUMBER_SIZE

Inquires the number of characters in the string returned by M_GC_SERIAL_NUMBER.

(summarize)
† c o s
Collapse Value

Specifies the number of characters in the serial number.

 † c o s
Collapse M_GC_SPECIFIC_INFO

Inquires the specific information string for the camera.

(summarize)
† c o s
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_CHAR
Array size: M_GC_SPECIFIC_INFO_SIZE

† c o s
Collapse "String"

Specifies the specific information string for the camera.

 † c o s
Collapse M_GC_SPECIFIC_INFO_SIZE

Inquires the number of characters in the string returned by M_GC_SPECIFIC_INFO.

(summarize)
† c o s
Collapse Value

Specifies the number of characters in the camera's specific information string.

 † c o s
Collapse M_GC_STREAM_CHANNEL_MULTICAST_ADDRESS_STRING

Inquires the IP address used for the multicast stream channel of your GenICam SFNC-compliant camera.

This inquire type is only available when dealing with a multicast master, or multicast monitor (allocated using MdigAlloc() with M_GC_MULTICAST_MASTER or M_GC_MULTICAST_MONITOR, respectively). SET

(summarize)
† c s
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_CHAR
Array size: Determined by calling MdigInquire() with M_GC_STREAM_CHANNEL_MULTICAST_ADDRESS_STRING_SIZE

† c s
Collapse Value

Specifies the number of characters in the IP address (including the dots).

 † c s
Collapse M_GC_STREAM_CHANNEL_MULTICAST_ADDRESS_STRING_SIZE

Inquires the size of the string containing the IP address used for the multicast stream channel.

(summarize)
† c s
Collapse Value

Specifies the number of characters in the camera's stream multicast IP address (including the dots).

 † c s
Collapse M_GC_STREAM_PORT

Inquires the UDP port number used for the multicast stream channel of your GenICam SFNC-compliant camera.

This inquire type is only available when dealing with a multicast master, or monitor (allocated using MdigAlloc() with M_GC_MULTICAST_MASTER or M_GC_MULTICAST_MONITOR, respectively). SET

(summarize)
† c s
Collapse Value >= 0

Specifies the UDP port number to use.

 † c s
Collapse M_GC_STREAMING_MODE

Inquires the camera's image stream activation mechanism. SET

(summarize)
† c k o q s
Collapse M_AUTOMATIC

Specifies that the image stream is started and stopped automatically. INFO

 † c k o q s
Collapse M_MANUAL

Specifies that the image stream is started and stopped manually. INFO

 † c k o q s
Collapse M_GC_STREAMING_STOP_CHECK_PERIOD

Inquires the maximum amount of time to wait before MIL checks to see whether a grab is pending.

Note that this inquire type is only available when M_GC_STREAMING_MODE is set to M_AUTOMATIC. SET

(summarize)
† c k o q s
Collapse Value >= 0

Specifies the amount of time, in msecs.

 † c k o q s
Collapse M_GC_STREAMING_STOP_DELAY

Inquires the amount of time to wait before stopping the image stream, if no grab is pending.

Note that this inquire type is only available when M_GC_STREAMING_MODE is set to M_AUTOMATIC. SET

(summarize)
† c k o q s
Collapse Value >= 0

Specifies the amount of time, in msecs.

 † c k o q s
Collapse M_GC_THEORETICAL_INTER_PACKET_DELAY

Inquires the theoretical delay between packets sent by your camera when transmitting a stream of image packets. This theoretical delay is determined by the GigE Vision-compliant camera's current state. This inquire type is provided as a starting point to calculate a usable inter-packet delay.

(summarize)
† c s
Collapse UserVarPtr data type info

Data type: MIL_DOUBLE

† c s
Collapse Value

Specifies the theoretical delay between packets, in secs.

 † c s
Collapse M_GC_TOTAL_FRAME_CACHE_HITS

Inquires the number of partial or complete frames that pass through the GenICam SFNC-compliant packet cache.

(summarize)
† c s
Collapse UserVarPtr data type info

Data type: MIL_INT64

† c s
Collapse Value

Specifies the number of frames.

 † c s
Collapse M_GC_TOTAL_FRAMES_CORRUPTED

Inquires the number of corrupted frames.

(summarize)
† c o s
Collapse UserVarPtr data type info

Data type: MIL_INT64

† c o s
Collapse Value

Specifies the number of corrupted frames.

 † c o s
Collapse M_GC_TOTAL_FRAMES_GRABBED

Inquires the number of frames grabbed. Note that this number includes the number of corrupt frames.

(summarize)
† c o s
Collapse UserVarPtr data type info

Data type: MIL_INT64

† c o s
Collapse Value

Specifies the number of frames grabbed.

 † c o s
Collapse M_GC_TOTAL_FRAMES_MISSED

Inquires the number of frames missed.

(summarize)
† c o s
Collapse UserVarPtr data type info

Data type: MIL_INT64

† c o s
Collapse Value

Specifies the number of frames missed.

 † c o s
Collapse M_GC_TOTAL_PACKET_CACHE_HITS

Inquires the number of packets that pass through the GenICam SFNC-compliant packet cache.

(summarize)
† c s
Collapse UserVarPtr data type info

Data type: MIL_INT64

† c s
Collapse Value

Specifies the number of packets.

 † c s
Collapse M_GC_TOTAL_PACKETS_MISSED

Inquires the number of packets missed.

(summarize)
† c s
Collapse UserVarPtr data type info

Data type: MIL_INT64

† c s
Collapse Value

Specifies the number of packets missed.

 † c s
Collapse M_GC_TOTAL_PACKETS_RECEIVED

Inquires the number of packets received.

(summarize)
† c s
Collapse UserVarPtr data type info

Data type: MIL_INT64

† c s
Collapse Value

Specifies the number of packets received.

 † c s
Collapse M_GC_TOTAL_PACKETS_RECEIVED_OUT_OF_ORDER

Inquires the number of packets received out of order.

(summarize)
† c s
Collapse UserVarPtr data type info

Data type: MIL_INT64

† c s
Collapse Value

Specifies the number of packets received out of order.

 † c s
Collapse M_GC_TOTAL_PACKETS_RECOVERED

Inquires the number of packets recovered.

(summarize)
† c s
Collapse UserVarPtr data type info

Data type: MIL_INT64

† c s
Collapse Value

Specifies the number of packets recovered.

 † c s
Collapse M_GC_TOTAL_PACKETS_RESENDS_NUM

Inquires the total number of packet re-send requests sent to the GenICam SFNC-compliant camera. Note that, one re-send request can cause multiple consecutive packets to be re-sent.

(summarize)
† c s
Collapse UserVarPtr data type info

Data type: MIL_INT64

† c s
Collapse Value

Specifies the number of packets re-sent.

 † c s
Collapse M_GC_TOTAL_PACKETS_TIMEOUT

Inquires the total number of packets that have timed-out.

(summarize)
† c s
Collapse UserVarPtr data type info

Data type: MIL_INT64

† c s
Collapse Value

Specifies the number of packets timeouts.

 † c s
Collapse M_GC_UNIQUE_ID_STRING

Inquires the unique identifier for your camera.

(summarize)
† c o s
MIL system specific

This is the camera's MAC address.

 † c s

This is the camera's global unique identifier (GUID).

 † o
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_CHAR
Array size: Determined by calling MdigInquire() with M_GC_UNIQUE_ID_STRING_SIZE

† c o s
Collapse MIL_TEXT("nnnnnnnnnnnn") 1

Specifies the unique identifier, as a string. The string is expressed in hexadecimal.

(summarize)
† c o s
Collapse M_GC_UNIQUE_ID_STRING_SIZE

Inquires the size of the string containing the unique identifier of your camera.

(summarize)
† o
Collapse Value

Specifies the number of characters in the unique identifier string.

 † o
Collapse M_GC_USER_NAME

Inquires the camera's name. SET

(summarize)
† c o s
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_CHAR
Array size: Determine by calling MdigInquire() with M_GC_USER_NAME_SIZE

† c o s
Collapse MIL_TEXT("CameraName") 1

Specifies the name of the camera.

 † c o s
Collapse M_GC_USER_NAME_SIZE

Inquires the number of characters in the string returned by M_GC_USER_NAME.

(summarize)
† c o s
Collapse Value

Specifies the number of characters in the camera's user-defined name.

 † c o s
Collapse M_GC_VERSION

Inquires the version number string for the camera.

(summarize)
† c o s
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_CHAR
Array size: Determine by calling MdigInquire()M_GC_VERSION_SIZE

† c o s
Collapse "String"

Specifies the version number string for the camera.

 † c o s
Collapse M_GC_VERSION_SIZE

Inquires the number of characters in the string returned by M_GC_VERSION.

(summarize)
† c o s
Collapse Value

Specifies the number of characters in the camera's version number string.

 † c o s
Collapse M_GC_XML_MAJOR

Inquires the major version number of the xml used by the camera. The version number of the XML is structured as M_GC_XML_MAJOR. M_GC_XML_MINOR. M_GC_XML_SUBMINOR.

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

Note that, this inquire type is only available if you first install a 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 MdigControl() M_GC_CLPROTOCOL set to M_ENABLE.

 † j p r
Collapse Value

Specifies the major version number of the xml.

 † c j k o p q r s
Collapse M_GC_XML_MINOR

Inquires the minor version number of the xml used by the camera. The version number of the XML is structured as M_GC_XML_MAJOR. M_GC_XML_MINOR. M_GC_XML_SUBMINOR.

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

Note that, this inquire type is only available if you first install a 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 MdigControl() M_GC_CLPROTOCOL set to M_ENABLE.

 † j p r
Collapse Value

Specifies the minor version number of the xml.

 † c j k o p q r s
Collapse M_GC_XML_PATH

Inquires the path and file name of the XML configuration file for your GenICam SFNC-compliant camera.

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

Note that, this inquire type is only available if you first install a 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 MdigControl() M_GC_CLPROTOCOL set to M_ENABLE.

 † j p r
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_PTR
Array size: Determined by calling MdigInquire() with M_GC_XML_PATH_SIZE

† c j k m o p q r s
Collapse "PathAndFilename"

Specifies the path and file name of the XML configuration file.

 † c j k m o p q r s
Collapse M_GC_XML_PATH_SIZE

Inquires the number of characters in the string returned by M_GC_XML_PATH.

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

Note that, this inquire type is only available if you first install a 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 MdigControl() M_GC_CLPROTOCOL set to M_ENABLE.

 † j p r
Collapse Value

Specifies the number of characters in the path and file name of the XML configuration file.

 † c j k m o p q r s
Collapse M_GC_XML_SUBMINOR

Inquires the subminor version number of the xml used by the camera. The version number of the XML is structured as M_GC_XML_MAJOR. M_GC_XML_MINOR. M_GC_XML_SUBMINOR.

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

Note that, this inquire type is only available if you first install a 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 MdigControl() M_GC_CLPROTOCOL set to M_ENABLE.

 † j p r
Collapse Value

Specifies the subminor version number of the xml.

 † c j k o p q r s
Collapse M_GRAB_DIRECTION_X

Inquires the horizontal grab direction. SET

(summarize)
† b c e f g h i j k l m n o p q r s
Collapse M_FORWARD

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

 † b c e f g h i j k l m n o p q r s
Collapse M_REVERSE

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

 † b c e f g h j k l m o p q r s
Collapse M_GRAB_DIRECTION_Y

Inquires the vertical grab direction. SET

(summarize)
† b c e f g h i j k l m n o p q r s
Collapse M_FORWARD

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

 † b c e f g h i j k l m n o p q r s
Collapse M_REVERSE

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

 † b c e f g h j k l m n o p q r s
Collapse M_GRAB_FAIL_CHECK

Inquires whether grab-failures are logged. SET

(summarize)
† b
Collapse M_DISABLE

Specifies not to log grab failures.

 † b
Collapse M_ENABLE

Specifies to log all grab failures.

 † b
Collapse M_FINAL_GRAB

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

 † b
Collapse M_GRAB_FAIL_RETRY_NUMBER

Inquires the number of retries when a field or frame grab fails. SET

(summarize)
† b
Collapse 0 <= Value <= 255

Specifies the number of times to retry.

 † b
Collapse M_GRAB_FAIL_STATUS

Inquires the status of the fail check on the last grab.

(summarize)
† b
Collapse M_NO

Specifies that the last grab did not fail.

 † b
Collapse M_YES

Specifies that the last grab failed.

 † b
Collapse M_GRAB_FIELD_NUM

Inquires the number of fields grabbed with MdigGrab(). SET

(summarize)
† b c e g h i l m n o s
Collapse 1

Specifies to grab one field.

 † b c e g h i l m n o s
Collapse 2

Specifies to grab two fields.

 † b e g h i l m n
Collapse M_GRAB_FRAME_MISSED

Inquires the number of frames sent by the camera, but not received by the digitizer when using MdigGrab(), MdigGrabContinuous() or MdigProcess(). Note that this counter resets after calling this function with this inquire, and after calling MdigControl() with M_GRAB_FRAME_MISSED_RESET.

(summarize)
† j k p q r
Collapse Value

Specifies the number of frames missed.

 † j k p q r
Collapse M_GRAB_FRAME_MISSED_COUNTER

Inquires 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()). SET

(summarize)
† j k n p q r
Collapse M_DISABLE

Specifies to disable frames missed detection.

 † j k n p q r
Collapse M_ENABLE

Specifies to enable frames missed detection.

 † j k p q r
Collapse M_GRAB_IN_PROGRESS

Inquires the current grab state, when either MdigGrabContinuous() or MdigProcess() is called.

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse M_NO

Specifies that there is no grab in progress. Note that a grab might be queued.

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse M_YES

Specifies that there is a grab in progress.

 † a b c e f g h i j k l m n o p q r s
Collapse M_GRAB_LINE_COUNTER

Inquires 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(). SET

(summarize)
† j k l m p q r
Collapse M_DISABLE

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

 † j k l m p q r
Collapse M_ENABLE

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

 † j k l m p q r
Collapse M_GRAB_MODE

Inquires how the grab should be synchronized with the Host when grabbing data with MdigGrab(). SET

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

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

 † a
Collapse M_ASYNCHRONOUS

Specifies that your application continues after one grab is queued, rather than waiting for the grab to finish. INFO

 † a b c e f g h i j k l m n o p q r s
Collapse M_ASYNCHRONOUS_QUEUED

Specifies that your application continues after each grab is queued, rather than waiting for the grab to finish. INFO

 † a b c e f g h i j k l m n o p q r s
Collapse 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
Collapse M_GRAB_PERIOD

Inquires the duration of a frame (as specified in the DCF).

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse 0

Specifies that the inquiry of the duration of a frame is not supported.

 † c o s
Collapse Value > 0

Specifies the duration of a frame, in msecs.

 † a b c e f g h i j k l m n o p q r s
Collapse M_GRAB_SCALE_INTERPOLATION_MODE

Inquires the interpolation mode, when performing a vertical and/or horizontal scaling. SET

(summarize)
† a i
MIL system specific

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

 † a
Collapse M_AVERAGE

Specifies to use an averaging interpolation. INFO

 † i
Collapse M_BICUBIC

Specifies to use a bicubic interpolation. INFO

 † a i
Collapse M_BILINEAR

Specifies to use a bilinear interpolation. INFO

 † a i
Collapse M_NEAREST_NEIGHBOR +

Specifies to use a nearest neighbor interpolation. INFO

 † a i
Collapse M_GRAB_SCALE_X +

Inquires the horizontal scaling factor when grabbing data. SET SET

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

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

 † e

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

 † a
Collapse UserVarPtr data type info

Data type: MIL_DOUBLE

† a b c e f g h i j k l m n o p q r s
Collapse M_FILL_DESTINATION

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

 † b e g h i j k l m n p q r
Collapse 1

Specifies that no scaling is applied.

 † b c e g h j k l m n o p q r s
Collapse Value = 1.0/n

Specifies to reduce the image size. INFO

 † a b c e f g h i j k l m n o p q r s
Collapse M_GRAB_SCALE_Y +

Inquires the vertical scaling factor when grabbing data. SET SET

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

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

 † e

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

 † a
Collapse UserVarPtr data type info

Data type: MIL_DOUBLE

† a b c e f g h i j k l m n o p q r s
Collapse M_FILL_DESTINATION

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

 † b e g h i j k l m n p q r
Collapse 1

Specifies that no scaling is applied.

 † b c e g h j k l m n o p q r s
Collapse Value = 1.0/n

Specifies to reduce the image size. INFO

 † a b c e f g h i j k l m n o p q r s
Collapse M_GRAB_START_MODE

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

(summarize)
† b e g h i j l m n p r
Collapse M_FIELD_START

Specifies that the grab starts on any field.

 † b g h j l m n p r
Collapse M_FIELD_START_EVEN

Specifies that the grab starts on an even field.

 † b e g h i j l m n p r
Collapse M_FIELD_START_ODD

Specifies that the grab starts on an odd field.

 † b g h i j l m n p r
Collapse M_GRAB_TIMEOUT

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

(summarize)
† b c e f g h i j k l m n o p q r s
Collapse M_INFINITE

Specifies to wait indefinitely. INFO

 † b c e f g h i j k l m n o p q r s
Collapse 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
Collapse M_HARDWARE_DEINTERLACING

Inquires whether hardware deinterlacing is used when the video source is interlaced. SET

(summarize)
† i
Collapse M_BOB_METHOD +

Specifies to use the BOB algorithm for hardware deinterlacing.

 † i
Collapse M_DISABLE

Specifies that hardware deinterlacing is disabled.

 † i
Collapse M_MADI_METHOD +

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

 † i
Collapse M_HOOK_MASTER_THREAD_HANDLE

Inquires the handle of the main interrupt thread that dispatches the user-defined functions attached to a specified digitizer event to their respective threads.

(summarize)
† b
Collapse Value

Specifies the handle of the main interrupt thread.

 † b
Collapse M_HOOK_MASTER_THREAD_ID

Inquires the identifier of the main interrupt thread that dispatches the handling of the user-defined functions attached to a specified digitizer event to their respective threads.

(summarize)
† b
Collapse MIL thread identifier

Specifies the identifier of the main interrupt thread.

 † b
Collapse M_INPUT_FILTER +

Inquires the low-pass filter applied to incoming data. SET

(summarize)
† i l
MIL system specific

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

 † l
Collapse 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. INFO

 † i
Collapse M_BYPASS

Specifies to not use a filter.

 † i l
Collapse M_LOW_PASS_0

Specifies to use the first low-pass filter. INFO

 † i l
Collapse M_LOW_PASS_1

Specifies to use the second low-pass filter. INFO

 † i l
Collapse M_INPUT_MODE

Inquires whether the analog or digital input mode is used, (as specified in the DCF).

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse M_ANALOG

Specifies analog input mode.

 † b f g h i l m n
Collapse M_DIGITAL

Specifies digital input mode.

 † a b c e f i j k l m n o p q r s
Collapse M_IRIS +

Inquires the aperture for the iris of the mechanical lens.

Note that this inquire type is IIDC camera specific. The camera must support the IRIS_INQ IIDC standard feature for this inquire type to be supported. SET

(summarize)
† e
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e
Collapse Min. aperature <= Value <= Max. aperature

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

 † e
Collapse M_LAST_GRAB_IN_TRUE_BUFFER

Inquires whether a monoshot grab is performed when MdigHalt() is called after performing a continuous grab operation. SET

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

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

 † a
Collapse 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. INFO

 † a b c e f g h i j k l m n o p q r s
Collapse M_ENABLE

Specifies that a monoshot grab is performed. INFO

 † a b c e f g h i j k l m n o p q r s
Collapse M_LIGHTING_BRIGHT_FIELD

Inquires 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. SET

(summarize)
† f
Collapse 0 <= Value <= 255

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

 † f
Collapse M_LIGHTING_BRIGHT_FIELD_HIDRIVE

Inquires whether to force the connected LED lighting device to emit the maximum intensity of light, for a specified period of time. To return the period of time, use M_LIGHTING_BRIGHT_FIELD_HIDRIVE_TIME. SET

(summarize)
† f
Collapse M_DISABLE

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

 † f
Collapse M_ENABLE

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

 † f
Collapse M_LIGHTING_BRIGHT_FIELD_HIDRIVE_TIME

Inquires 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. SET

(summarize)
† f
Collapse Value >= 0

Specifies the amount of time, in nsecs.

 † f
Collapse M_LIGHTING_BRIGHT_FIELD_OFFSET

Inquires whether to keep the connected LED lighting device marginally powered by 5% (always on) when M_LIGHTING_BRIGHT_FIELD_HIDRIVE is enabled. SET

(summarize)
† f
Collapse M_DISABLE

Specifies that the LED lighting device is not marginally powered. INFO

 † f
Collapse M_ENABLE

Specifies that the LED lighting device is kept marginally powered. INFO

 † f
Collapse M_LUT_ID

Inquires whether to map the input data through the physical LUT of the specified digitizer and the values with which to initialize the LUT. SET

(summarize)
† a f l m
MIL system specific

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

 † a
Collapse UserVarPtr data type info

Data type: MIL_ID

† a f l m
Collapse 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. INFO

 † a f l m
Collapse M_NUMBER

Inquires the device number of the digitizer. SET

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse M_DEVn

Specifies the first acquisition path with which to associate a timing control unit (for example, a video capture controller) on your frame grabber, or the rank of your camera when dealing with a network camera (for example, a GigE Vision camera) or a USB3 Vision camera. INFO

 † a b c e f g h i j k l m n o p q r s
Collapse M_OPTICAL_FILTER +

Inquires the optical filter of the camera lens.

Note that this inquire type is IIDC camera specific. The camera must support the OPTICAL_FILTER_INQ IIDC standard feature for this inquire type to be available on the camera. SET

(summarize)
† e
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e
Collapse Min. filter <= Value <= Max. filter

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

 † e
Collapse M_OWNER_SYSTEM

Inquires the MIL identifier of the system on which the digitizer has been allocated. SET

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse UserVarPtr data type info

Data type: MIL_ID

† a b c e f g h i j k l m n o p q r s
Collapse MIL system identifier

Specifies the MIL identifier of the system.

 † a b c e f g h i j k l m n o p q r s
Collapse M_PAN +

Inquires the camera's rotation along its horizontal axis.

Note that this inquire type is IIDC camera specific. The camera must support the PAN_INQ IIDC standard feature for this inquire type to be supported. SET

(summarize)
† e
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e
Collapse Min. pan <= Value <= Max. pan

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

 † e
Collapse M_POWER_OVER_CABLE

Inquires whether PoCL (power over Camera Link) or PoCXP (power over CoaXPress) are enabled. SET

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

Note that this inquire value is only supported on Matrox Solios eV-CLB and eV-CLBL. In addition, 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
Collapse M_PROCESS_FRAME_CORRUPTED

Inquires the number of corrupted frames grabbed in the sequence with MdigProcess().

(summarize)
† a c f i o s
Collapse Value

Specifies the number of corrupted frames.

 † a c f i o s
Collapse M_PROCESS_FRAME_COUNT

Inquires the number of frames grabbed in the sequence with MdigProcess().

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse Value

Specifies the number of grabbed frames.

 † a b c e f g h i j k l m n o p q r s
Collapse M_PROCESS_FRAME_MISSED

Inquires the number of frames believed to be missed when grabbing with MdigProcess(). This value is based on a comparison between the frame rate (M_PROCESS_FRAME_RATE) and the frame count (M_PROCESS_FRAME_COUNT). If a grab is triggered from a variable trigger or if the hooked function is slow, this value will be affected. This value is most trustworthy with a camera in continuous mode.

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse Value

Specifies the number of missed frames.

 † a b c e f g h i j k l m n o p q r s
Collapse M_PROCESS_FRAME_RATE

Inquires the rate at which the frames are grabbed using MdigProcess(). Note that this inquire type is determined based on the average of the camera's frame rate, and the total amount of time to process the user-defined hooked function(s).

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse UserVarPtr data type info

Data type: MIL_DOUBLE

† a b c e f g h i j k l m n o p q r s
Collapse Value

Specifies the rate at which the frames are grabbed, in frames/sec.

 † a b c e f g h i j k l m n o p q r s
Collapse M_PROCESS_GRAB_MONITOR

Inquires whether to create an internal grab monitoring thread when using MdigProcess() with either M_START or M_SEQUENCE. SET

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse M_DISABLE

Does not create a grab activity thread.

 † a b c e f g h i j k l m n o p q r s
Collapse M_ENABLE

Creates a grab activity thread.

 † b c e f g h i j k l m n o p q r s
Collapse M_PROCESS_PENDING_GRAB_NUM

Inquires the number of buffers remaining in the list of buffers used by MdigProcess(). Note that this number includes the buffer used by the grab in progress. When dealing with round-robin grabbing, this number will typically be relatively close to the total number of allocated grab buffers.

(summarize)
† c f g h i j k l m n o p q r s
Collapse Value

Specifies the number of buffers remaining in the list of buffers.

 † c f g h i j k l m n o p q r s
Collapse M_PROCESS_TIMEOUT

Inquires 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. SET

(summarize)
† c e f g h i j k l m n o p q r s
Collapse M_INFINITE

Specifies to wait indefinitely.

 † c e f g h i j k l m n o p q r s
Collapse 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
Collapse M_PROCESS_TOTAL_BUFFER_NUM

Inquires the total number of allocated grab buffers in the list of buffers before MdigProcess() begins. SET

(summarize)
† c g h i j k l m n o p q r s
Collapse Value

Specifies the total number of allocated grab buffers.

 † c g h i j k l m n o p q r s
Collapse M_SCAN_MODE

Inquires the scan mode.

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse M_INTERLACE

Specifies interlace mode.

 † b c g h i l m n o s
Collapse M_LINESCAN

Specifies line-scan mode.

 † c j k l m o p q r s
Collapse M_PROGRESSIVE

Specifies progressive mode.

 † a b c e f g h i j k l m n o p q r s
Collapse M_SELECTED_FRAME_RATE

Inquires the frame rate of the camera when grabbing in synchronous mode. SET

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse UserVarPtr data type info

Data type: MIL_DOUBLE

† a b c e f g h i j k l m n o p q r s
Collapse Value

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

 † a b c e f g h i j k l m n o p q r s
Collapse M_SERIAL_NUMBER

Inquires the serial number of the connected device.

(summarize)
† e f
MIL system specific

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

 † e
Collapse UserVarPtr data type info

Data type: array of type MIL_TEXT_CHAR
Array size: Determine by calling MdigInquire() with M_SERIAL_NUMBER_SIZE

† e f
Collapse "String"

Specifies the serial number of the connected device.

 † e f
Collapse M_SERIAL_NUMBER_0

Inquires the most-significant 32 bits of the serial number of the camera.

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

(summarize)
† e
Collapse Value

Specifies the most-significant 32 bits of the serial number of the camera.

 † e
Collapse M_SERIAL_NUMBER_1

Inquires the least-significant 32 bits of the serial number of the camera.

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

(summarize)
† e
Collapse Value

Specifies the least-significant 32 bits of the serial number of the camera.

 † e
Collapse M_SERIAL_NUMBER_SIZE

Inquires the number of characters in the string returned by M_SERIAL_NUMBER.

(summarize)
† e f
MIL system specific

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

 † e
Collapse Value

Specifies the maximum number of characters in the serial number.

 † e f
Collapse M_SHARPNESS +

Inquires the sharpness of the image.

Note that this inquire type is IIDC camera specific. The camera must support the SHARPNESS_INQ IIDC standard feature for this inquire type to be supported. SET

(summarize)
† e
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e
Collapse Min. sharpness <= Value <= Max. sharpness

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

 † e
Collapse M_SIGN

Inquires whether the data is signed or unsigned.

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse M_SIGNED

Specifies that the data is signed.

 † a c o s
Collapse M_UNSIGNED

Specifies that the data is unsigned.

 † a b c e f g h i j k l m n o p q r s
Collapse M_SIZE_BAND

Inquires the number of input color bands of the digitizer.

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse Value

Specifies the number of input color bands of the digitizer.

 † a b c e f g h i j k l m n o p q r s
Collapse M_SIZE_BAND_LUT

Inquires the number of input color bands of the LUT buffer associated with the digitizer.

(summarize)
† b c e f g h i j k l m n o p q r s
Collapse 0

Specifies that LUTs are not supported.

 † b e
Collapse Value > 0

Specifies the number of input color bands.

 † c f g h i j k l m n o p q r s
Collapse M_SIZE_BIT

Inquires the depth per band.

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

This will be either 8-bit or 16-bit. Note that the 1394-compliant camera must send the data in packets that are a multiple of 8-bits in size.

 † e
Collapse Value

Specifies the depth per band, in bits.

 † a b c e f g h i j k l m n o p q r s
Collapse M_SIZE_X +

Inquires the width of the image.

When you specify the digitizer configuration format (DCF) appropriate for your camera, using MdigAlloc() with DataFormat, you are indirectly setting the size of the image that can be grabbed.

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse Value

Specifies the width of the image, in pixels.

 † a b c e f g h i j k l m n o p q r s
Collapse M_SIZE_Y +

Inquires the height of the image.

When you specify the digitizer configuration format (DCF) appropriate for your camera, using MdigAlloc() with DataFormat, you are indirectly setting the size of the image that can be grabbed.

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse Value

Specifies the height of the image, in pixels.

 † a b c e f g h i j k l m n o p q r s
Collapse M_SOURCE_COMPENSATION +

Inquires whether source compensation for cropping an input signal capture window is enabled. SET

(summarize)
† e
Collapse M_DISABLE

Specifies to use hardware to crop the capture window, provided that you are using a format 7-capable camera. INFO

 † e
Collapse M_ENABLE

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

 † e
Collapse M_SOURCE_DATA_FORMAT

Inquires the MIL buffer format that is compatible with the camera's pixel format.

(summarize)
† c i o s
MIL system specific

Note that this value returns the MIL-equivalent of the camera's current pixel format. The camera's pixel format typically varies from camera to camera. To change the camera's pixel format, use MdigControlFeature().

 † c o s

Note that this value returns the default MIL buffer format, set using the DCF.

 † i
Collapse M_PACKED +

Specifies that the buffer's bands are stored in packed format (color buffer only); that is, the pixel components are stored together (RGB RGB RGB...).

 † c i o s
Collapse M_PLANAR +

Specifies that the buffer's bands are stored in planar format; that is, each pixel is stored as three component planes (RRR... GGG... BBB...).

 † c o s
Collapse M_SOURCE_OFFSET_X +

Inquires the X-offset of the input-signal capture window. SET

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

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

 † e

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

 † a
Collapse 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
Collapse M_SOURCE_OFFSET_Y +

Inquires the Y-offset of the input-signal capture window. SET

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

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

 † e

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

 † a
Collapse 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
Collapse M_SOURCE_SIZE_X +

Inquires the width of the input signal capture window. SET

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

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

 † e

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

 † a
Collapse Value

Specifies the width, in pixels.

 † a b c e f g h i j k l m n o p q r s
Collapse M_SOURCE_SIZE_Y +

Inquires the height of the input signal capture window. SET

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

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

 † e

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

 † a
Collapse Value

Specifies the height, in pixels.

 † a b c e f g h i j k l m n o p q r s
Collapse M_TARGET_TEMPERATURE +

Inquires the target temperature for the camera.

Note that this inquire type is IIDC camera specific. The camera must support the TEMPERATURE_INQ IIDC standard feature for this inquire type to be supported. SET

(summarize)
† e
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e
Collapse Min. temperature <= Value <= Max. temperature

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

 † e
Collapse M_TILT +

Inquires the camera's vertical angle.

Note that this inquire type is IIDC camera specific. The camera must support the TILT_INQ IIDC standard feature for this inquire type to be supported. SET

(summarize)
† e
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e
Collapse Min. tilt <= Value <= Max. tilt

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

 † e
Collapse M_TYPE

Inquires the data type and depth of the digitizer's input. Depth is returned in bits.

(summarize)
† a b c e f g h i j k l m n o p q r s
Collapse depth value + M_SIGNED

Specifies the data depth and that the data is signed.

 † b c f g h i l m n o s
Collapse depth value + M_UNSIGNED

Specifies the data depth and that the data is unsigned.

 † a b c e f g h i j k l m n o p q r s
Collapse M_VIDEO_OUTPUT

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

(summarize)
† h
Collapse M_NULL

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

 † h
Collapse 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
Collapse M_WHITE_BALANCE

Inquires whether to perform white balancing. SET

(summarize)
† c f k m o q s
MIL system specific

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

 † m

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

 † c o s

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

 † f
Collapse M_CALCULATE

Calculates new white balance coefficients, overwriting old coefficients. INFO

 † c f k m o q s
Collapse M_DISABLE

Specifies that white balancing is disabled.

 † c f k m o q s
Collapse M_ENABLE

Specifies that white balancing is enabled. INFO

 † c f k m o q s
Collapse M_WHITE_BALANCE_U +

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

Note that this inquire type is IIDC camera specific. The camera must support the WHITE_BAL_INQ IIDC standard feature for this inquire type to be supported. SET

(summarize)
† e
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e
Collapse Min. U chrominance <= Value <= Max. U
chrominance

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

 † e
Collapse M_WHITE_BALANCE_V +

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

Note that this inquire type is IIDC camera specific. The camera must support the WHITE_BAL_INQ IIDC standard feature for this inquire type to be supported. SET

(summarize)
† e
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e
Collapse Min. V chrominance <= Value <= Max. V
chrominance

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

 † e
Collapse M_ZOOM +

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

Note that this inquire type is IIDC camera specific. The camera must support the ZOOM_INQ IIDC standard feature for this inquire type to be supported. SET

(summarize)
† e
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e
Collapse Min. zoom <= Value <= Max. zoom

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

 † e

1 If the value was passed in a variable, it won't be returned enclosed in MIL_TEXT().

Combination constant for M_NEAREST_NEIGHBOR (when InquireType=M_GRAB_SCALE_INTERPOLATION_MODE and UserVarPtr=M_NEAREST_NEIGHBOR).

The following value might be combined with the above-mentioned value to get the speed and precision of the interpolation.

function map For specifying the speed and precision of the interpolation
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_FAST

Uses a fast interpolation. INFO

 † i
Combination constant for M_GRAB_INPUT_GAIN; M_INPUT_FILTER.

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

function map For specifying the acquisition path
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_CHn

Inquires the setting applied to acquisition path n, used by the digitizer.

When adding this combination constant to M_GRAB_INPUT_GAIN, n can be a value from 0 to 2.

(summarize)
† l n
MIL system specific

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

 † l

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

 † n
Combination constants for M_DEV_NUMBER (when InquireType=M_EXTENDED_INIT_FLAG and UserVarPtr=M_DEV_NUMBER); M_GC_DEVICE_IP_ADDRESS (when InquireType=M_EXTENDED_INIT_FLAG and UserVarPtr=M_GC_DEVICE_IP_ADDRESS); M_GC_DEVICE_USER_NAME (when InquireType=M_EXTENDED_INIT_FLAG and UserVarPtr=M_GC_DEVICE_USER_NAME).

One or more of the following values might be combined with the above-mentioned values to specify further details of the allocation of your camera.

function map For inquiring additional allocation details
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_GC_PACKET_SIZE_NEGOTIATION_SKIP

Specifies that the packet size negotiation task is skipped. INFO

 † c s
Collapse M_GC_XML_DOWNLOAD_SKIP

Specifies that the camera's device description file (XML) should not be downloaded from the camera associated with the digitizer. INFO

 † c o s
Collapse M_GC_XML_FORCE_DOWNLOAD

Specifies that the camera's device description file (XML) should be downloaded from the camera associated with the digitizer. INFO

 † c o s
Combination constants for M_DEV_NUMBER (when InquireType=M_EXTENDED_INIT_FLAG and UserVarPtr=M_DEV_NUMBER); M_GC_DEVICE_IP_ADDRESS (when InquireType=M_EXTENDED_INIT_FLAG and UserVarPtr=M_GC_DEVICE_IP_ADDRESS); M_GC_DEVICE_USER_NAME (when InquireType=M_EXTENDED_INIT_FLAG and UserVarPtr=M_GC_DEVICE_USER_NAME).

One of the following values might be combined with the above-mentioned values to specify the allocated device will be the master or slave digitizer in a multicast master-slave relationship.

function map For specifying the multicast master-slave relationship
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_GC_MULTICAST_MASTER

Specifies that the allocated digitizer will be the master digitizer in a multicasting master-slave or monitor relationship. INFO

 † c s
Collapse M_GC_MULTICAST_MONITOR

Specifies that the allocated digitizer will be a special type of slave digitizer (a monitor digitizer) in a multicast master-slave relationship. INFO

 † c s
Collapse M_GC_MULTICAST_SLAVE

Specifies that the allocated digitizer will be a slave digitizer in a multicast master-slave relationship. INFO

 † c s
Combination constants for M_PLANAR (when InquireType=M_SOURCE_DATA_FORMAT and UserVarPtr=M_PLANAR).

One of the following values might be combined with the above-mentioned value to specify the format of the planar color buffer.

function map Returns the format of the planar color buffer
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_MONO8

Specifies 8-bit monochrome depth planar pixels.

 † c o s
Collapse M_MONO16

Specifies 16-bit monochrome depth planar pixels.

 † c o s
Combination constants for M_PACKED (when InquireType=M_SOURCE_DATA_FORMAT and UserVarPtr=M_PACKED).

One of the following values might be combined with the above-mentioned value to specify the format of the packed color buffer.

function map Returns the format of the packed color buffer
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_BGR24

Specifies 24-bit color depth packed pixels (BGRBGR).

 † c o s
Collapse M_BGR32

Specifies 32-bit color depth packed pixels (BGRXBGRX). The most-significant byte is a "don't care" byte.

(summarize)
† c i o s
Collapse M_RGB15

Specifies 16-bit color depth packed pixels (XRGB 1:5:5:5). Note that when accessing an M_RGB15 + packed buffer as a 3-band 8-bit buffer, the least significant bits are set to 0.

(summarize)
† c o s
Collapse M_RGB16

Specifies 16-bit color depth packed pixels (RGB 5:6:5). Note that when accessing an M_RGB16 + packed buffer as a 3-band 8-bit buffer, the least significant bits are set to 0.

(summarize)
† c o s
Collapse M_RGB24

Specifies 24-bit color depth (RGB 8:8:8) packed or planar pixels.

 † c o s
Collapse M_RGB48

Specifies 48-bit color depth (RGB 16:16:16) packed or planar pixels.

 † c o s
Collapse M_YUV16

Specifies YUV16 packed (4:2:2) pixels.

 † c o s
Collapse M_YUV16_UYVY

Specifies YUV16 packed (4:2:2) pixels, whereby the components of each pixel are stored in the UYVY order. For more information, see the YUV buffers section of Chapter 19: Data buffers.

(summarize)
† c i o s
Collapse M_YUV16_YUYV

Specifies YUV16 packed (4:2:2) pixels, whereby the components of each pixel are stored in the YUYV order. For more information, see the YUV buffers section of Chapter 19: Data buffers.

(summarize)
† c i o s
Collapse M_YUV411_1394

Specifies YUV411 packed (6:6:6) pixels.

 † c o s
Collapse M_YUV444

Specifies YUV444 packed (3:3:3) pixels.

 † c o s

You must add the following value to the above-mentioned values to specify which Camera Link camera to inquire.

function map For specifying which Camera Link camera to inquire
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse Value >= 0

Specifies which Camera Link camera to inquire.

 † j m p r
Combination constants for M_BOB_METHOD (when InquireType=M_HARDWARE_DEINTERLACING and UserVarPtr=M_BOB_METHOD); M_MADI_METHOD (when InquireType=M_HARDWARE_DEINTERLACING and UserVarPtr=M_MADI_METHOD).

One of the following values might be combined with the above-mentioned values to get whether anti-aliasing and/or dithering is enabled.

function map For specifying whether anti-aliasing and/or dithering is enabled
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_ANTIALIASING

Specifies that anti-aliasing is enabled.

 † i
Collapse M_DITHERING

Specifies that dithering is enabled.

 † i

The following inquire types and inquire values relate to (if available) the reference levels used to digitize the analog signal received from a camera. These inquire 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.

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.

function map For the general reference settings
CollapseInquireType Description
MIL system-specific
tooltip (†)
UserVarPtr
- Possible values returned
Collapse M_BLACK_REF +

Inquires the input signal's digitization black reference level. SET

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

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

 † n
Collapse UserVarPtr data type info

Data type: MIL_DOUBLE

† c l n o s
Collapse Value

Specifies the black reference level.

 † c l n o s
Collapse M_BRIGHTNESS +

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

Note that this inquire type is IIDC camera specific. The camera must support the BRIGHTNESS_INQ IIDC standard feature for this inquire type to be available on the camera. This inquire type is not available on your Matrox Imaging board. SET

(summarize)
† e
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e
Collapse Min. brightness <= Value <= Max. brightness

Specifies the brightness reference level. INFO

 † e
Collapse M_BRIGHTNESS_REF

Inquires the brightness level for composite input signals. SET

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

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

 † e

Note that, to use this inquire type, you must use a DCF that uses a composite video signal.

 † n

Note that, to use this inquire, you must use an RGB or composite DCF.

 † i
Collapse UserVarPtr data type info

Data type: MIL_DOUBLE

† b e g h i n
Collapse Value

Specifies the brightness reference value.

 † b e g h i n
Collapse M_CONTRAST_REF

Inquires the contrast level for composite input signals. SET

(summarize)
† b g h i n
MIL system specific

Note that, to use this inquire type, you must use a DCF that uses a composite video signal.

 † n
Collapse UserVarPtr data type info

Data type: MIL_DOUBLE

† b g h i n
Collapse Value

Specifies the contrast reference value.

 † b g h i n
Collapse M_HUE +

Inquires the color phase with which to adjust the image.

Note that this inquire type is IIDC camera specific. The camera must support the HUE_INQ IIDC standard feature for this inquire type to be supported. SET SET

(summarize)
† e
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e
Collapse Min. hue <= Value <= Max. hue

Specifies the color phase. INFO

 † e
Collapse M_HUE_REF

Inquires the hue level for composite input signals. Note that this inquire type is not supported for monochrome cameras. SET SET

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

This is only supported on Matrox Vio /Analog DCF.

 † n

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

 † e

Note that, to use this inquire type, you must use a DCF that uses a composite video signal.

 † i n
Collapse UserVarPtr data type info

Data type: MIL_DOUBLE

† b e g h i n
Collapse Value

Specifies the digitizer hue reference level.

 † b e g h i n
Collapse M_SATURATION +

Inquires the color saturation value for the image.

Note that this inquire type is IIDC camera specific. The camera must support the SATURATION_INQ IIDC standard feature for this inquire type to be supported. SET SET

(summarize)
† e
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e
Collapse Min. saturation <= Value <= Max. saturation

Specifies the color saturation value. INFO

 † e
Collapse M_SATURATION_REF

Inquires the saturation level for composite input signals. SET SET

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

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

 † e

Note that, to use this inquire type, you must use a DCF that uses a composite video signal.

 † i n
Collapse UserVarPtr data type info

Data type: MIL_DOUBLE

† b e g h i n
Collapse Value

Specifies the digitizer saturation reference level.

 † b e g h i n
Collapse M_WHITE_REF +

Inquires the input signal's digitization white reference level. SET

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

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

 † n
Collapse UserVarPtr data type info

Data type: MIL_DOUBLE

† c l n o s
Collapse Value

Specifies the digitizer's white reference value.

 † c l n o s
Combination constants for M_BLACK_REF; M_WHITE_REF.

You can add one of the following values to the above-mentioned values to get information about a specific acquisition path used by the digitizer.

[Matrox Vio]

This is only supported on Matrox Vio /Analog DCF and for this product, it is only available when using a DCF that uses an RGB video signal.

function map For specifying which acquisition path is inquired
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_ALL_REF

Inquires the reference level on all available acquisition paths. INFO

 † l n
Collapse M_CH0_REF

Inquires the reference level on acquisition path 0. INFO

 † l n
Collapse M_CH1_REF

Inquires the reference level on acquisition path 1. INFO

 † l n
Collapse M_CH2_REF

Inquires the reference level on acquisition path 2. INFO

 † l n
Collapse M_CH3_REF

Inquires the reference level on acquisition path 3.

 † l
Combination constant for M_BLACK_REF; M_WHITE_REF.

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

[Matrox Vio]

This is only supported on Matrox Vio /Analog DCF.

function map For specifying the black and white reference level in Volts
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_VOLTAGE

Inquires the reference level in Volts.

 † l n

The following inquire types and inquire values allow you to inquire the input gain.

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_INT.

function map For inquiring the input gain
CollapseInquireType Description
MIL system-specific
tooltip (†)
UserVarPtr
- Possible values returned
Collapse M_GAIN +

Inquires the input gain with which to amplify the input signal. SET

(summarize)
† c e o s
MIL system specific

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

 † e
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e
Collapse Min. gain <= Value <= Max. gain

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

 † c e o s
Collapse M_GRAB_AUTOMATIC_INPUT_GAIN +

Inquires whether the input gain should be automatically set. SET

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

If the components of the input signal have different automatic input gain states, this inquire type returns the automatic input gain state of the luminance component. To inquire about the state of the automatic input-gain setting for a specific component of the input signal, see combination values below.

 † g
Collapse M_DISABLE

Specifies that the input gain is not automatically set.

 † b c g h i n o s
Collapse M_ENABLE

Specifies that the input gain is automatically set.

 † b c g h i n o s
Collapse M_GRAB_INPUT_GAIN +

Inquires the input gain with which to amplify the input signal. SET

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

If the acquisition paths or components of the input signal have different input gain, this inquire type returns the input gain of the first acquisition path or the luminance component, respectively. To inquire about the input gain last applied to a specific acquisition path or component of the input signal, see combination values below.

 † g l

This is only supported on Matrox Vio /Analog DCF.

 † n

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

 † e

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

 † i n
Collapse M_GAIN0

Specifies the first input gain supported. INFO

 † i l n
Collapse M_GAIN1

Specifies the second input gain supported. INFO

 † i l n
Collapse M_GAIN2

Specifies the third input gain supported. INFO

 † i l
Collapse M_GAIN3

Specifies the fourth input gain supported. INFO

 † i l
Collapse M_MAX_LEVEL

Specifies the maximum input gain factor.

 † b e f g h i l n
Collapse M_MIN_LEVEL

Specifies the minimum input gain factor.

 † b e f g h i l n
Collapse 0 <= Value <= 255

Specifies an integer value which is used to determine the input gain factor. INFO

 † b e f g h i l n

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

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

function map For specifying the specific video signal component to apply the input-gain setting
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_CHROMINANCE

Specifies the input-gain setting applied to the chrominance component of the video signal. INFO

 † g h i n
Collapse M_LUMINANCE

Specifies the input-gain setting applied to the luminance component of the video signal. INFO

 † g h i n

The following inquire types and inquire values allow you to inquire 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 inquire the I/O signal using the inquire types described in the following tables: For inquiring the state of specified user-bits in a static-user-output register, For inquiring the settings of a timer, For inquiring the camera's exposure, and For inquiring 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 MsysInquire().

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_INT.

function map For inquiring I/O signals and their mode
CollapseInquireType Description
MIL system-specific
tooltip (†)
UserVarPtr
- Possible values returned
Collapse M_AUX_IO_COUNT

Inquires the total number of auxiliary signals.

(summarize)
† c j k l m o p q r s
Collapse Value

Specifies the total number of auxiliary signals.

 † c j k l m o p q r s
Collapse M_AUX_IO_COUNT_IN

Inquires the total number of auxiliary input and bidirectional signals.

(summarize)
† c j k l m o p q r s
Collapse Value

Specifies the total number of auxiliary input and bidirectional signals.

 † c j k l m o p q r s
Collapse M_AUX_IO_COUNT_OUT

Inquires the total number of auxiliary output and bidirectional signals.

(summarize)
† c j k l m o p q r s
Collapse Value

Specifies the total number of auxiliary output and bidirectional signals.

 † c j k l m o p q r s
Collapse M_CC_IO_COUNT_OUT

Inquires the total number of camera control output signals.

(summarize)
† c j l m o p r s
Collapse Value

Specifies the total number of camera control output and bidirectional signals.

 † c j l m o p r s
Collapse M_IO_FORMAT +

Inquires the type of transmitter/receiver enabled for the specified I/O signal. SET


You must specify a combination value from the following table:
(summarize)
† c j k l m o p q r s
Collapse M_DISABLE

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

 † c o s
Collapse M_LVDS

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

 † c j k l m o p q r s
Collapse M_OPEN_DRAIN

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

 † c o s
Collapse M_OPTO

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

 † c j k l m o p q r s
Collapse M_RS422

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

 † c o s
Collapse M_TRI_STATE

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

 † c o s
Collapse M_TTL

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

 † c j k l m o p q r s
Collapse M_IO_INTERRUPT_ACTIVATION +

Inquires the signal transition upon which to generate an interrupt, if interrupt generation has been enabled for the specified I/O signal. SET


You must specify a combination value from the following table:
(summarize)
† c j k l m o p q r s
Collapse M_ANY_EDGE

Specifies to generate an interrupt upon both a low-to-high and a high-to-low signal transition.

 † c j k l m o p q r s
Collapse M_EDGE_FALLING

Specifies that an interrupt will be generated upon a high-to-low signal transition.

 † c j k l m o p q r s
Collapse M_EDGE_RISING

Specifies that an interrupt will be generated upon a low-to-high signal transition.

 † c j k l m o p q r s
Collapse M_IO_INTERRUPT_STATE +

Inquires whether to generate an interrupt upon the specified transition of the I/O signal. SET


You must specify a combination value from the following table:
(summarize)
† c j k l m o p q r s
Collapse M_DISABLE

Specifies not to generate an interrupt.

 † c j k l m o p q r s
Collapse M_ENABLE

Specifies to generate an interrupt.

 † c j k l m o p q r s
Collapse M_IO_MODE +

Inquires the mode of the specified I/O signal. SET


You must specify a combination value from the following table:
(summarize)
† c j k l m o p q r s
Collapse M_INPUT

Specifies that the signal is for input.

 † c j k l m o p q r s
Collapse M_OUTPUT

Specifies that the signal is for output.

 † c j k l m o p q r s
Collapse M_IO_SOURCE +

Inquires the type of signal routed onto an output signal or onto a bidirectional signal set to output mode. SET


You must specify a combination value from the following table:
(summarize)
† c j k l m o p q r s
Collapse M_AUX_IOn

Specifies to reroute auxiliary input signal n to the output signal, where n is the number of the auxiliary input signal. INFO

 † c j k l m o p q r s
Collapse M_DISABLE

Specifies to not route any signal to the specified signal.

 † c j k l m o p q r s
Collapse M_HSYNC

Specifies to route the horizontal synchronization signal of the camera. INFO

 † l m
Collapse M_PIXCLK

Specifies to route the pixel clock signal of the camera. INFO

 † l m
Collapse M_TIMERn

Specifies to route the output of timer n, where n is the number of timers available. INFO

 † c j k l m o p q r s
Collapse M_TL_TRIGGER

Specifies to use the transport layer trigger signal (input mode only). INFO

 † k q
Collapse 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. INFO

 † j m p r
Collapse M_USER_BIT_TL_TRIGGER

Specifies to route the state of the bit of the TL trigger static-user-output register.

 † k q
Collapse M_USER_BITn

Specifies to route the state of bit n of the main static-user-output register, where n is the bit number. INFO

 † c j k l m o p q r s
Collapse M_VSYNC

Specifies to route the vertical synchronization signal of the camera. INFO

 † l m
Collapse M_IO_STATUS +

Inquires the status of the input signal or bidirectional signal set to input.


You must specify a combination value from the following table:
(summarize)
† c j k l m o p q r s
Collapse M_INVALID

Specifies that the input signal is disabled.

 † c j k l m o p q r s
Collapse M_OFF

Specifies that the input signal is off.

 † c j k l m o p q r s
Collapse M_ON

Specifies that the input signal is on.

 † c j k l m o p q r s
Collapse M_UNKNOWN

Specifies that the input signal cannot be inquired with its current configuration.

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

Inquiring the status of an auxiliary output signal will return this value, unless the auxiliary signal is outputting a user-bit (set using MdigControl() with M_IO_SOURCE set to M_USER_BIT...).

 † j m p r
Collapse M_IO_STATUS_ALL +

Inquires the status of all available I/O signals. Note that if there are I/O signals that cannot be inquired, the bits representing those signals, in the bit-encoded value returned, are not necessarily valid; these bits should be ignored.

(summarize)
† c j k l m o p q r s
Collapse UserVarPtr data type info

Data type: MIL_INT64

† c j k l m o p q r s
Collapse Value

Specifies the bit-encoded value representing the status of all available and inquirable I/O signals.

 † c j k l m o p q r s
Collapse M_TL_TRIGGER_COUNT

Inquires the total number of TL trigger signals.

(summarize)
† c j k l m o p q r s
Collapse Value

Specifies the total number of TL trigger signals.

 † c j k l m o p q r s
Collapse M_TL_TRIGGER_COUNT_IN

Inquires the total number of input and I/O TL trigger signals.

(summarize)
† c j k l m o p q r s
Collapse Value

Specifies the total number of input and I/O TL trigger signals.

 † c j k l m o p q r s
Collapse M_TL_TRIGGER_COUNT_OUT

Inquires the total number of output and I/O TL trigger signals.

(summarize)
† c j k l m o p q r s
Collapse Value

Specifies the total number of output and I/O TL trigger signals.

 † c j k l m o p q r s

You must add one of the following values to the above-mentioned values to specify the type and number of the I/O signal to inquire.

These combination constants have certain restrictions; for more information, refer to the For specifying the type and number of the I/O signal to affect combination table in MdigControl().

function map For specifying the type and number of the I/O signal to inquire
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_AUX_IOn

Specifies to inquire auxiliary signal n, where n is the signal number. INFO

 † c j k l m o p q r s
Collapse M_CC_IOn

Specifies to inquire Camera Link camera control signal n, where n is a value from 1 to 4. INFO

 † j m p r
Collapse M_TL_TRIGGER

Specifies to inquire the transport layer trigger signal. INFO

 † k q
Combination constants for M_IO_STATUS_ALL.

You can add one of the following values to the above-mentioned value to specify the type of I/O signal to inquire.

function map For specifying the type of I/O signal to inquire
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_AUX_IO

Specifies to inquire all auxiliary signals.

 † c j k l m o p q r s
Collapse M_CC_IO

Specifies to inquire allCamera Link camera control signals.

 † j m p r

The following inquire types and inquire values allow you to inquire the bits in a static-user-output register. The user-bits are the bits associated with I/O signals set to output or output signals. For the correspondence between your MIL user-bits and the signal names, see the connectors and signal names section of the MIL Hardware-specific Notes chapter for your Matrox imaging board.

Note that for other Matrox imaging boards that have user-bits, but are not supported with the constants below, see MsysInquire().

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_INT.

function map For inquiring the state of specified user-bits in a static-user-output register
CollapseInquireType Description
MIL system-specific
tooltip (†)
UserVarPtr
- Possible values returned
Collapse M_USER_BIT_COUNT

Inquires the total number of bits in the static-user-output register.

(summarize)
† c j k l m o p q r s
Collapse Value

Specifies the number of bits in the default static-user-output register.

 † c j k l m o p q r s
Collapse M_USER_BIT_STATE +

Inquires the state of the specified bit in a static-user-output register. SET


You must specify a combination value from the following table:
(summarize)
† c j k l m o p q r s
Collapse M_OFF

Specifies that the specified bit is set to off.

 † c j k l m o p q r s
Collapse M_ON

Specifies that the specified bit is set to on.

 † c j k l m o p q r s
Collapse M_USER_BIT_STATE_ALL +

Inquires the state of all the bits in a static-user-output register. To change the type of static-user-output register (that is, from the main static-user-output register to a the camera control static-user-output register), use one of the combination values documented below. SET

(summarize)
† c j k l m o p q r s
Collapse UserVarPtr data type info

Data type: MIL_INT64

† c j k l m o p q r s
Collapse Value

Specifies a bit-encoded value that establishes the value of all the bits of the specified static-user-output register. INFO

 † c j k l m o p q r s
Combination constants for M_USER_BIT_STATE.

You must add one of the following values to the above-mentioned value to determine the bit in the static-user-output register.

function map For inquiring the bit in the static-user-output register
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_USER_BIT_CC_IOn

Specifies which bit of the camera control static-user-output register to inquire , where n is a value from 0 to 1. INFO

 † j m p r
Collapse M_USER_BIT_TL_TRIGGER0

Specifies to inquire the bit of the TL trigger static-user-output register.

 † k q
Collapse M_USER_BITn

Specifies to inquire bit n of the main static-user-output register. INFO

 † c j k l m o p q r s
Combination constants 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 inquire, if you don't want to inquire the main static-user-output register.

function map For inquiring the static-user-output register type to inquire
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_USER_BIT

Specifies to inquire all the bits in the main static-user-output register.

 † j k l m p q r
Collapse M_USER_BIT_CC_IO

Specifies to inquire all the bits in the static-user-output register associated with Camera Link camera control signals (the camera control static-user-output register).

 † j m p r
Collapse M_USER_BIT_TL_TRIGGER

Specifies to inquire all the bits in the static-user-output register associated with TL trigger signals (the TL trigger static-user-output register).

 † k q

The following inquire types and inquire values specify the settings for inquiring triggers. For more information, see the Grabbing with triggers section of Chapter 23: Grabbing with your digitizer.

[Matrox Morphis]

Triggered grabs are not supported on Matrox Morphis Quad.

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_INT.

function map For inquiring the settings to grab using a trigger
CollapseInquireType Description
MIL system-specific
tooltip (†)
UserVarPtr
- Possible values returned
Collapse M_GRAB_CONTINUOUS_END_TRIGGER +

Inquires whether an automatic trigger is generated after MdigHalt() is issued when performing a triggered continuous grab. SET

(summarize)
† c e f g h i j k l m n o p q r s
Collapse M_DISABLE

Specifies not to generate the trigger automatically. INFO

 † c e f g h i j k l m n o p q r s
Collapse M_ENABLE

Specifies to generate the trigger automatically. INFO

 † c e f g h i j k l m n o p q r s
Collapse M_GRAB_TRIGGER_ACTIVATION +

Inquires the signal transition upon which to generate a grab trigger. SET

(summarize)
† b c e f g j k l m o p q r s
MIL system specific

Note that this inquire type is IIDC camera specific. The camera must support the TRIGGER_MODE_INQ IIDC standard feature for this inquire type to be available on the camera. This inquire type is also available on the board.

 † e
Collapse 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
Collapse 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
Collapse 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
Collapse 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
Collapse 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
Collapse M_GRAB_TRIGGER_DELAY +

Inquires the delay between the trigger and the grab. SET

(summarize)
† c o s
Collapse UserVarPtr data type info

Data type: MIL_DOUBLE

† c o s
Collapse Value >= 0

Specifies the delay, in nsecs.

 † c o s
Collapse M_GRAB_TRIGGER_OVERLAP +

Inquires whether to allow the exposure phase of a triggered grab to occur while the image is still being transferred to the Host. SET

(summarize)
† c f o s
Collapse M_DISABLE

Specifies that a triggered grab will not overlap the transfer of the previous image. INFO

 † c f o s
Collapse M_ENABLE

Specifies that a triggered grab can overlap the transfer of the previous image.

 † c f o s
Collapse M_GRAB_TRIGGER_SOURCE +

Inquires the source for the grab trigger. SET

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

This inquire type is IIDC camera specific. The camera must support the TRIGGER_MODE IIDC standard feature for this inquire type to be supported.

 † e
Collapse M_AUX_IOn

Specifies to use auxiliary input signal n as the trigger source, where n is the number of the auxiliary signal. INFO

 † b c e f g j k l m o p q r s
Collapse M_HSYNC

Specifies to use the horizontal synchronization signal of the camera as the trigger source.

 † j l m p r
Collapse M_ROTARY_ENCODER

Specifies to use the output of the default rotary decoder (set with M_ROTARY_ENCODER_OUTPUT_MODE) as the trigger source. INFO

 † j k m p q r
Collapse M_ROTARY_ENCODERn

Specifies to use rotary decoder n, where n is a number between 1 and 4. INFO

 † k q
Collapse M_SOFTWARE

Specifies to use a software trigger as the trigger source. Use MdigControl() with 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
Collapse M_SOFTWAREn

Specifies to use the software trigger being used for the grab of another digitizer (on the same board) as the trigger source. INFO

 † k q
Collapse M_TIMERn

Specifies to use the output signal of the specified timer as the trigger source. INFO

 † c j k l m o p q r s
Collapse M_TL_TRIGGER

Specifies to use the transport layer trigger signal. INFO

 † k q
Collapse M_VSYNC

Specifies to use the vertical synchronization signal of the camera as the trigger source.

 † j l m p r
Collapse M_GRAB_TRIGGER_STATE +

Inquires whether, when a grab command is issued (for example, MdigGrab()), to wait for a trigger before grabbing. SET

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

Note that, by default when dealing with software triggers, this value is IIDC camera specific. The camera must support the TRIGGER_INQ IIDC standard feature for this inquire type to be available on the camera.

 † e

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

 † a
Collapse M_DISABLE

Specifies that, when a grab command is issued, the grab occurs without waiting for a trigger.

 † a b c e f g h i j k l m n o p q r s
Collapse 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
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e

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 turned on or off
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_MODE_CONTROL

Allows the IIDC camera-specific feature to be set to M_ON, M_OFF. INFO

 † e

The following inquire types and inquire values specify the settings for inquiring timers and the signals generated from a timer (timer output signals). For more information, see the Grabbing with triggers section of Chapter 23: Grabbing with your digitizer.

To specify which timer to inquire, see the For specifying which on-board timer to inquire combination value below.

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_INT.

function map For inquiring the settings of a timer
CollapseInquireType Description
MIL system-specific
tooltip (†)
UserVarPtr
- Possible values returned
Collapse M_TIMER_CLOCK_FREQUENCY +

Inquires the frequency of the clock that drives the specified timer.

(summarize)
† j k l m p q r
Collapse UserVarPtr data type info

Data type: MIL_DOUBLE

† j k l m p q r
Collapse 0

Specifies that the value cannot be inquired.

 † j k l m p q r
Collapse Value

Specifies the frequency of the clock source, in Hz.

 † j k l m p q r
Collapse M_TIMER_CLOCK_SOURCE +

Inquires the source of the clock that drives the specified timer. SET

(summarize)
† j k l m p q r
Collapse M_HSYNC

Specifies to use the horizontal synchronization frequency of your camera.

 † j k l m p q r
Collapse M_PIXCLK

Specifies to use the pixel clock frequency of your camera.

 † j k l m p q r
Collapse M_SYSCLK

Specifies to use the frequency of the allocated system's clock source. INFO

 † j k l m p q r
Collapse M_TIMERn

Specifies to use the frequency of the output of the specified timer, where n is the timer number. INFO

 † j k l m p q r
Collapse M_VSYNC

Specifies to use the vertical synchronization frequency of your camera.

 † j k l m p q r
Collapse M_TIMER_DELAY +

Inquires the delay between the timer trigger and the active portion of the timer output signal. SET

(summarize)
† c e f j k l m o p q r s
Collapse UserVarPtr data type info

Data type: MIL_DOUBLE

† c e f j k l m o p q r s
Collapse 0

Specifies the delay, in nsecs.

 † c f o s
Collapse Value > 0

Specifies the delay, in nsecs.

 † c e f j k l m o p q r s
Collapse M_TIMER_DURATION +

Inquires the duration for the active portion of the timer output signal. SET

(summarize)
† c e f j k l m o p q r s
Collapse UserVarPtr data type info

Data type: MIL_DOUBLE

† c e f j k l m o p q r s
Collapse M_INFINITE

Specifies to not set a limit on the duration of the active portion of the timer output signal. INFO

 † f
Collapse 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
Collapse M_TIMER_OUTPUT_INVERTER +

Inquires whether the output of the timer is inverted. SET

(summarize)
† f j k l m p q r
Collapse M_DISABLE

Specifies not to invert the output of the timer.

 † f j k l m p q r
Collapse M_ENABLE

Specifies to invert the output of the timer.

 † f j k l m p q r
Collapse M_TIMER_STATE +

Inquires the state of the specified timer. SET

(summarize)
† c e f j k l m o p q r s
Collapse M_DISABLE

Specifies that the timer is disabled.

 † c e f j k l m o p q r s
Collapse M_ENABLE

Specifies that the timer is enabled.

 † c e f j k l m o p q r s
Collapse M_TIMER_TRIGGER_ACTIVATION +

Inquires the signal variation upon which to generate a timer trigger, when the specified timer is enabled. SET

(summarize)
† c e j k l m o p q r s
Collapse 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
Collapse 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
Collapse 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
Collapse M_LEVEL_HIGH

Specifies that a timer trigger is continuously issued during a high signal polarity.

 † c o s
Collapse M_LEVEL_LOW

Specifies that a timer trigger is continuously issued during a low signal polarity.

 † c o s
Collapse M_TIMER_TRIGGER_MISSED +

Inquires whether to count the number of trigger pulses missed. SET

(summarize)
† f j k l m p q r
Collapse M_DISABLE

Specifies not to count the number of trigger pulses missed.

 † f j k l m p q r
Collapse M_ENABLE

Specifies to count the number of trigger pulses missed.

 † f j k l m p q r
Collapse M_TIMER_TRIGGER_RATE_DIVIDER +

Inquires the frequency with which to accept trigger pulses. SET

(summarize)
† j k l m p q r
Collapse 1; 2; 4; 8; 16

Specifies the frequency with which to accept a trigger out of a series of trigger pulses. INFO

 † j k l m p q r
Collapse M_TIMER_TRIGGER_SOURCE +

Inquires the trigger source for the specified timer output signal. SET

(summarize)
† c e f j k l m o p q r s
Collapse 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. INFO

 † c e j k l m o p q r s
Collapse M_CONTINUOUS

Specifies to run the specified timer in periodic mode; no actual trigger signal is used. INFO

 † c e j k l m o p q r s
Collapse M_EXPOSURE_END

Specifies to use the exposure end signal as the trigger source. INFO

 † c o s
Collapse M_EXPOSURE_START

Specifies to use the exposure start signal as the trigger source. INFO

 † c f o s
Collapse M_GRAB_TRIGGER

Specifies to use the grab trigger source signal as the trigger source. INFO

 † c f o s
Collapse M_HSYNC

Specifies to use the horizontal synchronization signal as the trigger source.

 † j l m p r
Collapse M_ROTARY_ENCODER

Specifies to use the output of the default rotary decoder (set with M_ROTARY_ENCODER_OUTPUT_MODE) as the trigger source. INFO

 † j k m p q r
Collapse M_ROTARY_ENCODERn

Specifies to use rotary decoder n, where n is a number between 1 and 4. INFO

 † k q
Collapse M_SOFTWARE

Specifies to use a software trigger as the trigger source. INFO

 † c e f j k l m o p q r s
Collapse M_TIMERn

Specifies to use the output signal of the specified timer as the trigger source, where n is the timer number. INFO

 † c e j k l m o p q r s
Collapse M_TL_TRIGGER

Specifies to use the transport layer trigger signal. INFO

 † k q
Collapse M_VSYNC

Specifies to use the vertical synchronization signal as the trigger source.

 † j l m p r

You can add one of the following values to the above-mentioned values to determine the largest or smallest value supported.

function map For determining the largest or smallest values supported
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_MAX_VALUE

Inquires the largest value supported.

 † c e f o s
Collapse M_MIN_VALUE

Inquires the smallest value supported.

 † c e f o s

You can add the following value to the above-mentioned values to specify which on-board timer to inquire.

function map For specifying which on-board timer to inquire
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_TIMERn

Inquires on-board timer n, where n is one of the timers available for your Matrox imaging board or MIL driver. INFO

 † c e f j k l m o p q r s

The following inquire types and inquire values specify the settings for inquiring the camera's exposure. For more information, see the Hardware-specific Notes for your Matrox Imaging board.

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.

function map For inquiring the camera's exposure
CollapseInquireType Description
MIL system-specific
tooltip (†)
UserVarPtr
- Possible values returned
Collapse M_AUTO_EXPOSURE +

Inquires the automatic exposure mode of the camera. SET

(summarize)
† c e o s
MIL system specific

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

 † e
Collapse UserVarPtr data type info

Data type: MIL_INT

† c e o s
Collapse M_AUTOMATIC

Specifies that the camera's exposure duration is constantly adapted by the device to maximize its effect.

 † c o s
Collapse M_DISABLE

Specifies that the camera will not control the gain, iris, and shutter settings automatically.

 † c o s
Collapse M_ENABLE

Specifies that the camera controls the gain, iris, and shutter settings automatically.

 † c o s
Collapse 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. INFO

 † e
Collapse M_ON

Specifies that the camera's gain, iris, and shutter features are turned on. INFO

 † e
Collapse Min. exposure <= Value <= Max. exposure

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

 † e
Collapse M_EXPOSURE_DELAY +

Inquires the required delay between the exposure trigger and the start of your camera's CCD being exposed. SET

(summarize)
† f
Collapse Value >= 0

Specifies the delay, in nsecs.

 † f
Collapse M_EXPOSURE_TIME +

Inquires the amount of time to expose the camera's CCD. SET

(summarize)
† c f o s
Collapse Value >= 0

Specifies the amount of time to expose the camera's CCD, in nsecs.

 † c f o s
Collapse M_SHUTTER +

Inquires the amount of time that the shutter will remain open.

Note that this inquire type is IIDC camera specific. The camera must support the SHUTTER IIDC standard feature for this inquire type to be supported. SET

(summarize)
† e
Collapse UserVarPtr data type info

Data type: MIL_INT

† e
Collapse M_OFF

Specifies that the camera's feature is turned off. INFO

 † e
Collapse M_ON

Specifies that the camera's feature is turned on. INFO

 † e
Collapse Min. shutter <= Value <= Max. shutter

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

 † e

You can add one of the following values to the above-mentioned values to specify whether the inquire type relates to the card or the board.

function map For specifying whether the inquire type relates to the card or the board
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_BOARD

Specifies that this is a value for your interface board and not the connected camera.

 † e
Collapse M_CAMERA

Specifies that this is a value for the connected camera and not your interface board. INFO

 † e

The following inquire types and inquire values allow you to inquire the settings of a rotary decoder.

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_INT.

function map For inquiring the settings of a rotary decoder
CollapseInquireType Description
MIL system-specific
tooltip (†)
UserVarPtr
- Possible values returned
Collapse M_ROTARY_ENCODER_BIT0_SOURCE +

Inquires the auxiliary input signal on which to receive bit 0 of the 2-bit Gray code. SET

(summarize)
† j k m p q r
Collapse M_AUX_IOn

Specifies the auxiliary input signal to use. INFO

 † j k m p q r
Collapse M_ROTARY_ENCODER_BIT1_SOURCE +

Inquires the auxiliary input signal on which to receive bit 1 of the 2-bit Gray code. SET

(summarize)
† j k m p q r
Collapse M_AUX_IOn

Specifies the auxiliary input signal to use. INFO

 † j k m p q r
Collapse M_ROTARY_ENCODER_DIRECTION +

Inquires the direction of movement occurring when the Gray code sequence received by the rotary decoder is 00 - 01 - 11 - 10; this essentially establishes if the counter increments or decrements when receiving this sequence. A forward direction increments; while a backward direction decrements. SET

(summarize)
† j k m p q r
Collapse 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
Collapse 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
Collapse M_ROTARY_ENCODER_FORCE_VALUE_SOURCE +

Inquires the signal source to use to set the rotary decoder's counter to 0xFFFFFFFF. SET

(summarize)
† j k m p q r
Collapse M_NULL

Specifies not to set the counter to 0xFFFFFFFF upon a signal.

 † j k m p q r
Collapse 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). INFO

 † j k m p q r
Collapse M_COUNTER_OVERFLOW

Specifies to keep the counter at 0xFFFFFFFF when incrementing from 0xFFFFFFFF to 0.

 † j k m p q r
Collapse 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
Collapse 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. INFO

 † j k m p q r
Collapse M_TL_TRIGGER

Specifies to use a transport layer trigger input signal.

 † k q
Collapse M_ROTARY_ENCODER_FRAME_END_POSITION +

Inquires the value of the rotary decoder's counter at the end of the last grab. To retrieve this value, you must have enabled the rotary decoder to store this value (before the grab), using MdigControl() with M_ROTARY_ENCODER_FRAME_END_READ. To retrieve the counter value at the end of the last grab from a hooked function, use MdigGetHookInfo() with M_ROTARY_ENCODER_FRAME_END_POSITION.

(summarize)
† j k m p q r
Collapse 0 <= Value <= 429496295

Specifies the value of the rotary decoder's counter at the end of the last grab.

 † j k m p q r
Collapse M_ROTARY_ENCODER_FRAME_END_READ +

Inquires if the rotary decoder is enabled 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 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. SET

(summarize)
† j k m p q r
Collapse 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
Collapse M_ENABLE

Specifies that the rotary decoder is enabled 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
Collapse M_ROTARY_ENCODER_MULTIPLIER +

Inquires the multiplying factor applied 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. SET

(summarize)
† j k m p q r
Collapse 0 <= Value <= 4096

Specifies the multiplying factor to use.

 † j k m p q r
Collapse M_ROTARY_ENCODER_OUTPUT_MODE +

Inquires 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. SET

(summarize)
† j k p q r
Collapse M_POSITION_TRIGGER

Specifies to output a pulse upon the trigger generated by M_ROTARY_ENCODER_POSITION_TRIGGER.

 † j k p q r
Collapse 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
Collapse 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. INFO

 † j k p q r
Collapse M_STEP_FORWARD

Specifies to output a pulse upon a rotary decoder counter increment only.

 † j k p q r
Collapse 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. INFO

 † j k p q r
Collapse M_ROTARY_ENCODER_POSITION +

Inquires the current value of the rotary decoder's counter.

(summarize)
† j k m p q r
Collapse 0 <= Value <= 429496295

Specifies the current value of the counter.

 † j k m p q r
Collapse M_ROTARY_ENCODER_POSITION_TRIGGER +

Inquires the rotary decoder's counter value upon which a trigger is generated. SET

(summarize)
† j k m p q r
Collapse 0 <= Value <= 0xFFFFFFFF

Specifies the value of the counter upon which a trigger is generated. INFO

 † j k m p q r
Collapse M_ROTARY_ENCODER_RESET_SOURCE +

Inquires the signal source to use to reset the rotary decoder's counter to 0. SET

(summarize)
† j k m p q r
Collapse M_NULL

Specifies not to reset using a hardware signal source.

 † j k m p q r
Collapse 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). INFO

 † j k m p q r
Collapse 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
Collapse M_TL_TRIGGER

Specifies to use a transport layer trigger input signal.

 † k q

You can add the following value to the above-mentioned values to specify which rotary decoder to inquire.

function map For specifying which rotary decoder to inquire
CollapseCombination value Description
MIL system-specific
tooltip (†)
Collapse M_ROTARY_ENCODERn

Specifies to inquire rotary decoder n, where n is a number between 1 and 4. INFO

 † k q
Return value
The returned value is typically the requested information, cast to a MIL_INT. If the requested information is an array of type MIL_TEXT_CHAR, the returned value is M_NULL.
Compilation information
Header Include mil.h.
Library Use mil.lib.
DLL Requires mil.dll.
BAYER COEFFICIENTS ID NULL BAYER CONVERSION DISABLE ENABLE BAYER PATTERN NULL BAYER BG BAYER GB BAYER GR BAYER RG BOARD REVISION CAMERA COLOR LOCK DISABLE ENABLE CAMERA COLOR LOCKED NO YES CAMERA LOCK DISABLE ENABLE CAMERA LOCK SENSITIVITY CAMERA LOCKED NO YES CAMERA MODEL CAMERA MODEL SIZE CAMERA PRESENT NO YES CAMERA UNLOCK SENSITIVITY CAMERA VENDOR CAMERA VENDOR SIZE CAPTURE QUALITY OFF ON CAPTURE SIZE OFF ON CHANNEL CH0 CH1 CH2 CH3 CH4 CH5 CH6 CH7 CH8 CH9 CH10 CH11 CH12 CH13 CH14 CH15 CHANNEL NUM CHANNEL SYNC CHn COMMAND QUEUE MODE IMMEDIATE QUEUED CORRUPTED FRAME ERROR DISABLE ENABLE DIG PROCESS IN PROGRESS FALSE TRUE DIGITIZER INTERNAL BUFFERS NUM DIGITIZER TYPE IRIS M GT300 IRIS M GT1200 IRIS M GT1900 IRIS M GT5000 EFFECTIVE SIZE BIT EXTENDED INIT FLAG DEFAULT DEV NUMBER EMULATED GC DEVICE IP ADDRESS GC DEVICE USER NAME MINIMAL FOCUS OFF ON FORMAT NULL CCIR" DEFAULT" DEFAULT 1394" NTSC" NTSC RGB" NTSC YC" PAL" PAL RGB" PAL YC" RS170" xXy data FORMAT 7 z" xXy data[@z[FPS]]" FORMAT7 TILE SIZE X FORMAT7 TILE SIZE Y FORMAT DETECTED FORMAT DETECTED SIZE FORMAT SIZE FORMAT SUPPORTED DEFAULT" DEFAULT 1394" NTSC" RS170" xXy data FORMAT 7 z" xXy data[@z[FPS]]" FORMAT SUPPORTED NUM FORMAT SUPPORTED SIZE GAMMA OFF ON GC CLPROTOCOL DISABLE ENABLE GC CLPROTOCOL DEVICE ID GC CLPROTOCOL DEVICE ID DEFAULT GC CLPROTOCOL DEVICE ID NUM GC CLPROTOCOL DEVICE ID SIZE MAX GC COUNTER TICK FREQUENCY GC FEATURE POLLING DISABLE ENABLE GC FRAME MAX RETRIES GC PACKET MAX RETRIES GC FRAME STATUS CODE GC FRAME TIMEOUT GC FRAME TIMESTAMP GC HEARTBEAT STATE DISABLE ENABLE GC HEARTBEAT TIMEOUT GC INTER PACKET DELAY GC INTERFACE NAME GC INTERFACE NAME SIZE GC IP ADDRESS STRING GC IP ADDRESS STRING SIZE GC MAC ADDRESS STRING GC MAC ADDRESS STRING SIZE GC MAX NBR PACKETS OUT OF ORDER GC MESSAGE CHANNEL MULTICAST ADDRESS STRING GC MESSAGE CHANNEL MULTICAST ADDRESS STRING SIZE GC MESSAGE PORT GC MULTICAST MASTER CONNECTED FALSE TRUE GC NIC IP ADDRESS STRING GC NIC IP ADDRESS STRING SIZE GC NIC MAC ADDRESS STRING GC NIC MAC ADDRESS STRING SIZE GC NUMBER OF STREAM CHANNELS GC PACKET MAX RETRIES GC FRAME MAX RETRIES GC PACKET RESEND DISABLE ENABLE GC PACKET SIZE GC PACKET TIMEOUT GC PAYLOAD SIZE GC PIXEL FORMAT GC PIXEL FORMAT SWITCHING DISABLE ENABLE GC SCHEMA MAJOR GC SCHEMA MINOR GC SERIAL NUMBER GC SERIAL NUMBER SIZE GC SPECIFIC INFO GC SPECIFIC INFO SIZE GC STREAM CHANNEL MULTICAST ADDRESS STRING GC STREAM CHANNEL MULTICAST ADDRESS STRING SIZE GC STREAM PORT GC STREAMING MODE AUTOMATIC MANUAL GC STREAMING STOP CHECK PERIOD GC STREAMING STOP DELAY GC THEORETICAL INTER PACKET DELAY GC TOTAL FRAME CACHE HITS GC TOTAL FRAMES CORRUPTED GC TOTAL FRAMES GRABBED GC TOTAL FRAMES MISSED GC TOTAL PACKET CACHE HITS GC TOTAL PACKETS MISSED GC TOTAL PACKETS RECEIVED GC TOTAL PACKETS RECEIVED OUT OF ORDER GC TOTAL PACKETS RECOVERED GC TOTAL PACKETS RESENDS NUM GC TOTAL PACKETS TIMEOUT GC UNIQUE ID STRING GC UNIQUE ID STRING SIZE GC USER NAME GC USER NAME SIZE GC VERSION GC VERSION SIZE GC XML MAJOR GC XML MINOR GC XML PATH GC XML PATH SIZE GC XML SUBMINOR GRAB DIRECTION X FORWARD REVERSE GRAB DIRECTION Y FORWARD REVERSE GRAB FAIL CHECK DISABLE ENABLE FINAL GRAB GRAB FAIL RETRY NUMBER GRAB FAIL STATUS NO YES GRAB FIELD NUM GRAB FRAME MISSED GRAB FRAME MISSED COUNTER DISABLE ENABLE GRAB IN PROGRESS NO YES GRAB LINE COUNTER DISABLE ENABLE GRAB MODE ASYNCHRONOUS ASYNCHRONOUS QUEUED SYNCHRONOUS GRAB PERIOD GRAB SCALE INTERPOLATION MODE AVERAGE BICUBIC BILINEAR NEAREST NEIGHBOR GRAB SCALE X FILL DESTINATION GRAB SCALE Y FILL DESTINATION GRAB START MODE FIELD START FIELD START EVEN FIELD START ODD GRAB TIMEOUT INFINITE HARDWARE DEINTERLACING BOB METHOD DISABLE MADI METHOD HOOK MASTER THREAD HANDLE HOOK MASTER THREAD ID INPUT FILTER AUTOMATIC BYPASS LOW PASS 0 LOW PASS 1 INPUT MODE ANALOG DIGITAL IRIS OFF ON LAST GRAB IN TRUE BUFFER DISABLE ENABLE LIGHTING BRIGHT FIELD LIGHTING BRIGHT FIELD HIDRIVE DISABLE ENABLE LIGHTING BRIGHT FIELD HIDRIVE TIME LIGHTING BRIGHT FIELD OFFSET DISABLE ENABLE LUT ID NUMBER DEVn OPTICAL FILTER OFF ON OWNER SYSTEM PAN OFF ON POWER OVER CABLE PROCESS FRAME CORRUPTED PROCESS FRAME COUNT PROCESS FRAME MISSED PROCESS FRAME RATE PROCESS GRAB MONITOR DISABLE ENABLE PROCESS PENDING GRAB NUM PROCESS TIMEOUT INFINITE PROCESS TOTAL BUFFER NUM SCAN MODE INTERLACE LINESCAN PROGRESSIVE SELECTED FRAME RATE SERIAL NUMBER SERIAL NUMBER 0 SERIAL NUMBER 1 SERIAL NUMBER SIZE SHADING CORRECTION DISABLE ENABLE SHADING CORRECTION GAIN ID SHADING CORRECTION OFFSET ID SHARPNESS OFF ON SIGN SIGNED UNSIGNED SIZE BAND SIZE BAND LUT SIZE BIT SIZE X SIZE Y SOURCE COMPENSATION DISABLE ENABLE SOURCE DATA FORMAT PACKED PLANAR SOURCE OFFSET X SOURCE OFFSET Y SOURCE SIZE X SOURCE SIZE Y TARGET TEMPERATURE OFF ON TILT OFF ON TYPE SIGNED UNSIGNED VIDEO OUTPUT NULL CHn WHITE BALANCE CALCULATE DISABLE ENABLE WHITE BALANCE U OFF ON WHITE BALANCE V OFF ON ZOOM OFF ON FAST CHn GC PACKET SIZE NEGOTIATION SKIP GC XML DOWNLOAD SKIP GC XML FORCE DOWNLOAD GC MULTICAST MASTER GC MULTICAST MONITOR GC MULTICAST SLAVE MONO8 MONO16 BGR24 BGR32 RGB15 RGB16 RGB24 RGB48 YUV16 YUV16 UYVY YUV16 YUYV YUV411 1394 YUV444 ANTIALIASING DITHERING BLACK REF BRIGHTNESS OFF ON BRIGHTNESS REF CONTRAST REF HUE OFF ON HUE REF SATURATION OFF ON SATURATION REF WHITE REF ALL REF CH0 REF CH1 REF CH2 REF CH3 REF VOLTAGE GAIN OFF ON GRAB AUTOMATIC INPUT GAIN DISABLE ENABLE GRAB INPUT GAIN GAIN0 GAIN1 GAIN2 GAIN3 MAX LEVEL MIN LEVEL CHROMINANCE LUMINANCE AUX IO COUNT AUX IO COUNT IN AUX IO COUNT OUT CC IO COUNT OUT IO FORMAT DISABLE LVDS OPEN DRAIN OPTO RS422 TRI STATE TTL IO INTERRUPT ACTIVATION ANY EDGE EDGE FALLING EDGE RISING IO INTERRUPT STATE DISABLE ENABLE IO MODE INPUT OUTPUT IO SOURCE AUX IOn DISABLE HSYNC PIXCLK TIMERn TL TRIGGER USER BIT CC IOn USER BIT TL TRIGGER USER BITn VSYNC IO STATUS INVALID OFF ON UNKNOWN IO STATUS ALL TL TRIGGER COUNT TL TRIGGER COUNT IN TL TRIGGER COUNT OUT AUX IOn CC IOn TL TRIGGER AUX IO CC IO USER BIT COUNT 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 DISABLE ENABLE GRAB TRIGGER ACTIVATION ANY EDGE EDGE FALLING EDGE RISING LEVEL HIGH LEVEL LOW GRAB TRIGGER DELAY GRAB TRIGGER OVERLAP DISABLE ENABLE GRAB TRIGGER SOURCE AUX IOn HSYNC ROTARY ENCODER ROTARY ENCODERn SOFTWARE SOFTWAREn TIMERn TL TRIGGER VSYNC GRAB TRIGGER STATE DISABLE ENABLE OFF ON MODE CONTROL TIMER CLOCK FREQUENCY TIMER CLOCK SOURCE HSYNC PIXCLK SYSCLK TIMERn VSYNC TIMER DELAY TIMER DURATION INFINITE TIMER OUTPUT INVERTER DISABLE ENABLE TIMER STATE DISABLE ENABLE TIMER TRIGGER ACTIVATION ANY EDGE EDGE FALLING EDGE RISING LEVEL HIGH LEVEL LOW TIMER TRIGGER MISSED DISABLE ENABLE TIMER TRIGGER RATE DIVIDER TIMER TRIGGER SOURCE AUX IOn CONTINUOUS EXPOSURE END EXPOSURE START GRAB TRIGGER HSYNC ROTARY ENCODER ROTARY ENCODERn SOFTWARE TIMERn TL TRIGGER VSYNC MAX VALUE MIN VALUE TIMERn AUTO EXPOSURE AUTOMATIC DISABLE ENABLE OFF ON EXPOSURE DELAY EXPOSURE TIME SHUTTER OFF ON BOARD CAMERA ROTARY ENCODER BIT0 SOURCE AUX IOn ROTARY ENCODER BIT1 SOURCE AUX IOn ROTARY ENCODER DIRECTION BACKWARD FORWARD ROTARY ENCODER FORCE VALUE SOURCE NULL AUX IOn COUNTER OVERFLOW POSITION TRIGGER STEP BACKWARD WHILE POSITIVE TL TRIGGER ROTARY ENCODER FRAME END POSITION ROTARY ENCODER FRAME END READ DISABLE ENABLE ROTARY ENCODER MULTIPLIER ROTARY ENCODER OUTPUT MODE 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 NULL AUX IOn POSITION TRIGGER TL TRIGGER ROTARY ENCODERn