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

MdigControl



Function Map
Parameter Associations
Table: For the general digitizer settings
+ combination: For specifying the configuration file associated with the feature
+ combination: For specifying to wait for the camera to perform its focusing operation.
+ combination: For specifying the speed and precision of the interpolation.
+ combination: For specifying whether Matrox Feature Browser should be synchronous or asynchronous
+ combination: For specifying whether to enable anti-aliasing and/or dithering
Table: For the general reference settings
+ combination: For specifying the acquisition path
+ combination: For controlling the reference level of a specific acquisition path
+ combination: For specifying the reference level in Volts
Table: For controlling the input gain and shading correction
+ combination: For specifying the acquisition path for the input gain
+ combination: For specifying the specific video signal component to apply the input-gain setting
Table: For routing I/O signals and setting their mode
+ combination: For specifying the type and number of the I/O signal to affect
Table: For setting the state of specified user-bits in a static-user-output register
+ combination: For specifying the bit in a static-user-output register to affect
+ combination: For specifying the static-user-output register
Table: For controlling the settings to grab using a trigger
+ combination: For specifying which I/O command register bit to use
Table: For controlling frame bursts
Table: For controlling the settings of a timer
Table: For controlling the camera's exposure
Table: For controlling the settings of a quadrature decoder with inputs from a rotary or linear encoder
+ combination: For specifying which rotary decoder to set
Table: For controlling a data latch
+ combination: For specifying the data latch to affect
+ combination: For specifying which on-board timer to control
Synopsis
Control a digitizer setting.
Syntax
void MdigControl(
MIL_ID DigId, //in
MIL_INT64 ControlType, //in
MIL_DOUBLE ControlValue //in
)
Description

This function allows you to control various digitizer settings.

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

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

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

[Matrox Radient eCL; Matrox Radient eV-CL (introduced U27); Matrox Radient eV-CXP (introduced M10); Matrox RadientPro-CL (Update 7); Matrox Rapixo CL Pro (Update 96); Matrox Rapixo CXP (introduced U75); Matrox Solios eA/XA; Matrox Solios ecl/xcl/ev-cl]

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

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

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

Typically, the supported control types affect the GenICam-compliant camera (or device) associated with the digitizer. These control 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 MdigControlFeature() with the device-specific feature names and values specified by the device manufacturer.

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

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

Specifies the identifier of the digitizer.

ControlType

Specifies the digitizer setting to control.

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

ControlValue

Specifies the value to assign to the digitizer setting.

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

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

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

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

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

(summarize)
c
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 control type is used to perform Bayer conversion if performed by the Host. To control the Bayer conversion on the camera, use MdigControlFeature(); refer to your camera's documentation for details regarding the features to set.

c
M10
o v

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

m

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

t
U28
Click to summarize M_DEFAULT

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

(summarize)
c
M10
o t
U28
v
Click to summarize MIL array buffer identifier

Specifies the identifier of an M_ARRAY buffer containing the white balance coefficients. The buffer must be allocated as a single-band 32-bit floating-point buffer with a 3x1 dimension. For more information, see White balancing your Bayer images.

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

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

For a more conventional technique of controlling Bayer conversion, use MbufBayer() and see White balancing your Bayer images. INQ

