| MIL 10 Reference
| Customize Help
| Save Settings

MblobGetLabel



See also
Availability
Not available in MIL-Lite
Available in MIL

Available on Windows
Available on Linux

Available on Non-Matrox computer
Available on Matrox 4Sight-X
Available on Matrox 4Sight GP
Available on Matrox Supersight
function map Function map
Examples
None.
Synopsis
Get the label value of a blob at a specified position.
Syntax
MIL_INT MblobGetLabel(
MIL_ID BlobResId, //in
MIL_INT XPos, //in
MIL_INT YPos, //in
MIL_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 (MblobGetResultSingle()). Blob label values must have been generated by calling MblobCalculate().

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 if there is complementary information.
Parameters
This function is not supported on the selected boards.
Parameters
BlobResId

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

Specifies the X-coordinate of the blob.

YPos

Specifies the Y-coordinate of the blob.

LabelVarPtr

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
The returned value is the label value of the specified blob.
Compilation information
Header Include mil.h.
Library Use mil.lib; milblob.lib.
DLL Requires mil.dll; milblob.dll.