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

MdigInquire



Function Map
Parameter Associations
Table: For the general digitizer settings
+ combination: For specifying the speed and precision of the interpolation
+ 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
+ combination: For getting the string size
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 and shading correction
+ combination: For specifying the acquisition path
+ 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 which I/O command register bit to use
Table: For inquiring frame burst settings
Table: For inquiring the settings of a timer
Table: For inquiring the camera's exposure
+ combination: For determining the largest or smallest values supported
Table: For inquiring the settings of a rotary decoder
+ combination: For specifying which rotary decoder to inquire
Table: For inquiring a data latch
+ combination: For specifying the data latch to inquire
+ combination: For specifying which on-board timer to inquire
Table: For inquiring your GigE Vision camera's optional settings
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 Feature Browser; to access this interface, use Matrox Intellicam or MdigControl() with M_GC_FEATURE_BROWSER.

[Matrox GenTL driver (Update 34); Matrox GigE Vision driver (introduced M10); Matrox USB3 Vision driver (Update 19)]

Typically, the supported inquire types inquire the GenICam-compliant camera (or device) associated with the digitizer. These inquire types assume your camera supports the associated GenICam standard feature naming convention (SFNC) feature. If the device does not support the associated GenICam SFNC feature, an error is generated. In case of error, use MdigInquireFeature() with the device-specific feature names and values specified by the device manufacturer.

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 25: 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 [optionally, in C++: a reference to a MIL_STRING]
  • MIL_DOUBLE
  • MIL_ID
  • MIL_INT
  • MIL_INT64

Specifies the address in which to write the requested information. Since the MdigInquire() function also returns the requested information, you can set this parameter to M_NULL.

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

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

function map For the general digitizer settings
Click to summarize
InquireType
Description MIL system-specific
tooltip (‡)
UserVarPtr
- Possible values returned
Click to summarize 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
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa
MIL system specific

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

k
M10
m p r
U27
y
U75
aa

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
M10
o v

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 color versions of Matrox Iris GTR (such as 1300C).

t
U28
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_ID
c
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_NULL

Specifies that you have set M_WHITE_BALANCE to M_DISABLE.

c
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa
Click to summarize MIL array buffer identifier

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

c
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_BAYER_CONVERSION

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

(summarize)
c
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa
MIL system specific

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

k
M10
m p r
U27
y
U75
aa

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
M10
o v

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 color versions of Matrox Iris GTR (such as 1300C).

t
U28
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_DISABLE

Specifies to not perform Bayer conversion on the grabbed image.

c
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_ENABLE

Specifies to perform Bayer conversion on the grabbed image. INFO

c
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_BAYER_PATTERN

Inquires the Bayer pattern used by the camera.

(summarize)
c
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa
MIL system specific

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

k
M10
m y
U75

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

c
M10
o v

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 color versions of Matrox Iris GTR (such as 1300C).

t
U28
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_NULL

Specifies that no Bayer pattern is used by the camera.

c
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa
Click to summarize 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
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa
Click to summarize 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
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa
Click to summarize 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
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa
Click to summarize 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
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_BOARD_REVISION

Inquires the revision number of your digitizer.

(summarize)
t
U28
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
t
U28
Click to summarize Value

Specifies the revision number.

t
U28
Click to summarize 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)
g
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
g
Click to summarize M_DISABLE

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

g
Click to summarize M_ENABLE

Specifies that a color-lock check will be done.

g
Click to summarize 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)
g h
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
g h
Click to summarize M_NO

Specifies that color-lock is not active.

g h
Click to summarize M_YES

Specifies that color-lock is active.

g h
Click to summarize M_CAMERA_LOCK

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

(summarize)
g l
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
g l
Click to summarize M_DISABLE

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

g l
Click to summarize M_ENABLE

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

g l
Click to summarize 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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
g
Click to summarize 0 <= Value <= 511

Specifies the camera line-lock sensitivity level. INFO

g
Click to summarize M_CAMERA_LOCKED

Inquires whether the digitizer is locked to the camera.

(summarize)
a g h i l u
U36
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a g h i l u
U36
Click to summarize M_NO

Specifies that a camera lock failed.

a g h i l u
U36
Click to summarize M_YES

Specifies that a camera lock succeeded.

a g h i l u
U36
Click to summarize M_CAMERA_MODEL +

Inquires the name of the camera model.

(summarize)
c
M10
o v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
c
M10
o v
Click to summarize Value

Specifies the name of the camera model.

c
M10
o v
Click to summarize M_CAMERA_PRESENT

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

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
y
U75
aa
Click to summarize M_NO

Specifies that no camera is present.

a c
M10
g h i j k
M10
l m o p r
U27
u
U36
y
U75
aa
Click to summarize M_YES

Specifies that a camera is present.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
y
U75
aa
Click to summarize 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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
g
Click to summarize 0 <= Value <= 255

Specifies the camera line-unlock sensitivity level. INFO

g
Click to summarize M_CAMERA_VENDOR +

Inquires the name of the camera vendor.

(summarize)
c
M10
o v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
c
M10
o v
Click to summarize "String"

Specifies the name of the camera vendor.

c
M10
o v
Click to summarize 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)
g i l u
U36
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
g i l u
U36
Click to summarize M_CH0

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

g i l u
U36
Click to summarize M_CH1

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

g i l u
U36
Click to summarize M_CH2

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

g i u
U36
Click to summarize M_CH3

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

g
Click to summarize M_CH4

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

g
Click to summarize M_CH5

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

g
Click to summarize M_CH6

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

g
Click to summarize M_CH7

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

g
Click to summarize M_CH8

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

g
Click to summarize M_CH9

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

g
Click to summarize M_CH10

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

g
Click to summarize M_CH11

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

g
Click to summarize M_CH12

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

g
Click to summarize M_CH13

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

g
Click to summarize M_CH14

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

g
Click to summarize M_CH15

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

g
Click to summarize M_CHANNEL_NUM

Inquires the number of available channels on the digitizer.

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize Value

Specifies the number of channels.

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
MIL system specific

Matrox Iris GT has 1 channel.

t
U28
Click to summarize 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)
g h i l o u
U36
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
g h i l o u
U36
Click to summarize M_CHn

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

g h i l o u
U36
Click to summarize 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
M10
l m p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
l m p r
U27
y
U75
aa
Click to summarize M_IMMEDIATE

Specifies that, if you change the setting of a control type of a digitizer currently being used in a grab, the change affects the current grab. INFO

j k
M10
l m p r
U27
y
U75
aa
Click to summarize M_QUEUED

Specifies that, if you change the setting of a control type of a digitizer currently being used in a grab, the change does not affect the current grab. INFO

j k
M10
l m p r
U27
y
U75
aa
Click to summarize M_CORRUPTED_FRAME_ERROR

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

(summarize)
c
M10
i o t
U28
u
U36
v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
i o t
U28
u
U36
v
Click to summarize M_DISABLE

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

c
M10
i o t
U28
u
U36
v
Click to summarize M_ENABLE

Specifies to generate an error when grabbing a corrupted frame.

c
M10
i o t
U28
u
U36
v
Click to summarize M_DIG_PROCESS_IN_PROGRESS

Inquires whether MdigProcess() is currently running.

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_FALSE

MdigProcess() is not running.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_TRUE

MdigProcess() is running.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize 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
M10
o v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
o v
Click to summarize Value >= 0

Specifies the number of internal grab buffers.

c
M10
o v
Click to summarize 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)
t
U28
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
t
U28
Click to summarize M_300

Specifies a Matrox Iris GTR 300.

t
U28
Click to summarize M_300C

Specifies a Matrox Iris GTR 300C.

t
U28
Click to summarize M_1300

Specifies a Matrox Iris GTR 1300.

t
U28
Click to summarize M_1300C

Specifies a Matrox Iris GTR 1300C.

t
U28
Click to summarize M_2000

Specifies a Matrox Iris GTR 2000.

t
U28
Click to summarize M_2000C

Specifies a Matrox Iris GTR 2000C.

t
U28
Click to summarize M_5000

Specifies a Matrox Iris GTR 5000.

t
U28
Click to summarize M_5000C

Specifies a Matrox Iris GTR 5000C.

t
U28
Click to summarize M_EXTENDED_INIT_FLAG

Inquires the digitizer initialization flag. SET

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_DEFAULT

Specifies the default value. INFO

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_DEV_NUMBER +

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

c
M10
o v
Click to summarize M_EMULATED

Specifies that the digitizer was allocated as a simulated digitizer.

a
Click to summarize M_GC_DEVICE_IP_ADDRESS +

Specifies that the digitizer was allocated for theMdigAlloc. INFO

c
M10
v
Click to summarize M_GC_DEVICE_NAME +

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

c
M10
o v
Click to summarize M_MINIMAL

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

i u
U36
Click to summarize M_FIX_PATTERN_NOISE_CORRECTION

Inquires the type of fixed pattern noise correction to apply when acquiring images. SET

(summarize)
t
U28
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
t
U28
Click to summarize M_PREPROCESSING

Specifies a correction for dark signal non-uniformity and for photo response non-uniformity, applied to the grabbed images. INFO

t
U28
Click to summarize M_SENSOR

Specifies a correction for dark signal non-uniformity, applied to the grabbed images. INFO

t
U28
Click to summarize M_FOCUS +

Inquires the lens focus capabilities.

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

(summarize)
t
U28
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
t
U28
Click to summarize Min. focus <= Value <= Max. focus

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

t
U28
Click to summarize M_FOCUS_PERSISTENCE

Sets whether to store a focus position for the I 2 C (inter-integrated circuit) controlled lens. If there is no I 2 C (inter-integrated circuit) controlled lens attached, the value is ignored. SET

(summarize)
t
U28
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
t
U28
Click to summarize M_DISABLE

Specifies to not store the focus position.

t
U28
Click to summarize M_ENABLE

Specifies to store the focus position.

t
U28
Click to summarize M_FOCUS_PERSISTENT_VALUE

Inquires the focus position to store for the I 2 C (inter-integrated circuit) controlled lens. SET

(summarize)
t
U28
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
t
U28
Click to summarize 0 <= Value <= 1023

Specifies to store the focus position.

t
U28
Click to summarize M_FORMAT +

Inquires the digitizer data format. SET

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_NULL
//For monochrome or color cameras.

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

c
M10
v
Click to summarize 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

c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize MIL_TEXT("M_CCIR") 1
//For monochrome cameras.

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

g h l
Click to summarize MIL_TEXT("M_DEFAULT") 1
//For monochrome or color cameras.

Specifies the default digitizer format. INFO

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize MIL_TEXT("M_NTSC") 1
//For color cameras.

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

g h
Click to summarize MIL_TEXT("M_NTSC_RGB") 1
//For color cameras.

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

l
Click to summarize MIL_TEXT("M_NTSC_YC") 1
//For color cameras.

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

g
Click to summarize MIL_TEXT("M_PAL") 1
//For color cameras.

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

g h
Click to summarize MIL_TEXT("M_PAL_RGB") 1
//For color cameras.

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

l
Click to summarize MIL_TEXT("M_PAL_YC") 1
//For color cameras.

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

g
Click to summarize MIL_TEXT("M_RS170") 1
//For monochrome cameras.

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

g h l
Click to summarize M_FORMAT_DETECTED +

Inquires the detected DCF name.

(summarize)
i u
U36
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
i u
U36
Click to summarize Value

Specifies the detected DCF name.

i u
U36
Click to summarize M_GC_CAMERA_TIME_STAMP

Inquires the timestamp from the camera.

To inquire the timestamp of an event, use MdigGetHookInfo() with M_GC_CAMERA_TIME_STAMP.

(summarize)
c
U25
v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
c
U25
v
Click to summarize Value

Specifies the timestamp from the camera, in seconds.

c
U25
v
Click to summarize M_GC_CLPROTOCOL

Inquires whether the GenICam CLProtocol module is enabled.

Note that this inquire type is only available if using a GenCP-compatible camera, or if you first install the third-party, vendor-supplied, standard compliant CLProtocol library for the Camera Link camera connected to your digitizer. SET

(summarize)
j m p r
U27
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j m p r
U27
aa
Click to summarize M_DISABLE

Specifies that the GenICam CLProtocol module is disabled.

j m p r
U27
aa
Click to summarize M_ENABLE

Specifies that the GenICam CLProtocol module is enabled.

j m p r
U27
aa
Click to summarize M_GC_CLPROTOCOL_DEVICE_ID +

Inquires the identifier of the GenICam CLProtocol library currently associated with the Camera Link camera.

Note that this inquire type is only available if using a GenCP-compatible camera, or if you first install the third-party, vendor-supplied, standard compliant CLProtocol library for the Camera Link camera connected to your digitizer. SET


You must specify a combination value from the following table:
(summarize)
j m p r
U27
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
j m p r
U27
aa
Click to summarize M_GC_CLPROTOCOL_DEVICE_ID_DEFAULT +

Inquires the identifier of the GenICam CLProtocol library currently set as the default in the MilConfig utility. If no default has been set in the MilConfig utility, this will cause an error.

Note that this inquire type is only available if using a GenCP-compatible camera, or if you first install the third-party, vendor-supplied, standard compliant CLProtocol library for the Camera Link camera connected to your digitizer.

(summarize)
j m p r
U27
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
j m p r
U27
aa
Click to summarize 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 25: Grabbing with your digitizer.

Note that this inquire type is only available if using a GenCP-compatible camera, or if you first install the third-party, vendor-supplied, standard compliant CLProtocol library for the Camera Link camera connected to your digitizer.

(summarize)
j m p r
U27
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j m p r
U27
aa
Click to summarize Value

Specifies the number of the GenICam CLProtocol libraries.

j m p r
U27
aa
Click to summarize 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 25: Grabbing with your digitizer.

Note that this inquire type is only available if using a GenCP-compatible camera, or if you first install the third-party, vendor-supplied, standard compliant CLProtocol library for the Camera Link camera connected to your digitizer.

(summarize)
j m p r
U27
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j m p r
U27
aa
Click to summarize Value

Specifies the maximum number of characters required.

j m p r
U27
aa
Click to summarize 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
M10
o v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
c
M10
o v
Click to summarize Value

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

c
M10
o v
Click to summarize M_GC_FEATURE_POLLING

Inquires whether specific camera features will be periodically polled for updates when Matrox Feature Browser, accessed through Matrox Intellicam or MdigControl() with M_GC_FEATURE_BROWSER, is open. SET

(summarize)
c
M10
j k
M10
m o p r
U27
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
m o p r
U27
v y
U75
aa
Click to summarize M_DISABLE