(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 control type is used to perform Bayer conversion if performed by the Host. To control the Bayer conversion on the camera, use MdigControlFeature(); refer to your camera's documentation for details regarding the features to set.

c
M10
o v

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

m

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

t
U28
Click to summarize M_DEFAULT

Same as M_ENABLE.

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. Note that to white balance an image, M_WHITE_BALANCE must also be set to M_ENABLE.

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

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

(summarize)
g
Click to summarize M_DEFAULT

Same as M_ENABLE.

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_LOCK

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

(summarize)
g l
Click to summarize M_DEFAULT

Same as M_ENABLE.

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. Corrupt images or a synchronization-lost error can occur if the digitizer is not locked.

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

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

(summarize)
g
Click to summarize M_DEFAULT

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

g
Click to summarize 0 <= Value <= 511

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

(summarize)
g
Click to summarize M_CAMERA_UNLOCK_SENSITIVITY

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

(summarize)
g
Click to summarize M_DEFAULT

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

g
Click to summarize 0 <= Value <= 255

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

(summarize)
g
Click to summarize M_CHANNEL

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

(summarize)
g i l u
U36
Click to summarize M_DEFAULT

Same as M_CH0.

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.

(summarize)
g i l u
U36
MIL system specific

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

For CVBS input, this corresponds to VID_IN2 (Green of camera 0).

u
U36

For monochrome or composite input, this corresponds to VID_IN0 .

g

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

g

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

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

i

This corresponds to a signal whose name ends with A.

l
Click to summarize M_CH1

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

(summarize)
g i l u
U36
MIL system specific

For Y/C input, this corresponds to VID_IN6 (Luminance of camera 1) and VID_IN5 (Chrominance of camera 1).

For CVBS input, this corresponds to VID_IN5 (Chrominance of camera 1).

u
U36

For monochrome or composite input, this corresponds to VID_IN1 .

g

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

l

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

g

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

i
Click to summarize M_CH2

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

(summarize)
g i u
U36
MIL system specific

For CVBS input, this corresponds to VID_IN6 (Luminance of camera 2).

u
U36

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

g
Click to summarize M_CH3

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

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

(summarize)
g
MIL system specific

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

g
Click to summarize M_CH4

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

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

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

(summarize)
g
Click to summarize M_CH5

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

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

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

(summarize)
g
Click to summarize M_CH6

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

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

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

(summarize)
g
Click to summarize M_CH7

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

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

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

(summarize)
g
Click to summarize M_CH8

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

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

(summarize)
g
Click to summarize M_CH9

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

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

(summarize)
g
Click to summarize M_CH10

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

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

(summarize)
g
Click to summarize M_CH11

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

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

(summarize)
g
Click to summarize M_CH12

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

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

(summarize)
g
Click to summarize M_CH13

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

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

(summarize)
g
Click to summarize M_CH14

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

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

(summarize)
g
Click to summarize M_CH15

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

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

(summarize)
g
Click to summarize M_COMMAND_QUEUE_MODE

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

(summarize)
j k
M10
l m p r
U27
y
U75
aa
Click to summarize M_DEFAULT

Same as M_QUEUED.

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. Note that, this can cause the grabbed image to become corrupt.

(summarize)
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. Instead, the changes are queued and applied before the very next grab.

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

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

(summarize)
c
M10
i o t
U28
u
U36
v
MIL system specific

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

c
M10
o v
Click to summarize M_DEFAULT

Same as M_ENABLE.

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_DIGITIZER_INTERNAL_BUFFERS_NUM

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

(summarize)
c
M10
o v
Click to summarize M_DEFAULT

Specifies the default value; the default value is 5.

c
M10
o v
Click to summarize Value >= 0

Specifies the number of internal grab buffers.

c
M10
o v
Click to summarize M_FIX_PATTERN_NOISE_CORRECTION

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

(summarize)
t
U28
Click to summarize M_DEFAULT

Same as M_PREPROCESSING.

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. MIL calculates the correction factor(s) when the control type is called.

(summarize)
t
U28
Click to summarize M_SENSOR

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

(summarize)
t
U28
Click to summarize M_FOCUS +

Sets the lens focus capabilities.

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

(summarize)
t
U28
Click to summarize Min. focus <= Value <= Max. focus

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

(summarize)
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. This stored focus position is written to the I 2 C (inter-integrated circuit) controlled lens when the smart camera is allocated, using MdigAlloc(). If there is no I 2 C (inter-integrated circuit) controlled lens attached, the value is ignored. INQ

(summarize)
t
U28
Click to summarize M_DEFAULT

Same as M_DISABLE.

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

Sets the focus position to store 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. INQ

(summarize)
t
U28
Click to summarize 0 <= Value <= 1023

Specifies to store the focus position.

t
U28
Click to summarize M_GC_CLPROTOCOL

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

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

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

(summarize)
j m p r
U27
aa
Click to summarize M_DEFAULT

Same as M_DISABLE.

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

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

Note that this control type should be used only if using a GenCP-compliant camera or after the required third-party vendor-supplied, standard compliant, CLProtocol library for the Camera Link camera is installed on your computer.

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

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

(summarize)
j m p r
U27
aa
Click to summarize
M_PTR_TO_DOUBLE(
MIL_CONST_TEXT_PTR String
)

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

(summarize)
j m p r
U27
aa
Parameters

This parameter specifies the string whose address to cast.

j m p r
U27
aa
MIL_TEXT("M_DEFAULT") 1

Specifies to use the default identifier string of your Camera Link camera and its corresponding GenICam CLProtocol library, specified using the MILConfig utility.

j m p r
U27
aa
MIL_TEXT("CameraLinkCameraIdentifier") 1

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

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

j m p r
U27
aa
Click to summarize M_GC_FEATURE_BROWSER +

Sets whether to open or close a window that allows you to view and edit the GenICam-compliant camera configuration information interactively; this widow is referred to as Matrox Feature Browser.

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

Note that, this control 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 m p r
U27
aa

The Matrox GenTL Consumer driver allows you to edit the GenICam-compliant stream, device, or remote device configuration information.

v
Click to summarize M_DEFAULT

Same as M_OPEN.

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

Closes Matrox Feature Browser.

c
M10
j k
M10
m o p r
U27
u
U36
v y
U75
aa
Click to summarize M_OPEN +

Opens Matrox Feature Browser.

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

You must specify a combination value from the following table:
c
M10
k
M10
m o u
U36
v y
U75
Click to summarize M_GC_FEATURE_POLLING

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

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

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

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

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

Note that, this control 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 m p r
U27
aa
Click to summarize M_DEFAULT

Same as M_DISABLE.

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

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

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

(summarize)
c
M10
Click to summarize M_DEFAULT

Specifies the default value; the default value is 30.

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.

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

(summarize)
c
M10
Click to summarize M_GC_FRAME_TIMEOUT

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

(summarize)
c
M10
Click to summarize M_DEFAULT

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

c
M10
Click to summarize Value >= 0

Specifies the maximum time to wait, in msec.

c
M10
Click to summarize M_GC_HEARTBEAT_STATE

Sets whether the heartbeat mechanism is used to keep the GigE Vision-compliant camera active. The heartbeat mechanism is used to inform your camera that communication between your MIL application and the camera is still open.

If your application experiences a fatal error while the heartbeat mechanism is disabled, you will be unable to reconnect to your camera until you manually restart it. You should therefore typically disable the heartbeat mechanism only when required for debugging your application. If you experience timeouts when your application is running under normal circumstances, you should extend the heartbeat timeout period using M_GC_HEARTBEAT_TIMEOUT instead. INQ

(summarize)
c
M10
Click to summarize M_DEFAULT

Same as M_ENABLE.

c
M10
Click to summarize M_DISABLE

Specifies that the heartbeat mechanism is disabled. The camera always assumes communication will continue and remains active indefinitely.

(summarize)
c
M10
Click to summarize M_ENABLE

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

(summarize)
c
M10
Click to summarize M_GC_HEARTBEAT_TIMEOUT

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

(summarize)
c
M10
Click to summarize M_DEFAULT

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

c
M10
Click to summarize Value >= 0

Specifies the amount of time, in msec.

c
M10
Click to summarize M_GC_INTER_PACKET_DELAY

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

The unit used is a timestamp tick. If you know the inter-packet delay in 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 MdigInquire() with M_GC_COUNTER_TICK_FREQUENCY), and n is your inter-packet delay value. INQ

