Synopsis
Get the label value of a blob at a specified position.
Format
long MblobGetLabel(BlobResId, XPos, YPos, LabelVarPtr)
| MIL_ID BlobResId; | Blob analysis result buffer identifier |
| long XPos; | X coordinate of the blob |
| long YPos; | Y coordinate of the blob |
| long *LabelVarPtr; | Storage location for the label value |
Description
This function gets the label value of a specified blob. Label values are used, for example, to obtain calculation results for single blobs (MblobGetResultSingle). Blob label values must have been generated by calling MblobCalculate.
The BlobResId parameter 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.
The XPos and YPos parameters specify the coordinates of the blob.
The LabelVarPtr parameter specifies the address of the variable in which the label value is to be written. Since MblobGetLabel also returns the label value, you can set this parameter to M_NULL.
Returned value
The returned value is the label value of the specified blob. If there is no blob at the specified location, M_NULL is returned as the identifier.
See also