Specifies that automatically changing camera features will not be polled.

c
M10
j k
M10
m o p r
U27
v y
U75
aa
Click to summarize M_ENABLE

Specifies that automatically changing camera features will be polled.

c
M10
j k
M10
m o p r
U27
v y
U75
aa
Click to summarize 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
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
Click to summarize Value >= M_GC_PACKET_MAX_RETRIES

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

c
M10
Click to summarize M_GC_FRAME_STATUS_CODE

Inquires the status code from the last grabbed image.

(summarize)
c
M10
o
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
o
Click to summarize Value

Specifies the status code.

c
M10
o
Click to summarize 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
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
Click to summarize Value >= 0

Specifies the maximum time to wait, in msec.

c
M10
Click to summarize M_GC_FRAME_TIMESTAMP

Inquires the timestamp of the last frame grabbed.

(summarize)
c
M10
o v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
c
M10
o v
Click to summarize Value

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

c
M10
o v
Click to summarize M_GC_HEARTBEAT_STATE

Inquires whether the heartbeat mechanism is used to keep the GigE Vision-compliant camera active. SET

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
Click to summarize M_DISABLE

Specifies that the heartbeat mechanism is disabled. INFO

c
M10
Click to summarize M_ENABLE

Specifies that the heartbeat mechanism is enabled. INFO

c
M10
Click to summarize M_GC_HEARTBEAT_TIMEOUT

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

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
Click to summarize Value >= 0

Specifies the amount of time, in msec.

c
M10
Click to summarize 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 sec, use the following calculation to convert from timestamp ticks to sec: (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
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
Click to summarize Value >= 0

Specifies the delay, in timestamp ticks.

c
M10
Click to summarize M_GC_INTERFACE_NAME +

Inquires the name of the Host interface, such as the Ethernet controller or frame grabber, to which your camera is connected.

(summarize)
c
M10
v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
c
M10
v
Click to summarize M_GC_LOCAL_CONTROL_PORT

Inquires the UDP port number used for the GVCP (GigE Vision Control Protocol) channel on the computer connected to your GigE Vision-compliant camera.

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
Click to summarize 0 <= Value <=66535

Specifies the port number.

c
M10
Click to summarize M_GC_LOCAL_IP_ADDRESS

Inquires the IP address (IPv4) of the Host's network adapter, connected to the GigE Vision-compliant camera.

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
c
M10
Click to summarize Value

Specifies the IP address (IPv4) of the Host's network adapter, connected to the GigE Vision-compliant camera.

The IP address is stored as a 32-bit integer in a MIL_INT64. Typically, IP addresses are written as 4 separate 8-bit numbers. To retrieve these values, either inquire the IP address as a string instead using M_GC_LOCAL_IP_ADDRESS_STRING, or map the 32-bit IP address to 4 MIL_UINT8 variables.

For example, the hexadecimal representation of the IP address 192.168.109.72 is 0x00000000486da8c0 (equivalent to the decimal 1215146176). The least-significant byte (c0) is the first number of the IP address (192), the second least-significant byte (a8) is the second number of the IP address (168) and so on. The first 8 digits (4 most-significant bytes) are not part of the IP address.

(summarize)
c
M10
Click to summarize M_GC_LOCAL_IP_ADDRESS_STRING +

Inquires the IP address of the Host's network adapter, connected to the GigE Vision-compliant camera, as a string.

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
c
M10
Click to summarize MIL_TEXT("nnn.nnn.nnn.nnn") 1

Specifies the IP address of the Host's network adapter, connected to the GigE Vision-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
M10
Click to summarize M_GC_LOCAL_MAC_ADDRESS

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

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
c
M10
Click to summarize Value

Specifies the MAC address of the Host's network adapter, connected to the GigE Vision-compliant camera.

The MAC address is stored as a 48-bit integer in a MIL_INT64. Typically, MAC addresses are written as 6 separate 8-bit numbers (hexadecimal number pairs). To retrieve these numbers, either inquire the MAC address as a string instead using M_GC_LOCAL_MAC_ADDRESS_STRING, or map the 48-bit MAC address to 6 MIL_UINT8 variables.

For example, the stored representation of the MAC address 84:20:fc:33:0e:e9 is 0x0000e90e33fc2084. The least-significant byte (84) is the first number of the MAC address, the second least-significant byte (0e) is the second number of the MAC address and so on. The first 4 hexadecimal digits (2 most significant bytes) are not part of the MAC address.

(summarize)
c
M10
Click to summarize M_GC_LOCAL_MAC_ADDRESS_STRING +

Inquires the MAC address of the Host's network adapter, connected to the GigE Vision-compliant camera, as a string.

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
c
M10
Click to summarize MIL_TEXT("nn-nn-nn-nn-nn-nn") 1

Specifies the MAC address of the Host's network adapter, connected to the GigE Vision-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
M10
Click to summarize M_GC_LOCAL_MESSAGE_PORT

Inquires the UDP port number used for the message channel on the computer connected to your GigE Vision-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
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
Click to summarize 0 <= Value <=66535

Specifies the port number.

c
M10
Click to summarize M_GC_LOCAL_STREAM_PORT

Inquires the UDP port number used for the GVSP (GigE Vision Stream Protocol) channel on the computer connected to your GigE Vision-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
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
Click to summarize 0 <= Value <=66535

Specifies the port number.

c
M10
Click to summarize 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
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
Click to summarize Value >= 0

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

c
M10
Click to summarize M_GC_MESSAGE_CHANNEL_MULTICAST_ADDRESS_STRING +

Inquires the IP address used for the multicast message channel of your GigE Vision-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
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
c
M10
Click to summarize MIL_TEXT("2nn.nnn.nnn.nnn") 1

Specifies the IP address in dotted decimal notation.

c
M10
Click to summarize M_GC_MULTICAST_MASTER_CONNECTED

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

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
Click to summarize M_FALSE

Specifies that a multicast master is not connected to the GigE Vision-compliant camera.

c
M10
Click to summarize M_TRUE

Specifies that a multicast master is connected to the GigE Vision-compliant camera.

c
M10
Click to summarize M_GC_NUMBER_OF_STREAM_CHANNELS

Inquires the number of image streams available.

(summarize)
c
M10
o v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
o v
Click to summarize Value

Specifies the number of image streams available.

c
M10
o v
Click to summarize M_GC_PACKET_MAX_RETRIES

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

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
Click to summarize Value >= M_GC_FRAME_MAX_RETRIES

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

c
M10
Click to summarize M_GC_PACKET_RESEND

Inquires whether to request packets be re-sent from your GigE Vision-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
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
Click to summarize M_DISABLE

Specifies that packets should never be re-sent.

c
M10
Click to summarize M_ENABLE

Specifies that packets should be re-sent as required.

c
M10
Click to summarize 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
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
Click to summarize Value >= 0

Specifies the packet size, in bytes. INFO

c
M10
Click to summarize M_GC_PACKET_TIMEOUT

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

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
Click to summarize Value >= 0

Specifies the maximum time to wait, in msec.

c
M10
Click to summarize 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
M10
o v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
o v
Click to summarize Value

Specifies the number of bytes transferred per image or chunk.

c
M10
o v
Click to summarize 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
M10
v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
v
Click to summarize Value

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

c
M10
v
Click to summarize M_GC_PIXEL_FORMAT_STRING +

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, expressed in a human readable format. SET

(summarize)
c
M10
v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
c
M10
v
Click to summarize 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
M10
o v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
o v
Click to summarize M_DISABLE

Specifies to disable automatic pixel format switching.

c
M10
o v
Click to summarize M_ENABLE

Specifies to enable automatic pixel format switching.

c
M10
o v
Click to summarize M_GC_REMOTE_CONTROL_PORT

Inquires the UDP port number used for the GVCP (GigE Vision Control Protocol) channel on your GigE Vision-compliant camera.

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
Click to summarize 0 <= Value <=66535

Specifies the port number.

c
M10
Click to summarize M_GC_REMOTE_IP_ADDRESS

Inquires the IP address (IPv4) of the network camera.

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
c
M10
Click to summarize Value

Specifies the IP address (IPv4) of the network camera.

The IP address is stored as a 32-bit integer in a MIL_INT64. Typically, IP addresses are written as 4 separate 8-bit numbers. To retrieve these values, either inquire the IP address as a string instead using M_GC_REMOTE_IP_ADDRESS_STRING, or map the 32-bit IP address to 4 MIL_UINT8 variables.

For example, the hexadecimal representation of the IP address 192.168.109.72 is 0x00000000486da8c0 (equivalent to the decimal 1215146176). The least-significant byte (c0) is the first number of the IP address (192), the second least-significant byte (a8) is the second number of the IP address (168) and so on. The first 8 digits (4 most-significant bytes) are not part of the IP address.

(summarize)
c
M10
Click to summarize M_GC_REMOTE_IP_ADDRESS_STRING +

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

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
c
M10
Click to summarize MIL_TEXT("nnn.nnn.nnn.nnn") 1

Specifies the IP address of the GigE Vision-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
M10
Click to summarize M_GC_REMOTE_MAC_ADDRESS +

Inquires the MAC address of the GigE Vision-compliant camera.

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
c
M10
Click to summarize Value

Specifies the MAC address of the GigE Vision-compliant camera.

The MAC address is stored as a 48-bit integer in a MIL_INT64. Typically, MAC addresses are written as 6 separate 8-bit numbers (hexadecimal number pairs). To retrieve these numbers, either inquire the MAC address as a string instead using M_GC_REMOTE_MAC_ADDRESS_STRING, or map the 48-bit MAC address to 6 MIL_UINT8 variables.

For example, the stored representation of the MAC address 84:20:fc:33:0e:e9 is 0x0000e90e33fc2084. The least-significant byte (84) is the first number of the MAC address, the second least-significant byte (0e) is the second number of the MAC address and so on. The first 4 hexadecimal digits (2 most significant bytes) are not part of the MAC address.

(summarize)
c
M10
Click to summarize M_GC_REMOTE_MAC_ADDRESS_STRING +

Inquires the MAC address of the GigE Vision-compliant camera, as a string.

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
c
M10
Click to summarize MIL_TEXT("nn-nn-nn-nn-nn-nn") 1

Specifies the MAC address of the GigE Vision-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
M10
Click to summarize M_GC_REMOTE_MESSAGE_PORT

Inquires the UDP port number used for the message channel on your GigE Vision-compliant camera.

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
Click to summarize 0 <= Value <=66535

Specifies the port number.

c
M10
Click to summarize M_GC_REMOTE_STREAM_PORT

Inquires the UDP port number used for the GVSP (GigE Vision Stream Protocol) channel on your GigE Vision-compliant camera.

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
Click to summarize 0 <= Value <=66535

Specifies the port number.

c
M10
Click to summarize 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
M10
j k
M10
o p r
U27
v y
U75
aa
MIL system specific

Note that this inquire type is only available if using a GenCP-compatible camera, or if you first install the third-party, vendor-supplied, standard compliant CLProtocol library for the Camera Link camera connected to your digitizer.

j p r
U27
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
o p r
U27
v y
U75
aa
Click to summarize Value

Specifies the major number of the schema version.

c
M10
j k
M10
o p r
U27
v y
U75
aa
Click to summarize 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
M10
j k
M10
o p r
U27
v y
U75
aa
MIL system specific

Note that this inquire type is only available if using a GenCP-compatible camera, or if you first install the third-party, vendor-supplied, standard compliant CLProtocol library for the Camera Link camera connected to your digitizer.

j p r
U27
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
o p r
U27
v y
U75
aa
Click to summarize Value

Specifies the minor number of the schema version.

c
M10
j k
M10
o p r
U27
v y
U75
aa
Click to summarize M_GC_SERIAL_NUMBER +

Inquires the serial number for the camera.

(summarize)
c
M10
o v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
c
M10
o v
Click to summarize "String"

Specifies the serial number for the camera.

c
M10
o v
Click to summarize M_GC_SPECIFIC_INFO +

Inquires the specific information string for the camera.

(summarize)
c
M10
o v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
c
M10
o v
Click to summarize "String"

Specifies the specific information string for the camera.

c
M10
o v
Click to summarize M_GC_STREAM_CHANNEL_MULTICAST_ADDRESS_STRING +

Inquires the IP address used for the multicast stream channel of your GigE Vision-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
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
c
M10
Click to summarize MIL_TEXT("2nn.nnn.nnn.nnn") 1

Specifies the IP address in dotted decimal notation.

c
M10
Click to summarize M_GC_STREAMING_MODE

Inquires the camera's image stream activation mechanism. SET

(summarize)
c
M10
k
M10
o v y
U75
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
k
M10
o v y
U75
Click to summarize M_AUTOMATIC

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

c
M10
k
M10
o v y
U75
Click to summarize M_MANUAL

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

c
M10
k
M10
o v y
U75
Click to summarize 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
M10
k
M10
o v y
U75
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
k
M10
o v y
U75
Click to summarize Value >= 0

Specifies the amount of time, in msec.

c
M10
k
M10
o v y
U75
Click to summarize 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
M10
k
M10
o v y
U75
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
k
M10
o v y
U75
Click to summarize Value >= 0

Specifies the amount of time, in msec.

c
M10
k
M10
o v y
U75
Click to summarize 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
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
c
M10
Click to summarize Value

Specifies the theoretical delay between packets, in sec.

c
M10
Click to summarize M_GC_TOTAL_FRAME_CACHE_HITS

Inquires the number of partial or complete frames that pass through the frame cache.

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
c
M10
Click to summarize Value

Specifies the number of frames.

c
M10
Click to summarize M_GC_TOTAL_FRAMES_CORRUPTED

Inquires the number of corrupted frames.

(summarize)
c
M10
o
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
c
M10
o
Click to summarize Value

Specifies the number of corrupted frames.

c
M10
o
Click to summarize M_GC_TOTAL_FRAMES_GRABBED

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

(summarize)
c
M10
o
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
c
M10
o
Click to summarize Value

Specifies the number of frames grabbed.

c
M10
o
Click to summarize M_GC_TOTAL_FRAMES_MISSED

Inquires the number of frames missed.

(summarize)
c
M10
o
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
c
M10
o
Click to summarize Value

Specifies the number of frames missed.

c
M10
o
Click to summarize M_GC_TOTAL_PACKET_CACHE_HITS

Inquires the number of packets that pass through the packet cache.

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
c
M10
Click to summarize Value

Specifies the number of packets.

c
M10
Click to summarize M_GC_TOTAL_PACKETS_MISSED

Inquires the number of packets missed.

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
c
M10
Click to summarize Value

Specifies the number of packets missed.

c
M10
Click to summarize M_GC_TOTAL_PACKETS_RECEIVED

Inquires the number of packets received.

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
c
M10
Click to summarize Value

Specifies the number of packets received.

c
M10
Click to summarize M_GC_TOTAL_PACKETS_RECEIVED_OUT_OF_ORDER

Inquires the number of packets received out of order.

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
c
M10
Click to summarize Value

Specifies the number of packets received out of order.

c
M10
Click to summarize M_GC_TOTAL_PACKETS_RECOVERED

Inquires the number of packets recovered.

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
c
M10
Click to summarize Value

Specifies the number of packets recovered.

c
M10
Click to summarize M_GC_TOTAL_PACKETS_RESENDS_NUM

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

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
c
M10
Click to summarize Value

Specifies the number of packets re-sent.

c
M10
Click to summarize M_GC_TOTAL_PACKETS_TIMEOUT

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

(summarize)
c
M10
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
c
M10
Click to summarize Value

Specifies the number of packets timeouts.

c
M10
Click to summarize M_GC_UNIQUE_ID_STRING +

Inquires the unique identifier for your camera.

(summarize)
c
M10
o
MIL system specific

This is the camera's MAC address.

c
M10

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

o
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
c
M10
o
Click to summarize MIL_TEXT("nnnnnnnnnnnn") 1

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

(summarize)
c
M10
o
Click to summarize M_GC_USER_NAME +

Inquires the camera's name. SET

(summarize)
c
M10
o v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
c
M10
o v
Click to summarize MIL_TEXT("CameraName") 1

Specifies the name of the camera.

c
M10
o v
Click to summarize M_GC_VERSION +

Inquires the version number string for the camera.

(summarize)
c
M10
o v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
c
M10
o v
Click to summarize "String"

Specifies the version number string for the camera.

c
M10
o v
Click to summarize M_GC_XML_MAJOR

Inquires the major version number of the GenICam-compliant camera's device description file (XML). The version number of the XML is structured as M_GC_XML_MAJOR. M_GC_XML_MINOR. M_GC_XML_SUBMINOR.

(summarize)
c
M10
j k
M10
o p r
U27
v y
U75
aa
MIL system specific

Note that this inquire type is only available if using a GenCP-compatible camera, or if you first install the third-party, vendor-supplied, standard compliant CLProtocol library for the Camera Link camera connected to your digitizer.

j p r
U27
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
o p r
U27
v y
U75
aa
Click to summarize Value

Specifies the major version number of the xml.

c
M10
j k
M10
o p r
U27
v y
U75
aa
Click to summarize M_GC_XML_MINOR

Inquires the minor version number of the GenICam-compliant camera's device description file (XML). The version number of the XML is structured as M_GC_XML_MAJOR. M_GC_XML_MINOR. M_GC_XML_SUBMINOR.

(summarize)
c
M10
j k
M10
o p r
U27
v y
U75
aa
MIL system specific

Note that this inquire type is only available if using a GenCP-compatible camera, or if you first install the third-party, vendor-supplied, standard compliant CLProtocol library for the Camera Link camera connected to your digitizer.

j p r
U27
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
o p r
U27
v y
U75
aa
Click to summarize Value

Specifies the minor version number of the xml.

c
M10
j k
M10
o p r
U27
v y
U75
aa
Click to summarize M_GC_XML_PATH +

Inquires the path and file name of the GenICam-compliant camera's device description file (XML).

(summarize)
c
M10
j k
M10
m o p r
U27
v y
U75
aa
MIL system specific

Note that this inquire type is only available if using a GenCP-compatible camera, or if you first install the third-party, vendor-supplied, standard compliant CLProtocol library for the Camera Link camera connected to your digitizer.

j p r
U27
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
c
M10
j k
M10
m o p r
U27
v y
U75
aa
Click to summarize "PathAndFilename"

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

c
M10
j k
M10
m o p r
U27
v y
U75
aa
Click to summarize M_GC_XML_SUBMINOR

Inquires the subminor version number of the GenICam-compliant camera's device description file (XML). The version number of the XML is structured as M_GC_XML_MAJOR. M_GC_XML_MINOR. M_GC_XML_SUBMINOR.

(summarize)
c
M10
j k
M10
o p r
U27
v y
U75
aa
MIL system specific

Note that this inquire type is only available if using a GenCP-compatible camera, or if you first install the third-party, vendor-supplied, standard compliant CLProtocol library for the Camera Link camera connected to your digitizer.

j p r
U27
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
o p r
U27
v y
U75
aa
Click to summarize Value

Specifies the subminor version number of the xml.

c
M10
j k
M10
o p r
U27
v y
U75
aa
Click to summarize M_GENTL_INTERFACE_INDEX

Inquires the number of the GenTL interface associated to this digitizer. Refer to the Matrox GenTL driver release notes for more information.

(summarize)
v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
v
Click to summarize 0 <= Value <=33

Specifies the total number of the GenICam GenTL camera interface.

v
Click to summarize M_GENTL_STREAM_COUNT

Inquires the number of GenTL streams associated with the digitizer.

(summarize)
v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
v
Click to summarize Value >= 0

Specifies the number of GenTL streams.

v
Click to summarize M_GRAB_DIRECTION_X

Inquires the horizontal grab direction. SET

(summarize)
c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_FORWARD

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

c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_REVERSE

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

c
M10
g h j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_GRAB_DIRECTION_Y

Inquires the vertical grab direction. SET

(summarize)
c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_FORWARD

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

c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_REVERSE

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

c
M10
g h j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_GRAB_FIELD_NUM

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

(summarize)
c
M10
g h i l m o u
U36
v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
g h i l m o u
U36
v
Click to summarize 1

Specifies to grab one field.

c
M10
g h i l m o u
U36
v
Click to summarize 2

Specifies to grab two fields.

g h i l m u
U36
Click to summarize 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
M10
p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
p r
U27
y
U75
aa
Click to summarize Value

Specifies the number of frames missed.

j k
M10
p r
U27
y
U75
aa
Click to summarize 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
M10
p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
p r
U27
y
U75
aa
Click to summarize M_DISABLE

Specifies to disable frames missed detection.

j k
M10
p r
U27
y
U75
aa
Click to summarize M_ENABLE

Specifies to enable frames missed detection.

j k
M10
p r
U27
y
U75
aa
Click to summarize M_GRAB_IN_PROGRESS

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

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_NO

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

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_YES

Specifies that there is a grab in progress.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize 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
M10
l m p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
l m p r
U27
y
U75
aa
Click to summarize M_DISABLE

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

j k
M10
l m p r
U27
y
U75
aa
Click to summarize M_ENABLE

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

j k
M10
l m p r
U27
y
U75
aa
Click to summarize M_GRAB_LUT_PALETTE

Inquires which LUT to use.

Note that this inquire value is only supported on color cameras. SET

(summarize)
t
U28
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
t
U28
Click to summarize M_DEFAULT

Specifies to use a 3-band RGB LUT.

t
U28
Click to summarize M_GAMMA

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

t
U28
Click to summarize M_GRAB_MODE

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

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_ASYNCHRONOUS

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

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_ASYNCHRONOUS_QUEUED

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

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_SYNCHRONOUS

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

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_GRAB_PERIOD

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

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize 0

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

c
M10
o v
Click to summarize Value > 0

Specifies the duration of a frame, in msec.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize 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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a i
Click to summarize M_AVERAGE

Specifies averaging interpolation. INFO

i
Click to summarize M_BICUBIC

Specifies bicubic interpolation. INFO

a i
Click to summarize M_BILINEAR

Specifies bilinear interpolation. INFO

a i
Click to summarize M_NEAREST_NEIGHBOR +

Specifies nearest neighbor interpolation. INFO

a i
Click to summarize M_GRAB_SCALE_X

Inquires the horizontal scaling factor when grabbing data. SET SET

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_FILL_DESTINATION

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

g h i j k
M10
l m p r
U27
u
U36
y
U75
aa
Click to summarize 1

Specifies that no scaling is applied.

a c
M10
g h j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize Value = 1/n

Specifies to reduce the image size. INFO

a g h i j k
M10
l m p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_GRAB_SCALE_Y

Inquires the vertical scaling factor when grabbing data. SET SET

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_FILL_DESTINATION

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

g h i j k
M10
l m p r
U27
u
U36
y
U75
aa
Click to summarize 1

Specifies that no scaling is applied.

a c
M10
g h j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize Value = 1/n

Specifies to reduce the image size. INFO

a g h i j k
M10
l m p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize 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)
g h i j l m p r
U27
u
U36
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
g h i j l m p r
U27
u
U36
aa
Click to summarize M_FIELD_START