(summarize)
c
M10
Click to summarize Value >= 0

Specifies the delay, in timestamp ticks.

c
M10
Click to summarize M_GC_LOCAL_MESSAGE_PORT

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

This control type is only available when dealing with a multicast master or monitor (allocated using MdigAlloc() with M_GC_MULTICAST_MASTER or M_GC_MULTICAST_MONITOR). For more information on using a multicast IP address, refer to the Using IP multicast section of the Matrox GigE Vision driver chapter in the MIL Hardware-specific Notes. INQ

(summarize)
c
M10
Click to summarize 0 <= Value <=66535

Specifies the port number.

c
M10
Click to summarize M_GC_LOCAL_STREAM_PORT

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

This control type is only available when dealing with a multicast master or monitor (allocated using MdigAlloc() with M_GC_MULTICAST_MASTER or M_GC_MULTICAST_MONITOR). For more information on using a multicast IP address, refer to the Using IP multicast section of the Matrox GigE Vision driver chapter in the MIL Hardware-specific Notes. INQ

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

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

(summarize)
c
M10
Click to summarize M_DEFAULT

Specifies the default value; the default value is 0.

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

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

This control 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). For more information on using a multicast IP address, refer to the Using IP multicast section of the Matrox GigE Vision driver chapter in the MIL Hardware-specific Notes. INQ

