MblobLabel

The label values are taken from the blob analysis result buffer. A call to MblobCalculate() must have been made to generate label values for an image. Blobs that have been deleted from the result buffer are not drawn.

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.

DestImageBufId

Specifies the identifier of the destination (labeled) image buffer. This must be a single band, 8 or 16-bit unsigned buffer.

Note, this buffer need not be the same size as the original identifier image used to calculate the blobs, but must be 16 bits deep if the maximum label value exceeds 255. To determine if a 16-bit buffer is necessary, perform an M_MAX_LABEL inquiry, using MblobInquire(). The number of blobs alone does not tell you the maximum label value (label values are not necessarily contiguous).

This image buffer must not have a region of interest (ROI) associated with it. Using an image buffer with an ROI will cause an error.

Mode

Specifies whether or not to clear the destination image buffer before drawing the labeled image into it. This parameter can be set to one of the following:

For the destination image buffer
Value	Description
M_CLEAR	Clears the destination image buffer before placing the labeled image into it.
M_NO_CLEAR	Does not clear the destination image buffer before placing the labeled image into it (background pixels will be unchanged).

Compilation information

Header	Include mil.h.
Library	Use mil.lib; milblob.lib.
DLL	Requires mil.dll; milblob.dll.