Specifies that the grab starts on any field.

g h j l m p r
U27
aa
Click to summarize M_FIELD_START_EVEN

Specifies that the grab starts on an even field.

g h i j l m p r
U27
u
U36
aa
Click to summarize M_FIELD_START_ODD

Specifies that the grab starts on an odd field.

g h i j l m p r
U27
u
U36
aa
Click to summarize M_GRAB_TIMEOUT

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

(summarize)
c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_INFINITE

Specifies to wait indefinitely. INFO

c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize Value > 0

Specifies the time to wait, in msec.

c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_HARDWARE_DEINTERLACING

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

(summarize)
i u
U36
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
i u
U36
Click to summarize M_BOB_METHOD +

Specifies to use the BOB algorithm for hardware deinterlacing.

i u
U36
Click to summarize M_DISABLE

Specifies that hardware deinterlacing is disabled.

i u
U36
Click to summarize M_MADI_METHOD +

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

i u
U36
Click to summarize M_INPUT_FILTER +

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

(summarize)
i l u
U36
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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
i l u
U36
Click to summarize M_AUTOMATIC

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

i u
U36
Click to summarize M_BYPASS

Specifies to not use a filter.

i l u
U36
Click to summarize M_LOW_PASS_0

Specifies to use the first low-pass filter. INFO

i l u
U36
Click to summarize M_LOW_PASS_1

Specifies to use the second low-pass filter. INFO

i l u
U36
Click to summarize M_INPUT_MODE

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

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_ANALOG

Specifies analog input mode.

g h i l m t
U28
u
U36
Click to summarize M_DIGITAL

Specifies digital input mode.

a c
M10
i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize 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 c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_DISABLE

Specifies that the last frame grabbed during the continuous grab operation is copied to the target image buffer, instead of performing one last grab. INFO

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_ENABLE

Specifies that a monoshot grab is performed. INFO

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize 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)
t
U28
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
t
U28
Click to summarize 0 <= Value <= 255

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

t
U28
Click to summarize 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 k
M10
l m p r
U27
t
U28
y
U75
aa
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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_ID
a k
M10
l m p r
U27
t
U28
y
U75
aa
Click to summarize M_DEFAULT

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

a k
M10
l m p r
U27
t
U28
y
U75
aa
Click to summarize MIL LUT buffer identifier

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

a k
M10
l m p r
U27
t
U28
y
U75
aa
Click to summarize M_NUMBER

Inquires the device number of the digitizer. SET

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_DEVn

Specifies which acquisition path on your frame grabber, or which camera by rank when dealing with a grabberless interface camera (for example, a GigE Vision or USB3 Vision camera), to allocate for the digitizer. INFO

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_OWNER_SYSTEM

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

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_ID
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize MIL system identifier

Specifies the MIL identifier of the system.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_POWER_OVER_CABLE

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

(summarize)
j k
M10
m p r
U27
y
U75
aa
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
U27
aa

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

k
M10
y
U75
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
m p r
U27
y
U75
aa
Click to summarize M_OFF

Specifies to disable PoCL/PoCXP.

j k
M10
m p r
U27
y
U75
aa
Click to summarize M_ON

Specifies to enable PoCL/PoCXP.

j k
M10
m p r
U27
y
U75
aa
Click to summarize M_PROCESS_FRAME_CORRUPTED

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

(summarize)
a c
M10
i o t
U28
u
U36
v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
i o t
U28
u
U36
v
Click to summarize Value

Specifies the number of corrupted frames.

a c
M10
i o t
U28
u
U36
v
Click to summarize M_PROCESS_FRAME_COUNT

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

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize Value

Specifies the number of grabbed frames.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_PROCESS_FRAME_MISSED

Inquires the number of frames believed to be missed when grabbing with MdigProcess().

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
MIL system specific

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.

a g h i o t
U28
u
U36

This value is based on a comparison between the previous frame's block identifier and the current frame's block identifier. The identifier is incremented by 1 for each frame transmitted. Using the block identifier allows MIL to detect missed frames even when the camera is triggered from a variable trigger or if the hooked function is slow.

c
M10
v

This value is returned from your imaging board.

j k
M10
l m p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize Value

Specifies the number of missed frames.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize 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 c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize Value

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

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize 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 c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_DISABLE

Does not create a grab activity thread.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_ENABLE

Creates a grab activity thread.

c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize 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
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize Value

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

c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize 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
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_INFINITE

Specifies to wait indefinitely.

c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize Value >= 0

Specifies the time to wait, in msec.

c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_PROCESS_TOTAL_BUFFER_NUM

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

(summarize)
c
M10
g h i j k
M10
l m o p r
U27
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
g h i j k
M10
l m o p r
U27
u
U36
v y
U75
aa
Click to summarize Value

Specifies the total number of allocated grab buffers.

c
M10
g h i j k
M10
l m o p r
U27
u
U36
v y
U75
aa
Click to summarize M_SCAN_MODE

Inquires the scan mode.

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_INTERLACE

Specifies interlace mode.

c
M10
g h i l m o u
U36
v
Click to summarize M_LINESCAN

Specifies line-scan mode.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_PROGRESSIVE

Specifies progressive mode.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_SELECTED_FRAME_RATE

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

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize Value

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

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_SERIAL_NUMBER +

Inquires the serial number of the connected device.

(summarize)
t
U28
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_TEXT_CHAR [optionally, in C++: MIL_STRING ] MORE
t
U28
Click to summarize "String"

Specifies the serial number of the connected device.

t
U28
Click to summarize M_SIGN

Inquires whether the data is signed or unsigned.

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_SIGNED

Specifies that the data is signed.

a c
M10
o v
Click to summarize M_UNSIGNED

Specifies that the data is unsigned.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_SIZE_BAND

Inquires the number of input color bands of the digitizer.

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize Value

Specifies the number of input color bands of the digitizer.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_SIZE_BAND_LUT

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

(summarize)
c
M10
g h i j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
g h i j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize Value > 0

Specifies the number of input color bands.

c
M10
g h i j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_SIZE_BIT