(summarize)
c
M10
Click to summarize
M_PTR_TO_DOUBLE(
MIL_CONST_TEXT_PTR String
)

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

(summarize)
c
M10
Parameters

This parameter specifies the string whose address to cast.

c
M10
MIL_TEXT("239.n.n.n") 1

Specifies the multicast IP address of the camera, in dotted decimal notation where each dotted decimal value (n) is a number between 0 and 255.

c
M10
Click to summarize M_GC_PACKET_MAX_RETRIES

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

(summarize)
c
M10
Click to summarize M_DEFAULT

Specifies the default value; the default value is 3.

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.

Note that this value should always be less than M_GC_FRAME_MAX_RETRIES.

(summarize)
c
M10
Click to summarize M_GC_PACKET_RESEND

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

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

This is the default value.

(summarize)
c
M10
Click to summarize M_GC_PACKET_SIZE

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

(summarize)
c
M10
Click to summarize Value >= 0

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

(summarize)
c
M10
Click to summarize M_GC_PACKET_TIMEOUT

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

(summarize)
c
M10
Click to summarize M_DEFAULT

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

c
M10
Click to summarize Value >= 0

Specifies the maximum time to wait, in msec.

c
M10
Click to summarize M_GC_PIXEL_FORMAT

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

(summarize)
c
M10
v
Click to summarize M_DEFAULT

Same as specified in the DCF.

c
M10
v
Click to summarize Value

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

(summarize)
c
M10
v
Click to summarize M_GC_PIXEL_FORMAT_SWITCHING

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

(summarize)
c
M10
o v
Click to summarize M_DEFAULT

Same as M_ENABLE.

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_STATISTICS_RESET

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

(summarize)
c
M10
o
Click to summarize M_DEFAULT

Implements the default behavior.

c
M10
o
Click to summarize M_GC_STREAM_CHANNEL_MULTICAST_ADDRESS_STRING

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

This control 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). For more information on using a multicast IP address, refer to the Using IP multicast section of the Matrox GigE Vision driver chapter in the MIL Hardware-specific Notes. INQ

(summarize)
c
M10
Click to summarize
M_PTR_TO_DOUBLE(
MIL_CONST_TEXT_PTR String
)

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

(summarize)
c
M10
Parameters

This parameter specifies the string whose address to cast.

c
M10
MIL_TEXT("2nn.n.n.n") 1

Specifies the multicast IP address of the camera, in dotted decimal notation where each dotted decimal value (n) is a number between 0 and 255.

c
M10
Click to summarize M_GC_STREAMING_MODE

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

(summarize)
c
M10
k
M10
o v y
U75
Click to summarize M_DEFAULT

Same as M_AUTOMATIC.

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

Specifies that the image stream is started and stopped automatically.

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

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

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

(summarize)
c
M10
k
M10
o v y
U75
Click to summarize M_GC_STREAMING_START

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

(summarize)
c
M10
k
M10
o v y
U75
Click to summarize M_DEFAULT

Implements the default behavior.

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

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

