MbeadVerify

Board	Supported
Host System	Yes
V4L2	Yes
Clarity UHD	Yes
Concord PoE	No
GenTL	Yes
GevIQ	Yes
GigE Vision	Yes
Indio	No
Iris GTX	Yes
Radient eV-CL	Yes
Rapixo CL	Yes
Rapixo CoF	Yes
Rapixo CXP	Yes
USB3 Vision	Yes

Verify beads in the target image according to their corresponding template.

Syntax

void MbeadVerify(
    AIL_ID    ContextBeadId,     //in
    AIL_ID    TargetImageBufId,  //in
    AIL_ID    ResultBeadId,      //out
    AIL_INT64 ControlFlag        //in
)

Description

This function verifies that beads in the target image conform to their corresponding templates in the context. Results of the measured bead are written in the provided result buffer and can be read using MbeadGetResult. To retrieve whether a measured bead has passed or failed the specifications of its template, use the M_STATUS result. To draw results, use MbeadDraw.

Before your first call to MbeadVerify, you must train the context using MbeadTrain. Certain modifications to the bead context, such as adding, deleting, or modifying templates with MbeadTemplate, or changing some control settings with MbeadControl, require you to retrain the context before any subsequent call to MbeadVerify. To inquire the training status of the templates in the context, use MbeadInquire with M_STATUS.

If you have associated the target image with a camera calibration context, you can specify that certain input settings be interpreted in world units. To do so, use MbeadControl with M_TEMPLATE_INPUT_UNITS set to M_WORLD. Note that if you set this constant to M_WORLD but you don't pass MbeadVerify a calibrated target image, the function will generate an error.

If you are specifying pixel units, make sure the pixel sizes are consistent across all camera calibrations (for example, pixel sizes should be the same in the training and verification images). When using different camera calibration contexts, it is recommended that you use world units.

Parameters

ContextBeadId (in, AIL_ID)

Specifies the identifier of the bead context that contains the templates with which to validate the beads in the target image. The bead context must have been previously allocated on the required system using MbeadAlloc.

TargetImageBufId (in, AIL_ID)

Specifies the identifier of the target image buffer that contains the beads that must be verified, according the templates contained within the bead context. The image buffer must be a 1-band 8-bit unsigned buffer.

ResultBeadId (out, AIL_ID)

Specifies the identifier of the bead result buffer in which to write the results of the verification. The bead result buffer must have been previously allocated on the required system using MbeadAllocResult.

ControlFlag (in, AIL_INT64)

Reserved for future expansion and must be set to M_DEFAULT.