MblobGetLabel

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

Get the label value of a blob at a specified position.

Syntax

AIL_INT MblobGetLabel(
    AIL_ID    ResultBlobId,  //in
    AIL_INT   XPos,          //in
    AIL_INT   YPos,          //in
    AIL_INT * LabelVarPtr    //out
)

Description

This function gets the label value of a specified blob. Label values are used, for example, to obtain calculation results for single blobs. Blob label values must have been generated by calling MblobCalculate.

Parameters

ResultBlobId (in, AIL_ID)

Specifies the identifier of the blob analysis result buffer where the labels are stored. Note, this function cannot obtain the label values of blobs that have been deleted from the result buffer with MblobSelect.

XPos (in, AIL_INT)

Specifies the X-coordinate of the blob.

YPos (in, AIL_INT)

Specifies the Y-coordinate of the blob.

LabelVarPtr *(out, AIL_INT)

Specifies the address of the variable in which to write the label value. If there is no blob at the specified location, the blob has been deleted, or if the blob's XPos and YPos lie outside the original identifier image, M_NULL is returned instead of the label value. Also, since MblobGetLabel returns the label value, you can set this parameter to M_NULL.

Return Value

Type: AIL_INT

The returned value is the label value of the specified blob.