(summarize)
c
M10
k
M10
o v y
U75
Click to summarize M_DEFAULT

Implements the default behavior.

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

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

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

(summarize)
c
M10
k
M10
o v y
U75
Click to summarize M_DEFAULT

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

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

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

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

(summarize)
c
M10
k
M10
o v y
U75
Click to summarize M_DEFAULT

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

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_UPDATE_MULTICAST_INFO

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

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

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

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

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

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

For more information on multicast IP addresses, refer to the Using IP multicast section of the Matrox GigE Vision driver chapter in the MIL Hardware-specific Notes.

(summarize)
c
M10
Click to summarize M_DEFAULT

Implements the default behavior.

c
M10
Click to summarize M_GC_USER_NAME

Sets the camera's name. INQ

(summarize)
c
M10
o v
Click to summarize
M_PTR_TO_DOUBLE(
MIL_CONST_TEXT_PTR String
)

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

(summarize)
c
M10
o v
Parameters

This parameter specifies the string whose address to cast.

c
M10
o v
MIL_TEXT("CameraName") 1

Specifies the name of the camera. Note that this string can be 16 characters long (including the null-terminating character) and must use the UTF-8 character set.

c
M10
o v
Click to summarize M_GENTL_ANNOUNCE_BUFFER

Sets to announce the specified buffer to the GenTL producer, before starting the acquisition with MdigGrab(). Note that it is not necessary to announce buffers when using MdigGrabContinuous(), or MdigProcess().

(summarize)
v
Click to summarize MIL grab image buffer identifier

Specifies the identifier of a destination image buffer with an M_IMAGE + M_GRAB attribute.

v
Click to summarize M_GENTL_REVOKE_BUFFER

Sets to revoke a previously announced grab image buffer to the GenTL producer. Note that acquisition must be stopped before a buffer can be revoked.

(summarize)
v
Click to summarize MIL grab image buffer identifier

Specifies the identifier of a destination image buffer with an M_IMAGE + M_GRAB attribute.

v
Click to summarize M_GRAB_ABORT

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

(summarize)
a 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, for this control type to function on the Host, you must pass a simulated digitizer (allocated using MdigAlloc() with M_EMULATED).

a
Click to summarize M_DEFAULT

Implements the default behavior.

a 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_DIRECTION_X

Sets the horizontal grab direction. INQ

(summarize)
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_DEFAULT

Same as M_FORWARD.

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_FORWARD

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

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_REVERSE

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

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

Sets the vertical grab direction. INQ

(summarize)
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_DEFAULT

Same as M_FORWARD.

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_FORWARD

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

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_REVERSE

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

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

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

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

(summarize)
g h i l m u
U36
Click to summarize M_DEFAULT

Specifies the default value.

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

(summarize)
g h i l m u
U36
Click to summarize 1

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

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

(summarize)
g h i l m u
U36
Click to summarize 2

Specifies to grab two fields.

g h i l m u
U36
Click to summarize M_GRAB_FRAME_MISSED_COUNTER

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

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

(summarize)
j k
M10
p r
U27
y
U75
aa
Click to summarize M_DEFAULT

Same as M_DISABLE.

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_FRAME_MISSED_RESET

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

(summarize)
j k
M10
p r
U27
y
U75
aa
Click to summarize M_DEFAULT

Implements the default behavior.

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

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

(summarize)
j k
M10
l m p r
U27
y
U75
aa
Click to summarize M_DEFAULT

Same as M_DISABLE.

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

Sets which LUT to use.

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

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

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

(summarize)
a 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, for this control type to function on the Host, you must pass a simulated digitizer (allocated using MdigAlloc() with M_EMULATED).

a
Click to summarize M_DEFAULT

Same as M_SYNCHRONOUS.

a 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. Note that only one MdigGrab() function can be queued at a time. If one MdigGrab() is already queued, subsequent grabs will cause your application to wait until the current grab is finished. This allows the currently queued grab to start.

(summarize)
a 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. Note that more than one MdigGrab() function can be queued. This causes the grabs to be truly asynchronous.

(summarize)