Inquires the depth per band.

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
u
U36
v y
U75
aa
Click to summarize Value

Specifies the depth per band, in bits.

a c
M10
g h i j k
M10
l m o p r
U27
u
U36
v y
U75
aa
Click to summarize 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 c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize Value

Specifies the width of the image, in pixels.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize 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 c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize Value

Specifies the height of the image, in pixels.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_SOURCE_DATA_FORMAT

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

(summarize)
c
M10
i o u
U36
v
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
M10
o v

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

i u
U36
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
i o u
U36
v
Click to summarize 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
M10
i o u
U36
v
Click to summarize 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
M10
o v
Click to summarize M_SOURCE_NUMBER_OF_FRAMES

Inquires the number of frames that can be grabbed.

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_INFINITE

Specifies an infinite number of frames.

c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize Value > 0

Specifies the number of frames in the AVI file or folder specified when you allocated the digitizer.

a
Click to summarize M_SOURCE_OFFSET_X

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

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize Value

Specifies the X-offset, in pixels.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_SOURCE_OFFSET_Y

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

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize Value

Specifies the Y-offset, in pixels.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_SOURCE_SIZE_X

Inquires the width of the input signal capture window. SET

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize Value

Specifies the width, in pixels.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_SOURCE_SIZE_Y

Inquires the height of the input signal capture window. SET

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize Value

Specifies the height, in pixels.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_TARGET_BUFFER_OBJECT

Inquires whether the digitizer outputs data in a format suitable for grabbing into a buffer or a container.

Note that you can grab from any digitizer into either a buffer or a container. However, grabbing data suitable for a container into a buffer will result in only one of the components transmitted from the camera being grabbed. Grabbing data suitable for a buffer into a container is supported, but not typically necessary.

You can automatically allocate the MIL object most suitable for grabbing from a specified digitizer using MbufAllocDefault().

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_CONTAINER

Specifies that the digitizer outputs data in a format suitable for grabbing into a container.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_IMAGE

Specifies that the digitizer outputs data in a format suitable for grabbing grabbing into a buffer.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_TL_TRIGGER_ACTIVATION

Inquires the signal variation upon which to generate a trigger signal to the camera through the transport layer interface. SET

(summarize)
k
U29
y
U75
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
k
U29
y
U75
Click to summarize M_ANY_EDGE

Specifies that a trigger will be generated both upon a high-to-low and a low-to-high signal transition.

k
U29
y
U75
Click to summarize M_EDGE_RISING

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

k
U29
y
U75
Click to summarize M_TYPE

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

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize depth value + M_SIGNED

Specifies the data depth and that the data is signed.

c
M10
g h i l m o t
U28
u
U36
v
Click to summarize depth value + M_UNSIGNED

Specifies the data depth and that the data is unsigned.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_VIDEO_OUTPUT

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

(summarize)
h
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
h
Click to summarize M_NULL

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

h
Click to summarize M_CHn

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

h
Click to summarize M_WHITE_BALANCE

Inquires whether to perform white balancing. SET

(summarize)
c
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa
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
M10
o v

Note that this inquire type is only available when using color versions of Matrox Iris GTR (such as 1300C).

t
U28
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_DISABLE

Specifies that white balancing is disabled.

c
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_ENABLE

Specifies that white balancing is enabled. INFO

c
M10
k
M10
m o p r
U27
t
U28
v y
U75
aa

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

Combination value 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
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize M_FAST

Uses a fast interpolation. INFO

