MultiCam Boards Documentation > MultiCam Documentation > MultiCam Reference > Channel Class > Acquisition Control Category > Adjust Level (Acquisition Control) > NextGrabField

NextGrabField

Grablink Full XR Grablink Full Grablink DualBase Grablink Base

Description

Type

Enumerated

Description

Definition of image parity for subsequent acquisition phase

"Set" effect

Sets the parity of the image to be acquired

"Get" effect

Returns the currently selected parity

Classification

Class

Channel

Category

Acquisition Control

Level

Adjust

Identifiers

String

NextGrabField

C, C++

MC_NextGrabField

.NET

MC.NextGrabField

Numerical

1388

This parameter is applicable exclusively with interlaced area-scan cameras used in synchronous scanning mode, i.e. without asynchronous reset.

It declares which field or which pair of fields is to be acquired during the subsequent acquisition phases.

Values applicable to Picolo series

Name

Identifier

Description

FLD

MC_NextGrabField_FLD

The parameter can only take the same value as the GrabField parameter.

UP

MC_NextGrabField_UP

DOWN

MC_NextGrabField_DOWN

FRAME

MC_NextGrabField_FRAME

SAME

MC_NextGrabField_SAME

Reproduces the option set with GrabField.

Note for Picolo Diligent. On compressed channels, the only possible values are SAME, FRAME and UP.

Values applicable to Domino series

Name

Identifier

Description

FLD

MC_NextGrabField_FLD

Captures the next field irrespective of parity, when GrabField is FLD, UP or DOWN.

UP

MC_NextGrabField_UP

Captures the next up field, when GrabField is FLD, UP or DOWN.

DOWN

MC_NextGrabField_DOWN

Captures the next down field, when GrabField is FLD, UP or DOWN.

FRAME

MC_NextGrabField_FRAME

Captures the next full-frame image irrespective of parity, when GrabField is FRAME, UPDW or DWUP.

UPDW

MC_NextGrabField_UPDW

Captures the next full-frame image starting with the up field, when GrabField is FRAME, UPDW or DWUP.

DWUP

MC_NextGrabField_DWUP

Captures the next full-frame image starting with the down field, when GrabField is FRAME, UPDW or DWUP.

SAME

MC_NextGrabField_SAME

Reproduces the option set with GrabField.

KEEP

MC_NextGrabField_KEEP

Captures a field or a frame having the same parity as the one previously acquired.

CHANGE

MC_NextGrabField_CHANGE

Captures a field or a frame having the parity opposite to the one previously acquired. (Not available on Domino D³ series)