i
Combination values 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_NAME (when InquireType=M_EXTENDED_INIT_FLAG and UserVarPtr=M_GC_DEVICE_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
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize M_GC_PACKET_SIZE_NEGOTIATION_SKIP

Specifies that the packet size negotiation task is skipped. INFO

c
M10
Click to summarize 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
M10
Click to summarize 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
M10
Combination values 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_NAME (when InquireType=M_EXTENDED_INIT_FLAG and UserVarPtr=M_GC_DEVICE_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
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize M_GC_MULTICAST_MASTER

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

c
M10
Click to summarize 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
M10
Click to summarize M_GC_MULTICAST_SLAVE

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

c
M10
Combination values 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
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize M_MONO8

Specifies 8-bit monochrome depth planar pixels.

c
M10
o v
Click to summarize M_MONO16

Specifies 16-bit monochrome depth planar pixels.

c
M10
o v
Combination values 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
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize M_BGR24

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

c
M10
o v
Click to summarize M_BGR32

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

(summarize)
c
M10
i o u
U36
v
Click to summarize 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
M10
o v
Click to summarize 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
M10
o v
Click to summarize M_RGB24

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

c
M10
o v
Click to summarize M_RGB48

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

c
M10
o v
Click to summarize M_YUV16

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

c
M10
o u
U36
v
Click to summarize 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 21: Data buffers.

(summarize)
c
M10
i o u
U36
v
Click to summarize 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 21: Data buffers.

(summarize)
c
M10
i o u
U36
v
Click to summarize M_YUV411_1394

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

c
M10
o v
Click to summarize M_YUV444

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

c
M10
o v
Combination value for M_GC_CLPROTOCOL_DEVICE_ID.

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

function map For specifying which Camera Link camera to inquire
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize 0 <= Value <= 127

Specifies which Camera Link camera to inquire.

j m p r
U27
aa
Combination values 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
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize M_ANTIALIASING

Specifies that anti-aliasing is enabled.

i
Click to summarize M_DITHERING

Specifies that dithering is enabled.

i

You can add the following value to the above-mentioned values to get the string's length.

function map For getting the string size
Click to summarizeInquireType Description MIL system-specific
tooltip (‡)
UserVarPtr
- Possible values returned
Click to summarize M_STRING_SIZE

Retrieves the length of the string, including the terminating null character ("\0").

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa

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.

function map For the general reference settings
Click to summarize
InquireType
Description MIL system-specific
tooltip (‡)
UserVarPtr
- Possible values returned
Click to summarize M_BLACK_OFFSET +

Inquires the offset to the black level of the image in hardware. SET

(summarize)
t
U28
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
t
U28
Click to summarize 0<= Value <= 255

Specifies the value of the black offset.

t
U28
Click to summarize M_BLACK_REF +

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

(summarize)
c
M10
l o v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
c
M10
l o v
Click to summarize Value

Specifies the black reference level.

c
M10
l o v
Click to summarize M_BRIGHTNESS_REF

Inquires the brightness level for composite input signals. SET

(summarize)
g h i u
U36
MIL system specific

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

i u
U36
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
g h i u
U36
Click to summarize Value

Specifies the brightness reference value.

g h i u
U36
Click to summarize M_CONTRAST_REF

Inquires the contrast level for composite input signals. SET

(summarize)
g h i u
U36
MIL system specific

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

i u
U36
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
g h i u
U36
Click to summarize Value

Specifies the contrast reference value.

g h i u
U36
Click to summarize M_HUE_REF

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

(summarize)
g h i u
U36
MIL system specific

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

i u
U36
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
g h i u
U36
Click to summarize Value

Specifies the digitizer hue reference level.

g h i u
U36
Click to summarize M_SATURATION_REF

Inquires the saturation level for composite input signals. SET

(summarize)
g h i u
U36
MIL system specific

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

i u
U36
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
g h i u
U36
Click to summarize Value

Specifies the digitizer saturation reference level.

g h i u
U36
Click to summarize M_WHITE_REF +

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

(summarize)
c
M10
l o v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
c
M10
l o v
Click to summarize Value

Specifies the digitizer's white reference value.

c
M10
l o v
Combination values 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.

function map For specifying which acquisition path is inquired
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize M_ALL_REF

Inquires the reference level on all available acquisition paths.

l
Click to summarize M_CH0_REF

Inquires the reference level on acquisition path 0.

l
Click to summarize M_CH1_REF

Inquires the reference level on acquisition path 1.

l
Click to summarize M_CH2_REF

Inquires the reference level on acquisition path 2.

l
Click to summarize M_CH3_REF

Inquires the reference level on acquisition path 3.

l
Combination value for M_BLACK_REF; M_WHITE_REF.

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

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

Inquires the reference level in Volts.

l

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

function map For inquiring the input gain and shading correction
Click to summarize
InquireType
Description MIL system-specific
tooltip (‡)
UserVarPtr
- Possible values returned
Click to summarize M_GAIN +

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

(summarize)
c
M10
o t
U28
v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
o t
U28
v
Click to summarize Min. gain <= Value <= Max. gain

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

c
M10
o t
U28
v
Click to summarize M_GRAB_AUTOMATIC_INPUT_GAIN +

Inquires whether the input gain should be automatically set. SET

(summarize)
c
M10
g h i o u
U36
v
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

This inquire type is only supported when the device number of the specified digitizer is M_DEV2 or M_DEV3. Note that this inquire type is available when the DCF specifies to grab either an analog or digital input signal.

u
U36
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
g h i o u
U36
v
Click to summarize M_DISABLE

Specifies that the input gain is not automatically set.

c
M10
g h i o u
U36
v
Click to summarize M_ENABLE

Specifies that the input gain is automatically set.

c
M10
g h i o u
U36
v
Click to summarize M_GRAB_INPUT_GAIN +

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

(summarize)
g h i l u
U36
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 inquire type is only available when the DCF specifies to grab an analog input signal.

i

This inquire type is only supported when the device number of the digitizer is M_DEV2 or M_DEV3. Note that this inquire type is available when the DCF specifies to grab either an analog or digital input signal.

u
U36
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
g h i l u
U36
Click to summarize M_GAIN0

Specifies the first input gain supported. INFO

i l
Click to summarize M_GAIN1

Specifies the second input gain supported. INFO

i l
Click to summarize M_GAIN2

Specifies the third input gain supported. INFO

i l
Click to summarize M_GAIN3

Specifies the fourth input gain supported. INFO

i l
Click to summarize M_MAX_LEVEL

Specifies the maximum input gain factor.

g h i l u
U36
Click to summarize M_MIN_LEVEL

Specifies the minimum input gain factor.

g h i l u
U36
Click to summarize 0 <= Value <= 255

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

g h i l u
U36
Click to summarize M_SHADING_CORRECTION

Inquires whether to perform a gain and offset correction per pixel (shading correction). SET

(summarize)
k
U29
p y
U75
MIL system specific

Note that this inquire type is only available on Matrox Rapixo CXP Pro, and only if the loaded FPGA configuration contains the Matrox PU that supports this functionality.

y
U75

Note that this inquire type is only available on Matrox Radient eV-CXP for 3D profiling.

k
U29

Note that this inquire type is only available if the loaded FPGA configuration contains the Matrox PU that supports this functionality.

p
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
k
U29
p y
U75
Click to summarize M_DISABLE

Disables shading correction.

k
U29
p y
U75
Click to summarize M_ENABLE

Enables shading correction.

k
U29
p y
U75
Click to summarize M_SHADING_CORRECTION_GAIN_FIXED_POINT

Inquires the number of bits in the fractional part of the gain values specified for performing shading correction, where values are in fixed point format. The image resulting from the shading correction will be rounded to the nearest whole number. SET

(summarize)
k
U29
p y
U75
MIL system specific

Note that this inquire type is only available if the loaded FPGA configuration contains the Matrox PU that supports this functionality.

p

Note that this inquire type is only available on Matrox Radient eV-CXP for 3D profiling.

k
U29

Note that this inquire type is only available if the loaded FPGA configuration contains the Matrox PU that supports this functionality.

p
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
k
U29
p y
U75
Click to summarize 0 < Value <= 16

Specifies the number of bits in the fractional part of the fixed-point gain values.

k
U29
p y
U75
Click to summarize M_SHADING_CORRECTION_GAIN_ID

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

(summarize)
k
U29
p y
U75
MIL system specific

Note that this inquire type is only available on Matrox Rapixo CXP Pro, and only if the loaded FPGA configuration contains the Matrox PU that supports this functionality.

y
U75

Note that this inquire type is only available on Matrox Radient eV-CXP for 3D profiling.

k
U29

Note that this inquire type is only available if the loaded FPGA configuration contains the Matrox PU that supports this functionality.

p
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_ID
k
U29
p y
U75
Click to summarize M_NULL

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

This is the default value.

(summarize)
k
U29
p y
U75
Click to summarize ShadingCorrectionGainID

Specifies the identifier of an M_IMAGE buffer containing the gain values. INFO

k
U29
p y
U75
Click to summarize M_SHADING_CORRECTION_OFFSET_ID

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

(summarize)
k
U29
p y
U75
MIL system specific

Note that this inquire type is only available on Matrox Rapixo CXP Pro, and only if the loaded FPGA configuration contains the Matrox PU that supports this functionality.

y
U75

Note that this inquire type is only available on Matrox Radient eV-CXP for 3D profiling.

k
U29

Note that this inquire type is only available if the loaded FPGA configuration contains the Matrox PU that supports this functionality.

p
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_ID
k
U29
p y
U75
Click to summarize M_NULL

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

This is the default value.

(summarize)
k
U29
p y
U75
Click to summarize ShadingCorrectionOffsetID

Specifies the identifier of an M_IMAGE buffer containing the offset values. INFO

k
U29
p y
U75

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
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize 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.

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

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

(summarize)
l

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
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize M_CHROMINANCE

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

g h i
Click to summarize M_LUMINANCE

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

g h i

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

function map For inquiring I/O signals and their mode
Click to summarize
InquireType
Description MIL system-specific
tooltip (‡)
UserVarPtr
- Possible values returned
Click to summarize M_AUX_IO_COUNT

Inquires the total number of auxiliary signals.

(summarize)
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize Value

Specifies the total number of auxiliary signals.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_AUX_IO_COUNT_IN

Inquires the total number of auxiliary input and bidirectional signals.

(summarize)
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize Value

Specifies the total number of auxiliary input and bidirectional signals.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_AUX_IO_COUNT_OUT

Inquires the total number of auxiliary output and bidirectional signals.

(summarize)
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize Value

Specifies the total number of auxiliary output and bidirectional signals.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_CC_IO_COUNT_OUT

Inquires the total number of camera control output signals.

(summarize)
c
M10
j l m o p r
U27
v aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j l m o p r
U27
v aa
Click to summarize Value

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

c
M10
j l m o p r
U27
v aa
Click to summarize 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
M10
j k
M10
l m o p r
U27
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_DISABLE

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

c
M10
o v
Click to summarize M_LVDS

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

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_OPEN_DRAIN

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

c
M10
o v
Click to summarize M_OPTO

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

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_RS422

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

c
M10
o v
Click to summarize M_TRI_STATE

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

c
M10
o v
Click to summarize M_TTL

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

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize 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
M10
j k
M10
l m o p r
U27
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_ANY_EDGE

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

c
M10
o v
Click to summarize M_EDGE_FALLING

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

c
M10
o v
Click to summarize M_EDGE_RISING

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

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize 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
M10
j k
M10
l m o p r
U27
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_DISABLE

Specifies not to generate an interrupt.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_ENABLE

Specifies to generate an interrupt.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize 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
M10
j k
M10
l m o p r
U27
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_INPUT

Specifies that the signal is for input.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_OUTPUT

Specifies that the signal is for output.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize 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
M10
j k
M10
l m o p r
U27
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_AUX_IOn

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

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_DISABLE

Specifies to not route any signal to the specified signal.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_HSYNC

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

l m
Click to summarize M_PIXCLK

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

l m
Click to summarize M_TIMERn

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

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_TL_TRIGGER

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

k
M10
y
U75
Click to summarize M_USER_BIT_CC_IOn

Specifies to route the state of bit n of the camera control static-user-output register, where n is a value from 0 to 1. INFO

j m p r
U27
aa
Click to summarize M_USER_BIT_TL_TRIGGER

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

k
M10
y
U75
Click to summarize M_USER_BITn

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

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_VSYNC

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

l m
Click to summarize 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
M10
j k
M10
l m o p r
U27
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_INVALID

Specifies that the input signal is disabled.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_OFF

Specifies that the input signal is off.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_ON

Specifies that the input signal is on.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_UNKNOWN

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

(summarize)
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
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
U27
aa
Click to summarize 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
M10
j k
M10
l m o p r
U27
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize Value

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

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_TL_TRIGGER_COUNT

Inquires the total number of TL trigger signals.

(summarize)
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize Value

Specifies the total number of TL trigger signals.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_TL_TRIGGER_COUNT_IN

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

(summarize)
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize Value

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

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_TL_TRIGGER_COUNT_OUT

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

(summarize)
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize Value

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

c
M10
j k
M10
l m o p r
U27
v y
U75
aa

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
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize M_AUX_IOn

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

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize 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
U27
aa
Click to summarize M_TL_TRIGGER

Specifies to inquire the transport layer trigger signal. INFO

k
M10
y
U75
Combination values 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
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize M_AUX_IO

Specifies to inquire all auxiliary signals.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_CC_IO

Specifies to inquire all Camera Link camera control signals.

j m p r
U27
aa

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

function map For inquiring the state of specified user-bits in a static-user-output register
Click to summarize
InquireType
Description MIL system-specific
tooltip (‡)
UserVarPtr
- Possible values returned
Click to summarize M_USER_BIT_COUNT

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

(summarize)
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize Value

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

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize 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
M10
j k
M10
l m o p r
U27
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_OFF

Specifies that the specified bit is set to off.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_ON

Specifies that the specified bit is set to on.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize 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
M10
j k
M10
l m o p r
U27
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize Value

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

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Combination values 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
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize M_USER_BIT_CC_IOn

Specifies which bit of the camera control static-user-output register to inquire , where n is a value from 0 to 1. INFO

j m p r
U27
aa
Click to summarize M_USER_BIT_TL_TRIGGER0

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

k
M10
y
U75
Click to summarize M_USER_BITn

Specifies to inquire bit n of the main static-user-output register. INFO

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Combination values for M_USER_BIT_STATE_ALL.

You can add one of the following values to the above-mentioned value to specify the static-user-output register to 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
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize M_USER_BIT

Specifies to inquire all the bits in the main static-user-output register.

j k
M10
l m p r
U27
y
U75
aa
Click to summarize 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
U27
aa
Click to summarize 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
M10
y
U75

The following inquire types and inquire values specify the settings for inquiring triggers. For more information, see the Grabbing with triggers section of Chapter 25: Grabbing with your digitizer.

[Matrox Morphis]

Triggered grabs are not supported on Matrox Morphis Quad.

function map For inquiring the settings to grab using a trigger
Click to summarize
InquireType
Description MIL system-specific
tooltip (‡)
UserVarPtr
- Possible values returned
Click to summarize 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
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_DISABLE

Specifies not to generate the trigger automatically. INFO

c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_ENABLE

Specifies to generate the trigger automatically. INFO

c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_GRAB_TRIGGER_ACTIVATION

Inquires the signal transition upon which to generate a grab trigger. SET

(summarize)
c
M10
g j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
g j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_ANY_EDGE

Specifies that a trigger will be generated upon both a low-to-high and a high-to-low signal transition.

c
M10
o v
Click to summarize M_EDGE_FALLING

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

c
M10
g j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_EDGE_RISING

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

c
M10
g j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_LEVEL_HIGH

Specifies that a trigger is continuously issued during a high signal polarity.

c
M10
g j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_LEVEL_LOW

Specifies that a trigger is continuously issued during a low signal polarity.

c
M10
g j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_GRAB_TRIGGER_DELAY

Inquires the delay between the trigger and the grab. SET

(summarize)
c
M10
o v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
c
M10
o v
Click to summarize Value >= 0

Specifies the delay, in nsec.

c
M10
o v
Click to summarize M_GRAB_TRIGGER_MISSED

Inquires whether the number of grab triggers missed should be counted. SET

(summarize)
t
U28
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
t
U28
Click to summarize M_DISABLE

Specifies to not count the number of grab triggers missed.

t
U28
Click to summarize M_ENABLE

Specifies to count the number of grab triggers missed.

t
U28
Click to summarize M_GRAB_TRIGGER_OVERLAP

Inquires how a new grab trigger will be dealt with when the current grab is in progress. SET

(summarize)
c
M10
k
U29
o t
U28
v y
U75
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
k
U29
o t
U28
v y
U75
Click to summarize M_DISABLE

Specifies that a triggered grab will not overlap the transfer of the previous image. INFO

c
M10
o t
U28
v
Click to summarize M_ENABLE

Specifies that a triggered grab can overlap the transfer of the previous image.

c
M10
o t
U28
v
Click to summarize M_OFF

Specifies that a new trigger is ignored.

k
U29
y
U75
Click to summarize M_PREVIOUS_FRAME

Specifies that a trigger received, while a grab is in progress, will be latched (stored). INFO

k
U29
y
U75
Click to summarize M_RESET

Specifies that the current grab will be immediately stopped and a new grab will be started.

k
U29
y
U75
Click to summarize M_GRAB_TRIGGER_SOURCE

Inquires the source for the grab trigger. SET

(summarize)
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_NULL

Specifies that there is no trigger source.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_AUX_IOn

Specifies to use auxiliary input signal n as the trigger source, where n is the number of the auxiliary signal. INFO

c
M10
g j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_HSYNC

Specifies to use the horizontal synchronization signal of the camera as the trigger source.

j l m p r
U27
aa
Click to summarize M_IO_COMMAND_LIST1 +

Specifies to use a bit of the I/O command register of I/O command list 1 as a trigger source.


This value is combined with a value from the following table:
(summarize)
t
U28
Click to summarize M_ROTARY_ENCODER

Specifies to use the output of the default rotary decoder (set with M_ROTARY_ENCODER_OUTPUT_MODE) as the trigger source. INFO

j k
M10
m p r
U27
t
U28
y
U75
aa
Click to summarize M_ROTARY_ENCODERn

Specifies to use rotary decoder n as the trigger source, where n is a number between 1 and 4. INFO

k
M10
t
U28
y
U75
Click to summarize 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 c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_SOFTWAREn

Specifies to use the software trigger being used for the grab of another digitizer (on the same board) as the trigger source. INFO

k
M10
y
U75
Click to summarize M_TIMERn

Specifies to use the output signal of the specified timer as the trigger source. INFO

c
M10
j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_TL_TRIGGER

Specifies to use the transport layer trigger signal. INFO

k
M10
Click to summarize M_VSYNC

Specifies to use the vertical synchronization signal of the camera as the trigger source.

j l m p r
U27
aa
Click to summarize 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 c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
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
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_DISABLE

Specifies that, when a grab command is issued, the grab occurs without waiting for a trigger.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Click to summarize M_ENABLE

Specifies that, when a grab command is issued, the grab waits for a trigger before occurring.

a c
M10
g h i j k
M10
l m o p r
U27
t
U28
u
U36
v y
U75
aa
Combination value for M_IO_COMMAND_LIST1 (when InquireType=M_GRAB_TRIGGER_SOURCE and UserVarPtr=M_IO_COMMAND_LIST1).

The following value is combined with the above-mentioned value to specify which I/O command register bit to use.

function map For specifying which I/O command register bit to use
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize M_IO_COMMAND_BITn

Specifies I/O command register bit n, where n represents the bit number. INFO

t
U28

The following inquire types allow you to inquire the settings for a grab of sequential frames into a multi-frame image buffer (frame burst).

function map For inquiring frame burst settings
Click to summarize
InquireType
Description MIL system-specific
tooltip (‡)
UserVarPtr
- Possible values returned
Click to summarize M_GRAB_FRAME_BURST_END_TRIGGER_SOURCE

Inquires which signal causes the end of a grab of sequential frames into a multi-frame image buffer (end-of-frame-burst trigger). SET

(summarize)
k
U29
r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
k
U29
r
U27
y
U75
aa
Click to summarize M_AUX_IOn

Specifies to use auxiliary input signal n as the trigger source, where n is the number of the auxiliary signal. INFO

k
U29
r
U27
y
U75
aa
Click to summarize M_GRAB_FRAME_BURST_END_TRIGGER_STATE

Inquires whether a grab into a multi-frame image buffer is ended upon an end-of-frame-burst trigger. SET

(summarize)
k
U29
r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
k
U29
r
U27
y
U75
aa
Click to summarize M_DISABLE

Specifies that an end-of frame-burst trigger is not used to end the grab.

k
U29
r
U27
y
U75
aa
Click to summarize M_ENABLE

Specifies that an end-of frame-burst trigger is used to end the grab.

k
U29
r
U27
y
U75
aa
Click to summarize M_GRAB_FRAME_BURST_MAX_TIME

Inquires the maximum amount of time to wait for all the frames to be grabbed into the multi-frame buffer. The timer starts when the first frame is grabbed. SET

(summarize)
k
U29
r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
k
U29
r
U27
y
U75
aa
Click to summarize M_INFINITE

Specifies to wait indefinitely.

k
U29
r
U27
y
U75
aa
Click to summarize 0.000008 <= Value <= 1.000000

Specifies the maximum amount of time to wait, in secs.

k
U29
r
U27
y
U75
aa
Click to summarize M_GRAB_FRAME_BURST_SIZE

Inquires the number of sequential frames to grab into a multi-frame buffer with one grab command (MdigGrab(), or one grab of MdigProcess()). SET

(summarize)
k
U29
r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
k
U29
r
U27
y
U75
aa
Click to summarize 1 <= Value <= 1023

Specifies the number of frames to grab.

k
U29
r
U27
y
U75
aa

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 25: Grabbing with your digitizer.

To specify which timer to inquire, see the For specifying which on-board timer to inquire combination value below.

function map For inquiring the settings of a timer
Click to summarize
InquireType
Description MIL system-specific
tooltip (‡)
UserVarPtr
- Possible values returned
Click to summarize M_TIMER_CLOCK_FREQUENCY +

Inquires the frequency of the clock that drives the specified timer.

(summarize)
j k
M10
l m p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
j k
M10
l m p r
U27
y
U75
aa
Click to summarize 0

Specifies that the value cannot be inquired.

j k
M10
l m p r
U27
y
U75
aa
Click to summarize Value

Specifies the frequency of the clock source, in Hz.

j k
M10
l m p r
U27
y
U75
aa
Click to summarize M_TIMER_CLOCK_SOURCE +

Inquires the source of the clock that drives the specified timer. SET

(summarize)
j k
M10
l m p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
l m p r
U27
y
U75
aa
Click to summarize M_HSYNC

Specifies to use the horizontal synchronization frequency of your camera.

j k
U29
l m p r
U27
y
U75
aa
Click to summarize M_PIXCLK

Specifies to use the pixel clock frequency of your camera.

j l m p r
U27
aa
Click to summarize M_SYSCLK

Specifies to use the frequency of the allocated system's clock source. INFO

j k
M10
l m p r
U27
y
U75
aa
Click to summarize M_TIMERn

Specifies to use the frequency of the output of the specified timer, where n is the timer number. INFO

j k
M10
l m p r
U27
y
U75
aa
Click to summarize M_VSYNC

Specifies to use the vertical synchronization frequency of your camera.

j k
U29
l m p r
U27
y
U75
aa
Click to summarize M_TIMER_DELAY +

Inquires the delay between the timer trigger and the active portion of the timer output signal. SET

(summarize)
c
M10
j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
c
M10
j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize 0

Specifies that there is no delay.

c
M10
o t
U28
v
Click to summarize Value > 0

Specifies the delay, in nsec.

c
M10
j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_TIMER_DELAY2 +

Inquires the delay between the end of the first active portion of the timer output signal and the start of the second pulse. SET

(summarize)
j k
U29
p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
j k
U29
p r
U27
y
U75
aa
Click to summarize Value > 0

Specifies the delay, in nsec.

j k
U29
p r
U27
y
U75
aa
Click to summarize M_TIMER_DURATION +

Inquires the duration for the active portion of the timer output signal. SET

(summarize)
c
M10
j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
c
M10
j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize Value > 0

Specifies the duration of the active portion of the timer output signal, in nsec.

c
M10
j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_TIMER_DURATION2 +

Inquires the duration for the active portion of the second pulse of the timer output signal. SET

(summarize)
j k
U29
p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
j k
U29
p r
U27
y
U75
aa
Click to summarize Value > 0

Specifies the duration of the active portion of the second pulse of the timer output signal, in nsecs.

j k
U29
p r
U27
y
U75
aa
Click to summarize M_TIMER_OUTPUT_INVERTER +

Inquires whether the output of the timer is inverted. SET

(summarize)
j k
M10
l m p r
U27
t
U28
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
l m p r
U27
t
U28
y
U75
aa
Click to summarize M_DISABLE

Specifies not to invert the output of the timer.

j k
M10
l m p r
U27
t
U28
y
U75
aa
Click to summarize M_ENABLE

Specifies to invert the output of the timer.

j k
M10
l m p r
U27
t
U28
y
U75
aa
Click to summarize M_TIMER_STATE +

Inquires the state of the specified timer. SET

(summarize)
c
M10
j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_DISABLE

Specifies that the timer is disabled.

c
M10
j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_ENABLE

Specifies that the timer is enabled.

c
M10
j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_TIMER_TRIGGER_ACTIVATION +

Inquires the signal variation upon which to generate a timer trigger, when the specified timer is enabled. SET

(summarize)
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_ANY_EDGE

Specifies that a timer trigger will be generated both upon a high-to-low and a low-to-high signal transition.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_EDGE_FALLING

Specifies that a timer trigger will be generated upon a high-to-low signal transition.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_EDGE_RISING

Specifies that a timer trigger will be generated upon a low-to-high signal transition.

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_LEVEL_HIGH

Specifies that a timer trigger is continuously issued during a high signal polarity.

c
M10
o v
Click to summarize M_LEVEL_LOW

Specifies that a timer trigger is continuously issued during a low signal polarity.

c
M10
o v
Click to summarize M_TIMER_TRIGGER_MISSED +

Inquires whether to count the number of trigger pulses missed. SET

(summarize)
j k
M10
l m p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
l m p r
U27
y
U75
aa
Click to summarize M_DISABLE

Specifies not to count the number of trigger pulses missed.

j k
M10
l m p r
U27
y
U75
aa
Click to summarize M_ENABLE

Specifies to count the number of trigger pulses missed.

j k
M10
l m p r
U27
y
U75
aa
Click to summarize M_TIMER_TRIGGER_OVERLAP +

Inquires how to deal with a new trigger that occurs while the associated timer has not yet expired. This is applied to both the delay and duration. SET

(summarize)
k
U29
y
U75
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
k
U29
y
U75
Click to summarize M_LATCH

Specifies that a trigger received, while the associated timer has not expired, will be latched (stored). INFO

k
U29
y
U75
Click to summarize M_OFF

Specifies that a new trigger is ignored.

k
U29
y
U75
Click to summarize M_RESET

Specifies that a new trigger automatically resets the timer (regardless of whether it is in its delay or active period) and then restarts the timer. INFO

k
U29
y
U75
Click to summarize M_TIMER_TRIGGER_RATE_DIVIDER +

Inquires the frequency with which to accept trigger pulses. SET

(summarize)
j k
M10
l m p r
U74
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
l m p r
U74
y
U75
aa
Click to summarize 1; 2; 4; 8; 16

Specifies the frequency with which to accept a trigger out of a series of trigger pulses. INFO

j l m p
Click to summarize 1 <= Value <= 255

Specifies the frequency with which to accept a trigger out of a series of trigger pulses. INFO

k
U29
r
U74
y
U75
aa
Click to summarize M_TIMER_TRIGGER_SOURCE +

Inquires the trigger source for the specified timer output signal. SET

(summarize)
c
M10
j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_NULL

Specifies that there is no timer trigger source.

c
M10
j k
M10
l m o p r
U27
t
U28
v y
U75
aa
Click to summarize M_AUX_IOn

Specifies to use auxiliary input signal n as the trigger source for the specified timer, where n is the number of the auxiliary signal. INFO

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_CONTINUOUS

Specifies to run the specified timer in periodic mode; no actual trigger signal is used. INFO

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_EXPOSURE_END

Specifies to use the exposure end signal as the trigger source. INFO

c
M10
o v
Click to summarize M_EXPOSURE_START

Specifies to use the exposure start signal as the trigger source. INFO

c
M10
o t
U28
v
Click to summarize M_GRAB_TRIGGER

Specifies to use the grab trigger source signal as the trigger source. INFO

c
M10
o t
U28
v
Click to summarize M_HSYNC

Specifies to use the horizontal synchronization signal as the trigger source.

j k
U29
l m p r
U27
y
U75
aa
Click to summarize M_ROTARY_ENCODER

Specifies to use the output of the default rotary decoder (set with M_ROTARY_ENCODER_OUTPUT_MODE) as the trigger source. INFO

j k
M10
m p r
U27
y
U75
aa
Click to summarize M_ROTARY_ENCODERn

Specifies to use rotary decoder n, where n is a number between 1 and 4. INFO

k
M10
y
U75
Click to summarize M_SOFTWARE

Specifies to use a software trigger as the trigger source. INFO

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_TIMERn

Specifies to use the output signal of the specified timer as the trigger source, where n is the timer number. INFO

c
M10
j k
M10
l m o p r
U27
v y
U75
aa
Click to summarize M_TL_TRIGGER

Specifies to use the transport layer trigger signal. INFO

k
M10
y
U75
Click to summarize M_VSYNC

Specifies to use the vertical synchronization signal as the trigger source.

j k
U29
l m p r
U27
y
U75
aa

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.

function map For inquiring the camera's exposure
Click to summarize
InquireType
Description MIL system-specific
tooltip (‡)
UserVarPtr
- Possible values returned
Click to summarize M_AUTO_EXPOSURE

Inquires the automatic exposure mode of the camera. SET

(summarize)
c
M10
o v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
M10
o v
Click to summarize M_AUTOMATIC

Specifies that the camera's exposure duration is constantly adapted by the device to maximize its effect.

c
M10
o v
Click to summarize M_DISABLE

Specifies that the camera will not control the gain, iris, and shutter settings automatically.

c
M10
o v
Click to summarize M_ENABLE

Specifies that the camera controls the gain, iris, and shutter settings automatically.

c
M10
o v
Click to summarize M_EXPOSURE_DELAY +

Inquires the required delay between the exposure trigger and the start of your camera's image sensor being exposed. SET

(summarize)
t
U28
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
t
U28
Click to summarize Value >= 0

Specifies the delay, in nsec.

t
U28
Click to summarize M_EXPOSURE_MODE

Inquires whether the exposure duration is set using an exposure timer or using the width of the trigger signal. SET

(summarize)
t
U28
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
t
U28
Click to summarize M_TIMED

Specifies to use M_EXPOSURE_TIME to control the length of the exposure.

t
U28
Click to summarize M_TRIGGER_WIDTH

Specifies to use duration of the active portion of the grab trigger's output signal to control the length of the exposure. INFO

t
U28
Click to summarize M_EXPOSURE_TIME +

Inquires the amount of time to expose the camera's image sensor. SET

(summarize)
c
M10
o t
U28
v
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
c
M10
o t
U28
v
Click to summarize Value >= 0

Specifies the amount of time to expose the camera's image sensor, in nsec.

c
M10
o t
U28
v

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
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize M_MAX_VALUE

Inquires the largest value supported.

c
M10
o t
U28
v
Click to summarize M_MIN_VALUE

Inquires the smallest value supported.

c
M10
o t
U28
v

The following inquire types and inquire values allow you to inquire the settings of a rotary decoder.

function map For inquiring the settings of a rotary decoder
Click to summarize
InquireType
Description MIL system-specific
tooltip (‡)
UserVarPtr
- Possible values returned
Click to summarize 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
M10
m p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
m p r
U27
y
U75
aa
Click to summarize M_AUX_IOn

Specifies the auxiliary input signal to use. INFO

j k
M10
m p r
U27
y
U75
aa
Click to summarize 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
M10
m p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
m p r
U27
y
U75
aa
Click to summarize M_AUX_IOn

Specifies the auxiliary input signal to use. INFO

j k
M10
m p r
U27
y
U75
aa
Click to summarize 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
M10
m p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
m p r
U27
y
U75
aa
Click to summarize M_BACKWARD

Specifies a backward direction of movement and to decrement the counter when the Gray code sequence is 00 - 01 - 11 - 10.

j k
M10
m p r
U27
y
U75
aa
Click to summarize M_FORWARD

Specifies a forward direction of movement and to increment the counter when the Gray code sequence is 00 - 01 - 11 - 10.

j k
M10
m p r
U27
y
U75
aa
Click to summarize 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
M10
m p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
m p r
U27
y
U75
aa
Click to summarize M_NULL

Specifies not to set the counter to 0xFFFFFFFF upon a signal.

j k
M10
m p r
U27
y
U75
aa
Click to summarize M_AUX_IOn

Specifies to use an auxiliary input signal or an auxiliary bidirectional signal set to input (using M_IO_MODE set to M_INPUT). INFO

j k
M10
m p r
U27
y
U75
aa
Click to summarize M_COUNTER_OVERFLOW

Specifies to set the counter to 0xFFFFFFFF and keep it at this value after the counter increments past 0x7FFFFFFF. INFO

j k
M10
m p r
U27
y
U75
aa
Click to summarize M_POSITION_TRIGGER

Specifies to use the trigger signal generated by the rotary decoder when the counter reaches the value specified with M_ROTARY_ENCODER_POSITION_TRIGGER.

j k
M10
m p r
U27
y
U75
aa
Click to summarize M_STEP_BACKWARD_WHILE_POSITIVE

Specifies to set the counter to 0xFFFFFFFF upon a decrement, only if the counter value is in the range of 0x0 to 0x7FFFFFFF before the decrement occurs; when interpreting the counter value as signed, this would be the positive counter value range. INFO

j k
M10
m p r
U27
y
U75
aa
Click to summarize M_TL_TRIGGER

Specifies to use a transport layer trigger input signal.

k
M10
y
U75
Click to summarize 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
M10
m p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
m p r
U27
y
U75
aa
Click to summarize 0 <= Value <= 429496295

Specifies the value of the rotary decoder's counter at the end of the last grab.

j k
M10
m p r
U27
y
U75
aa
Click to summarize 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
M10
m p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
m p r
U27
y
U75
aa
Click to summarize M_DISABLE

Specifies that the counter value will not be available to be inquired at the end of the last frame grabbed.

j k
M10
m p r
U27
y
U75
aa
Click to summarize 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
M10
m p r
U27
y
U75
aa
Click to summarize 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
M10
m p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
m p r
U27
y
U75
aa
Click to summarize 0 < Value <= 4096

Specifies the multiplying factor to use.

j k
M10
m p r
U27
y
U75
aa
Click to summarize 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
M10
p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
p r
U27
y
U75
aa
Click to summarize M_POSITION_TRIGGER

Specifies to output a pulse upon the trigger generated by M_ROTARY_ENCODER_POSITION_TRIGGER.

j k
M10
p r
U27
y
U75
aa
Click to summarize M_POSITION_TRIGGER_MULTIPLE

Specifies to start triggering only when the counter value set with M_ROTARY_ENCODER_POSITION_START_TRIGGER is reached and then to generate a trigger at a set interval (change) in counter value. INFO

k
U29
p r
U74
y
U75
aa
Click to summarize M_STEP_ANY

Specifies to output a pulse upon any change in the rotary decoder's counter value (position change in any direction).

j k
M10
p r
U27
y
U75
aa
Click to summarize M_STEP_ANY_WHILE_POSITIVE

Specifies to output a pulse upon any change in the rotary decoder's counter value (position change in any direction), only if the counter value is in the range of 0x0 to 0x7FFFFFFF before the increment or decrement occurs; when interpreting the counter value as signed, this would be the positive counter value range. INFO

j k
M10
p r
U27
y
U75
aa
Click to summarize M_STEP_FORWARD

Specifies to output a pulse upon a rotary decoder counter increment only.

j k
M10
p r
U27
y
U75
aa
Click to summarize M_STEP_FORWARD_WHILE_POSITIVE

Specifies to output a pulse upon a rotary decoder counter increment, only if the counter value is in the range of 0x0 to 0x7FFFFFFF before the increment occurs; when interpreting the counter value as signed, this would be the positive counter value range. INFO

j k
M10
p r
U27
y
U75
aa
Click to summarize M_ROTARY_ENCODER_POSITION +

Inquires the current value of the rotary decoder's counter.

(summarize)
j k
M10
m p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
m p r
U27
y
U75
aa
Click to summarize 0 <= Value <= 429497295

Specifies the current value of the counter.

j k
M10
m p r
U27
y
U75
aa
Click to summarize M_ROTARY_ENCODER_POSITION_START_TRIGGER +

Inquires the rotary decoder's counter value upon which to start generating triggers, when M_ROTARY_ENCODER_OUTPUT_MODE is set to M_POSITION_TRIGGER_MULTIPLE. If it is not set to this value, then M_ROTARY_ENCODER_POSITION_START_TRIGGER is ignored. SET

(summarize)
j k
M10
m p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
m p r
U27
y
U75
aa
Click to summarize 0 <= Value <= 0xFFFFFFFF

Specified the value of the counter upon which to start generating triggers.

j k
M10
m p r
U27
y
U75
aa
Click to summarize M_ROTARY_ENCODER_POSITION_TRIGGER +

Inquires the rotary decoder's counter value upon which a trigger is generated. SET

(summarize)
j k
M10
m p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
m p r
U27
y
U75
aa
Click to summarize 0 <= Value <= 0xFFFFFFFF

Specifies the value of the counter upon which a trigger is generated. If a value beyond the supported range is specified, an error is generated.

If you are treating the counter values as a signed range of values (for example, forcing the counter to reset to 0 at 0x80000000) and you want to generate a trigger upon a negative value, specify the equivalent value in the range of 0x80000000 to 0xFFFFFFFF.

If M_ROTARY_ENCODER_OUTPUT_MODE is set to M_POSITION_TRIGGER_MULTIPLE, this will specify the change in counter value at which to generate a trigger, beginning at the counter value specified by M_ROTARY_ENCODER_POSITION_START_TRIGGER.

If M_ROTARY_ENCODER_OUTPUT_MODE is set to M_POSITION_TRIGGER, this will specify the counter value at which to generate a trigger each time this value is reached.

If M_POSITION_TRIGGER is set to any other control value, this value will be ignored.

(summarize)
j k
M10
m p r
U27
y
U75
aa
Click to summarize M_ROTARY_ENCODER_RESET_SOURCE +

Inquires the signal source to use to reset the rotary decoder's counter to 0. SET

(summarize)
j k
M10
m p r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
j k
M10
m p r
U27
y
U75
aa
Click to summarize M_NULL

Specifies not to reset using a hardware signal source.

j k
M10
m p r
U27
y
U75
aa
Click to summarize M_AUX_IOn

Specifies to use an auxiliary input signal or an auxiliary bidirectional signal set to input (using M_IO_MODE set to M_INPUT). INFO

j k
M10
m p r
U27
y
U75
aa
Click to summarize M_POSITION_TRIGGER

Specifies to use the trigger signal generated by the rotary decoder when the counter reaches the value specified with M_ROTARY_ENCODER_POSITION_TRIGGER.

j k
M10
m p r
U27
y
U75
aa
Click to summarize M_TL_TRIGGER

Specifies to use a transport layer trigger input signal.

k
M10
y
U75
Combination value for the values listed in For inquiring the settings of a rotary decoder.

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
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize M_ROTARY_ENCODERn

Specifies to inquire rotary decoder n, where n is a number between 1 and 4. INFO

k
M10
y
U75

The following inquire types allow you to inquire the settings for one of the data latches of your installed MIL board. Data latches store information specific to a grabbed frame when the latch is triggered. To retrieve information from a data latch, use MdigGetHookInfo() with M_DATA_LATCH.... Note that data latch information is only available when MdigGetHookInfo() is called from a function hooked to an end-of-frame event using MdigHookFunction() with M_GRAB_FRAME_END or from the callback function (hooked using MdigProcess()).

function map For inquiring a data latch
Click to summarize
InquireType
Description MIL system-specific
tooltip (‡)
UserVarPtr
- Possible values returned
Click to summarize M_DATA_LATCH_CLOCK_FREQUENCY

Inquires the frequency of the clock when retrieving a timestamp in a data latch.

(summarize)
k
U29
r
U27
y
U75
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
k
U29
r
U27
y
U75
aa
Click to summarize Value

Specifies the frequency of the clock when retrieving a timestamp in a data latch, in Hz.

k
U29
r
U27
y
U75
aa
Click to summarize M_DATA_LATCH_MODE +

Inquires whether to latch data from the point when the first grab is queued until the start of the first frame of a series of queued grabs or grab sequence. SET

(summarize)
k
M10
p r
U27
y
U75
aa
MIL system specific

You must specify a combination value from the following table:
p r
U27
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
k
M10
p r
U27
y
U75
aa
Click to summarize M_NORMAL

Specifies not to latch before the start of the first grabbed frame.

k
M10
p r
U27
y
U75
aa
Click to summarize M_PREFETCH

Specifies to latch data before the start of the first grabbed frame.

k
M10
p r
U27
y
U75
aa
Click to summarize M_DATA_LATCH_STATE +

Inquires the state of the specified data latch. SET

(summarize)
k
M10
p r
U27
y
U75
aa
MIL system specific

You must specify a combination value from the following table:
p r
U27
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
k
M10
p r
U27
y
U75
aa
Click to summarize M_DISABLE

Specifies that the data latch is disabled.

k
M10
p r
U27
y
U75
aa
Click to summarize M_ENABLE

Specifies that the data latch is enabled.

k
M10
p r
U27
y
U75
aa
Click to summarize M_DATA_LATCH_TRIGGER_ACTIVATION +

Inquires the trigger signal transition upon which to store the specified information to the specified data latch. SET

(summarize)
k
M10
p r
U27
y
U75
aa
MIL system specific

You must specify a combination value from the following table:
p r
U27
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
k
M10
p r
U27
y
U75
aa
Click to summarize M_EDGE_FALLING

Specifies to store the specified information to the data latch upon a high-to-low signal transition.

k
M10
p r
U27
y
U75
aa
Click to summarize M_EDGE_RISING

Specifies to store the specified information to the data latch upon a low-to-high signal transition.

k
M10
p r
U27
y
U75
aa
Click to summarize M_DATA_LATCH_TRIGGER_SOURCE +

Inquires what triggers storing the specified information to the specified data latch. SET

(summarize)
k
M10
p r
U27
y
U75
aa
MIL system specific

You must specify a combination value from the following table:
p r
U27
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
k
M10
p r
U27
y
U75
aa
Click to summarize M_AUX_IOn

Specifies to use auxiliary signal n as the trigger source, where n is the auxiliary signal number. INFO

k
M10
p r
U27
y
U75
aa
Click to summarize M_GRAB_FRAME_END

Specifies to trigger the data latch on the event that occurs at the end of each grabbed frame; this event occurs when the frame grabber receives the last pixels (or packet) of a frame from the camera. INFO

k
M10
p r
U27
y
U75
aa
Click to summarize M_GRAB_FRAME_START

Specifies to trigger the data latch on the event that occurs at the start of each grabbed frame.

k
M10
p r
U27
y
U75
aa
Click to summarize M_GRAB_LINE

Specifies to trigger the data latch on the event that occurs at the end of each grabbed line; this event occurs when the frame grabber receives the last pixels (or packet) of a line from the camera. INFO

k
M10
p r
U27
y
U75
aa
Click to summarize M_TIMER_ACTIVE +

Specifies to trigger the data latch on the event that occurs when the specified timer is active. INFO

k
M10
p r
U27
y
U75
aa
Click to summarize M_DATA_LATCH_TYPE +

Inquires the type of information to store to the specified data latch. SET

(summarize)
k
M10
p r
U27
y
U75
aa
MIL system specific

You must specify a combination value from the following table:
p r
U27
aa
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
k
M10
p r
U27
y
U75
aa
Click to summarize M_IO_STATUS_ALL

Retrieves the status of all the auxiliary I/O signals.

k
M10
p r
U27
y
U75
aa
Click to summarize M_ROTARY_ENCODERn

Retrieves the value of the counter of rotary decoder n, where n is a number between 1 and 4. INFO

k
M10
p r
U27
y
U75
aa
Click to summarize M_TIME_STAMP

Retrieves the timestamp upon which the data latch is triggered, in ticks. INFO

k
M10
p r
U27
y
U75
aa

You must add the following value to the above-mentioned values to specify which data latch to inquire about.

function map For specifying the data latch to inquire
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize M_LATCHn

Inquires which data latch to affect, where n is a value from 0 to 15.

p r
U27
aa
Combination values for the following values of in-parameters: the values listed in For inquiring the settings of a timer.
Combination values for the following values of out-parameters: M_TIMER_ACTIVE (when InquireType=M_DATA_LATCH_TRIGGER_SOURCE and UserVarPtr=M_TIMER_ACTIVE).

The above-mentioned in-parameter values can be added to the following values. The above-mentioned out-parameter value might be returned combined with the following values. In either case, the following values are used to specify which on-board timer to inquire.

function map For specifying which on-board timer to inquire
Click to summarize
Combination value
Description MIL system-specific
tooltip (‡)
Click to summarize M_TIMER_STROBE

Inquires the strobe timer.

t
U28
Click to summarize M_TIMERn

Inquires on-board timer n, where n is one of the timers available on your Matrox imaging board or the hardware associated with your MIL driver. INFO

c
M10
j k
M10
l m o p r
U27
v y
U75
aa

The following inquire types allow you to inquire the settings of your GigE Vision camera. These settings are part of the GigE Vision Control Protocol (GVCP), described in the GigE Vision Specification version 2.0. The GVCP details GigE Vision specific settings to send and receive information across your network, as well as store information on your GigE Vision camera. Each inquire type specifies a family of capabilities within your GigE Vision device, where your camera is capable of using one or more features (although, each of these features is not necessarily enabled or configured). Note that, for these inquire types to be available, your GigE Vision camera must support one or more GigE Vision Control Protocol (GVCP) commands. Each of these inquire types returns a bitwise string, whose potential values are presented as inquire values. The inquire values are listed alphabetically; the bitwise order might differ.

function map For inquiring your GigE Vision camera's optional settings
Click to summarize
InquireType
Description MIL system-specific
tooltip (‡)
UserVarPtr
- Possible values returned
Click to summarize M_GC_CONTROL_PROTOCOL_CAPABILITY

Inquires the presence of one or more optional GigE Vision features on your camera. Note that a combination of the values below can be returned. Bitwise operators must be used to verify the presence of a specific capability.

(summarize)
c
U25
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT MORE
c
U25
Click to summarize M_GC_ACTION_SUPPORT

Specifies that your camera supports action commands. To configure an action command, use MsysControl() with M_GC_ACTION... + M_GC_ACTIONn, where n is the action number. Configure your camera, using MdigControlFeature() or Matrox Feature Browser (accessible through Matrox Intellicam or MdigControl() with M_GC_FEATURE_BROWSER) with the appropriate device features.

(summarize)
c
U25
Click to summarize M_GC_CONCATENATION_SUPPORT

Specifies that your camera supports concatenating multiple messages of a certain type into a single packet.

c
U25
Click to summarize M_GC_DISCOVERY_ACK_DELAY_SUPPORT

Specifies that your camera supports reading the discovery acknowledgment delay field. The discovery acknowledgment delay is the maximum delay permitted before the GenICam-compliant device sends a discovery acknowledgment. On some GenICam-compliant devices, this period is static; on others, it is an automatically established amount of time when the device boots. To inquire whether the discovery acknowledgment delay field on your GenICam-compliant device is a static amount, or changes when the camera boots, use M_GC_WRITABLE_DISCOVERY_ACK_DELAY_SUPPORT.

(summarize)
c
U25
Click to summarize M_GC_EVENT_DATA_SUPPORT

Specifies that your camera supports event-data messages. This means that when an event occurs on the camera, the camera can notify the application of the events and attach camera-specific data to the message.

(summarize)
c
U25
Click to summarize M_GC_EVENT_SUPPORT

Specifies that your camera supports sending event messages. Event messages notify the application of events occurring on the camera.

(summarize)
c
U25
Click to summarize M_GC_EXTENDED_STATUS_CODES_1_SUPPORT

Specifies that your camera supports the extended status codes introduced in the GigE Vision specification, version 1.1.

c
U25
Click to summarize M_GC_EXTENDED_STATUS_CODES_2_SUPPORT

Specifies that your camera supports the extended status codes introduced in the GigE Vision specification, version 2.0.

c
U25
Click to summarize M_GC_HEARTBEAT_DISABLE_SUPPORT

Specifies that your camera supports disabling the heartbeat mechanism. The heartbeat mechanism is used to inform your GigE Vision camera that communication between your MIL application and the camera is still likely even though the camera has not contacted your application recently.

(summarize)
c
U25
Click to summarize M_GC_IEEE_1588_SUPPORT

Specifies that your camera supports the IEEE 1588 standard for the precision time protocol. To configure an action command to use a scheduled time, use MsysControl() with M_GC_ACTION_TIME + M_GC_ACTIONn, where n is the action number. Enable the 1588 feature(s) on your camera, using MdigControlFeature() or Matrox Feature Browser (accessible through Matrox Intellicam or MdigControl() with M_GC_FEATURE_BROWSER) with the appropriate device features (for example, using the GevIEEE1588 feature).

(summarize)
c
U25
Click to summarize M_GC_LINK_SPEED_REGISTER_SUPPORT

Specifies that your camera supports storing the Ethernet link speed of the camera's network interface, in Mbits/sec.

c
U25
Click to summarize M_GC_MANIFEST_TABLE_SUPPORT

Specifies that your camera supports a manifest table, which stores the camera's device description file (XML).

c
U25
Click to summarize M_GC_PACKET_RESEND_SUPPORT

Specifies that your camera supports resending lost packets.

c
U25
Click to summarize M_GC_PENDING_ACK_SUPPORT

Specifies that your camera supports a pending acknowledgment packet. A pending acknowledged packet indicates that the processing of a command will take a longer period than expected to execute. If your camera is capable of using such a feature, it will then increase the amount of time your application will wait before causing a timeout.

(summarize)
c
U25
Click to summarize M_GC_PORT_AND_IP_REGISTER_SUPPORT

Specifies that your camera supports the control channel's primary port and IP address.

c
U25
Click to summarize M_GC_PRIMARY_APP_SWITCHOVER_SUPPORT

Specifies that your camera supports primary application switchover. A primary application is an application granted full access to your camera. A primary application switchover occurs when two applications, both with the same level of access, trade control over your camera.

(summarize)
c
U25
Click to summarize M_GC_SCHEDULED_ACTION_SUPPORT

Specifies that your camera supports scheduling commands at a specific time in the future. To configure an action command to use a scheduled time, use MsysControl() with M_GC_ACTION_TIME + M_GC_ACTIONn, where n is the action command number. Enable the IEEE 1588 features on your camera, using MdigControlFeature() or Matrox Feature Browser (accessible through Matrox Intellicam or MdigControl() with M_GC_FEATURE_BROWSER) with the appropriate device feature (for example, using the GevIEEE1588 feature).

(summarize)
c
U25
Click to summarize M_GC_SERIAL_NUMBER_SUPPORT

Specifies that your camera supports storing the camera's serial number.

c
U25
Click to summarize M_GC_TEST_DATA_SUPPORT

Specifies that your camera supports creating and using a test packet to determine the size of the largest packet that your camera can transmit without error.

c
U25
Click to summarize M_GC_UNCONDITIONAL_ACTION_SUPPORT

Specifies that your camera supports action messages, even when the primary control channel is closed.

c
U25
Click to summarize M_GC_USER_DEFINED_NAME_SUPPORT

Specifies that your camera supports storing a user-defined name.

c
U25
Click to summarize M_GC_WRITABLE_DISCOVERY_ACK_DELAY_SUPPORT

Specifies that your camera supports changing the discovery acknowledgment delay value when the camera boots. The discovery acknowledgment delay is the maximum delay permitted before the GenICam sends a discovery acknowledgment. On some GenICam devices, this period is static, while on others it is a random amount of time. To inquire whether the discovery acknowledgment delay field is supported on your GenICam device, use M_GC_DISCOVERY_ACK_DELAY_SUPPORT.

(summarize)
c
U25
Click to summarize M_GC_WRITE_MEM_SUPPORT

Specifies that your camera supports having the primary application write to the camera's memory.

c
U25
Click to summarize M_GC_MESSAGE_PROTOCOL_CAPABILITY

Inquires whether your camera has one or more message channels available and their settings.

(summarize)
c
U25
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
c
U25
Click to summarize M_NULL

Specifies that no options are supported for the message channel.

c
U25
Click to summarize M_GC_FIREWALL_TRAVERSAL_SUPPORT

Specifies that the firewall will not block message packets.

c
U25
Click to summarize M_GC_NETWORK_INTERFACE_CAPABILITY

Inquires whether your camera supports a series of networking interface options. Note that a combination of the values below can be returned. Bitwise operators must be used to verify the presence of a specific capability.

(summarize)
c
U25
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT MORE
c
U25
Click to summarize M_GC_DHCP_SUPPORT

Specifies that your camera supports DHCP.

c
U25
Click to summarize M_GC_LINK_LOCAL_ADDRESS_SUPPORT

Specifies that your camera supports link-local addresses (LLA). A LLA is an IPv4 address in the 169.254.0.0/16 range.

(summarize)
c
U25
Click to summarize M_GC_PAUSE_GENERATION_SUPPORT

Specifies that your camera supports generating Ethernet pause frames that halt the transmissions from the Host to the camera for a period of time. Pause frames are a common way of controlling Ethernet flow control.

(summarize)
c
U25
Click to summarize M_GC_PAUSE_RECEPTION_SUPPORT

Specifies that your camera supports receiving Ethernet pause frames that halt the transmissions from the camera for a period of time. Pause frames are a common method of Ethernet flow control.

(summarize)
c
U25
Click to summarize M_GC_PERSISTENT_IP_SUPPORT

Specifies that your camera supports storing a persistent (static) IP address.

c
U25
Click to summarize M_GC_NETWORK_INTERFACE_CONFIGURATION

Inquires which network and IP configuration schemes are enabled and in use on your current network. Note that a combination of the values below can be returned (for example, M_GC_PAUSE_RECEPTION_SUPPORT + M_GC_PAUSE_GENERATION_SUPPORT + M_GC_LINK_LOCAL_ADDRESS_SUPPORT). Bitwise operators must be used to verify the presence of a specific capability.

(summarize)
c
U25
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT MORE
c
U25
Click to summarize M_GC_DHCP_SUPPORT

Specifies that your camera is using DHCP.

c
U25
Click to summarize M_GC_LINK_LOCAL_ADDRESS_SUPPORT

Specifies that your camera is using link-local addresses (LLA). A LLA is an IPv4 address in the 169.254.0.0/16 range.

(summarize)
c
U25
Click to summarize M_GC_PAUSE_GENERATION_SUPPORT

Specifies that your camera is using generating Ethernet pause frames that halt the transmissions from the Host to the camera for a period of time. Pause frames are a common way of controlling Ethernet flow control.

(summarize)
c
U25
Click to summarize M_GC_PAUSE_RECEPTION_SUPPORT

Specifies that your camera is using receiving Ethernet pause frames that halt the transmissions from the camera for a period of time. Pause frames are a common method of Ethernet flow control.

(summarize)
c
U25
Click to summarize M_GC_PERSISTENT_IP_SUPPORT

Specifies that your camera is using storing a persistent (static) IP address.

c
U25
Click to summarize M_GC_PHYSICAL_LINK_CONFIGURATION_CAPABILITY

Inquires whether your camera supports a dynamic or static link aggregation group (LAG) in either a multiple or single link configuration. Note that a combination of the values below can be returned. Bitwise operators must be used to verify the presence of a specific capability.

(summarize)
c
U25
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT MORE
c
U25
Click to summarize M_GC_DYNAMIC_LINK_AGGREGATION_SUPPORT

Specifies that your camera supports a dynamically configured LAG.

c
U25
Click to summarize M_GC_MULTIPLE_LINK_SUPPORT

Specifies that your camera supports multiple links.

c
U25
Click to summarize M_GC_SINGLE_LINK_SUPPORT

Specifies that your camera supports a single link.

c
U25
Click to summarize M_GC_STATIC_LINK_AGGREGATION_SUPPORT

Specifies that your camera supports a static LAG.

c
U25
Click to summarize M_GC_STREAM_CHANNEL_CAPABILITY

Inquires the list of capabilities specific to the stream channels of your camera. Note that a combination of the values below can be returned. Bitwise operators must be used to verify the presence of a specific capability.

(summarize)
c
U25
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT MORE
c
U25
Click to summarize M_GC_ALL_IN_SUPPORT

Specifies that the stream channel supports the All-in transmission mode when transmitting data.

c
U25
Click to summarize M_GC_BIG_AND_LITTLE_ENDIAN_SUPPORT

Specifies that your camera supports both big and little-endian on the stream channel. Note that all stream channels must support little-endian.

(summarize)
c
U25
Click to summarize M_GC_EXTENDED_CHUNK_DATA_SUPPORT

Specifies that the stream channel supports an older formatting for chunk data.

c
U25
Click to summarize M_GC_IP_REASSEMBLY_SUPPORT

Specifies that the stream channel(s) supports the reassembly of fragmented IP packets when receiving data.

c
U25
Click to summarize M_GC_MULTI_ZONE_SUPPORT

Specifies that the stream channel supports transmission of uncompressed image data that is sliced into horizontal strips.

c
U25
Click to summarize M_GC_PACKET_RESEND_OPTION_SUPPORT

Specifies that the stream channel supports unconditional streaming capabilities when transmitting.

c
U25
Click to summarize M_GC_UNCONDITIONAL_STREAMING_SUPPORT

Specifies that the stream channel supports alternate destinations for packet resend requests.

c
U25
Click to summarize M_GC_STREAM_PROTOCOL_CAPABILITY

Inquires how GVSP traffic (typically, unidirectional in nature) supports bypassing the firewall or other network restrictions. Note that a combination of the values below can be returned. Bitwise operators must be used to verify the presence of a specific capability.

(summarize)
c
U25
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT MORE
c
U25
Click to summarize M_GC_FIREWALL_TRAVERSAL_SUPPORT

Specifies that the firewall will not block message packets.

c
U25
Click to summarize M_GC_LEGACY_16BIT_BLOCK_SUPPORT

Specifies that your camera supports legacy GEV 1.x stream mode.

(summarize)
c
U25
Return value
The returned value is the requested information, cast to a MIL_INT. If the requested information does not fit into a MIL_INT, this function will return M_NULL or truncate the information.
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 PRESENT NO YES CAMERA UNLOCK SENSITIVITY CAMERA VENDOR 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 300 300C 1300 1300C 2000 2000C 5000 5000C EXTENDED INIT FLAG DEFAULT DEV NUMBER EMULATED GC DEVICE IP ADDRESS GC DEVICE NAME MINIMAL FIX PATTERN NOISE CORRECTION PREPROCESSING SENSOR FOCUS FOCUS PERSISTENCE DISABLE ENABLE FOCUS PERSISTENT VALUE FORMAT DEFAULT" NULL CCIR" NTSC" NTSC RGB" NTSC YC" PAL" PAL RGB" PAL YC" RS170" FORMAT DETECTED GC CAMERA TIME STAMP 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 LOCAL CONTROL PORT GC LOCAL IP ADDRESS GC LOCAL IP ADDRESS STRING GC LOCAL MAC ADDRESS GC LOCAL MAC ADDRESS STRING GC LOCAL MESSAGE PORT GC LOCAL STREAM PORT GC MAX NBR PACKETS OUT OF ORDER GC MESSAGE CHANNEL MULTICAST ADDRESS STRING GC MULTICAST MASTER CONNECTED FALSE TRUE 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 STRING GC PIXEL FORMAT SWITCHING DISABLE ENABLE GC REMOTE CONTROL PORT GC REMOTE IP ADDRESS GC REMOTE IP ADDRESS STRING GC REMOTE MAC ADDRESS GC REMOTE MAC ADDRESS STRING GC REMOTE MESSAGE PORT GC REMOTE STREAM PORT GC SCHEMA MAJOR GC SCHEMA MINOR GC SERIAL NUMBER GC SPECIFIC INFO GC STREAM CHANNEL MULTICAST ADDRESS STRING 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 USER NAME GC VERSION GC XML MAJOR GC XML MINOR GC XML PATH GC XML SUBMINOR GENTL INTERFACE INDEX GENTL STREAM COUNT GRAB DIRECTION X FORWARD REVERSE GRAB DIRECTION Y FORWARD REVERSE GRAB FIELD NUM GRAB FRAME MISSED GRAB FRAME MISSED COUNTER DISABLE ENABLE GRAB IN PROGRESS NO YES GRAB LINE COUNTER DISABLE ENABLE GRAB LUT PALETTE DEFAULT GAMMA 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 INPUT FILTER AUTOMATIC BYPASS LOW PASS 0 LOW PASS 1 INPUT MODE ANALOG DIGITAL LAST GRAB IN TRUE BUFFER DISABLE ENABLE LIGHTING BRIGHT FIELD LUT ID DEFAULT NUMBER DEVn OWNER SYSTEM POWER OVER CABLE OFF ON 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 SIGN SIGNED UNSIGNED SIZE BAND SIZE BAND LUT SIZE BIT SIZE X SIZE Y SOURCE DATA FORMAT PACKED PLANAR SOURCE NUMBER OF FRAMES INFINITE SOURCE OFFSET X SOURCE OFFSET Y SOURCE SIZE X SOURCE SIZE Y TARGET BUFFER OBJECT CONTAINER IMAGE TL TRIGGER ACTIVATION ANY EDGE EDGE RISING TYPE SIGNED UNSIGNED VIDEO OUTPUT NULL CHn WHITE BALANCE DISABLE ENABLE FAST 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 STRING SIZE BLACK OFFSET BLACK REF BRIGHTNESS REF CONTRAST REF HUE REF SATURATION REF WHITE REF ALL REF CH0 REF CH1 REF CH2 REF CH3 REF VOLTAGE GAIN GRAB AUTOMATIC INPUT GAIN DISABLE ENABLE GRAB INPUT GAIN GAIN0 GAIN1 GAIN2 GAIN3 MAX LEVEL MIN LEVEL SHADING CORRECTION DISABLE ENABLE SHADING CORRECTION GAIN FIXED POINT SHADING CORRECTION GAIN ID NULL UNSIGNED SHADING CORRECTION OFFSET ID NULL UNSIGNED CHn 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 MISSED DISABLE ENABLE GRAB TRIGGER OVERLAP DISABLE ENABLE OFF PREVIOUS FRAME RESET GRAB TRIGGER SOURCE NULL AUX IOn HSYNC IO COMMAND LIST1 ROTARY ENCODER ROTARY ENCODERn SOFTWARE SOFTWAREn TIMERn TL TRIGGER VSYNC GRAB TRIGGER STATE DISABLE ENABLE IO COMMAND BITn GRAB FRAME BURST END TRIGGER SOURCE AUX IOn GRAB FRAME BURST END TRIGGER STATE DISABLE ENABLE GRAB FRAME BURST MAX TIME INFINITE GRAB FRAME BURST SIZE TIMER CLOCK FREQUENCY TIMER CLOCK SOURCE HSYNC PIXCLK SYSCLK TIMERn VSYNC TIMER DELAY TIMER DELAY2 TIMER DURATION TIMER DURATION2 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 OVERLAP LATCH OFF RESET TIMER TRIGGER RATE DIVIDER TIMER TRIGGER SOURCE NULL AUX IOn CONTINUOUS EXPOSURE END EXPOSURE START GRAB TRIGGER HSYNC ROTARY ENCODER ROTARY ENCODERn SOFTWARE TIMERn TL TRIGGER VSYNC AUTO EXPOSURE AUTOMATIC DISABLE ENABLE EXPOSURE DELAY EXPOSURE MODE TIMED TRIGGER WIDTH EXPOSURE TIME MAX VALUE MIN VALUE 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 POSITION TRIGGER MULTIPLE STEP ANY STEP ANY WHILE POSITIVE STEP FORWARD STEP FORWARD WHILE POSITIVE ROTARY ENCODER POSITION ROTARY ENCODER POSITION START TRIGGER ROTARY ENCODER POSITION TRIGGER ROTARY ENCODER RESET SOURCE NULL AUX IOn POSITION TRIGGER TL TRIGGER ROTARY ENCODERn DATA LATCH CLOCK FREQUENCY DATA LATCH MODE NORMAL PREFETCH DATA LATCH STATE DISABLE ENABLE DATA LATCH TRIGGER ACTIVATION EDGE FALLING EDGE RISING DATA LATCH TRIGGER SOURCE AUX IOn GRAB FRAME END GRAB FRAME START GRAB LINE TIMER ACTIVE DATA LATCH TYPE IO STATUS ALL ROTARY ENCODERn TIME STAMP LATCHn TIMER STROBE TIMERn GC CONTROL PROTOCOL CAPABILITY GC ACTION SUPPORT GC CONCATENATION SUPPORT GC DISCOVERY ACK DELAY SUPPORT GC EVENT DATA SUPPORT GC EVENT SUPPORT GC EXTENDED STATUS CODES 1 SUPPORT GC EXTENDED STATUS CODES 2 SUPPORT GC HEARTBEAT DISABLE SUPPORT GC IEEE 1588 SUPPORT GC LINK SPEED REGISTER SUPPORT GC MANIFEST TABLE SUPPORT GC PACKET RESEND SUPPORT GC PENDING ACK SUPPORT GC PORT AND IP REGISTER SUPPORT GC PRIMARY APP SWITCHOVER SUPPORT GC SCHEDULED ACTION SUPPORT GC SERIAL NUMBER SUPPORT GC TEST DATA SUPPORT GC UNCONDITIONAL ACTION SUPPORT GC USER DEFINED NAME SUPPORT GC WRITABLE DISCOVERY ACK DELAY SUPPORT GC WRITE MEM SUPPORT GC MESSAGE PROTOCOL CAPABILITY NULL GC FIREWALL TRAVERSAL SUPPORT GC NETWORK INTERFACE CAPABILITY GC DHCP SUPPORT GC LINK LOCAL ADDRESS SUPPORT GC PAUSE GENERATION SUPPORT GC PAUSE RECEPTION SUPPORT GC PERSISTENT IP SUPPORT GC NETWORK INTERFACE CONFIGURATION GC DHCP SUPPORT GC LINK LOCAL ADDRESS SUPPORT GC PAUSE GENERATION SUPPORT GC PAUSE RECEPTION SUPPORT GC PERSISTENT IP SUPPORT GC PHYSICAL LINK CONFIGURATION CAPABILITY GC DYNAMIC LINK AGGREGATION SUPPORT GC MULTIPLE LINK SUPPORT GC SINGLE LINK SUPPORT GC STATIC LINK AGGREGATION SUPPORT GC STREAM CHANNEL CAPABILITY GC ALL IN SUPPORT GC BIG AND LITTLE ENDIAN SUPPORT GC EXTENDED CHUNK DATA SUPPORT GC IP REASSEMBLY SUPPORT GC MULTI ZONE SUPPORT GC PACKET RESEND OPTION SUPPORT GC UNCONDITIONAL STREAMING SUPPORT GC STREAM PROTOCOL CAPABILITY GC FIREWALL TRAVERSAL SUPPORT GC LEGACY 16BIT BLOCK SUPPORT M_CHn M_DEVn M_CHn M_CHn M_AUX_IOn M_TIMERn M_USER_BIT_CC_IOn M_USER_BITn M_AUX_IOn M_CC_IOn M_USER_BIT_CC_IOn M_USER_BITn M_AUX_IOn M_ROTARY_ENCODERn M_SOFTWAREn M_TIMERn M_IO_COMMAND_BITn M_AUX_IOn M_TIMERn M_AUX_IOn M_ROTARY_ENCODERn M_TIMERn M_AUX_IOn M_AUX_IOn M_AUX_IOn M_AUX_IOn M_ROTARY_ENCODERn M_AUX_IOn M_ROTARY_ENCODERn M_LATCHn M_TIMERn