MblobSelect

See also

User Guide:

Adjusting blob analysis processing controls Blob reconstruction Enabling features for calculation Merging results Selecting blobs Steps to performing blob analysis Working with real-world units

Reference:

MblobCalculate MblobControl MblobGetResult

Availability

Not available in MIL-Lite

Available in MIL

Available on Windows

Available on Linux

Not supported on:

Not supported on Matrox Indio (Update 53 or Update 68) (w)

Not supported on Matrox Concord PoE with ToE (Update 82) (z)

Fully supported on:

Fully supported on Host system (a)

Fully supported on Matrox GigE Vision driver (MIL 10, Update 25, Update 54, or Update 85)* (c)

Fully supported on Matrox Morphis (g)

Fully supported on Matrox Morphis QxT (h)

Fully supported on Matrox Orion HD (i)

Fully supported on Matrox Radient eCL (j)

Fully supported on Matrox Radient eV-CXP (MIL 10 or Update 29)* (k)

Fully supported on Matrox Solios eA/XA (l)

Fully supported on Matrox Solios ecl/xcl/ev-cl (m)

Fully supported on Matrox USB3 Vision driver (Update 19) (o)

Fully supported on Matrox RadientPro-CL (Update 7) (p)

Fully supported on Matrox Radient eV-CL (Update 27 or 74) (r)

Fully supported on Matrox Iris GTR (Update 28 or Update 68) (t)

Fully supported on Matrox Clarity UHD (Update 36 or 76) (u)

Fully supported on Matrox GenTL driver (Update 34) (v)

Fully supported on Matrox Rapixo CXP (Update 75 or Update 84) (y)

Fully supported on Matrox Rapixo CL Pro (Update 96) (aa)

* Refer to the MIL system-specific information
in the MIL Reference for the minimum update required.

For any information regarding a MIL system added during a MIL Update, see the MIL system’s release note

Available on Non-Matrox computer

Available on Matrox 4Sight-X

Available on Matrox 4Sight GP/GPm

Available on Matrox Supersight

Function map

Examples

blackfiducialfinder.cpp
blobmerge.cpp
blobtransform.cpp
classprintedchar.cpp
classseafoodinspect.cpp
defectdetectiontask.cpp
fixturingusingblob.cpp
mblob.cpp
mblob.cs
mblob.vb
metrologyonblobs.cpp
multipledatamatrixcoderead.cpp
registeredgoldentemplate.cpp
segmentationandanalysisofcells.cpp
studinspection.cpp
whitefiducialfinder.cpp

Function Map

- Operation

Table:

For specifying the operation to perform

- SelectionCriterion

Table:	For a selection criterion based on a feature that has only a binary definition
Table:	For a selection criterion based on a feature that has only a grayscale definition
Table:	For a selection criterion based on a feature that has two different definitions
+ combination:	For features with a binary and grayscale definition (both have been calculated)
Table:	For a selection criterion based on the current status of blobs

- Condition


Table:	For blob selection using two limits
Table:	For blob selection using only one limit

- CondLow

Table:

For the lower limit of the selected condition

- CondHigh

Table:

For the upper limit of the selected condition

Remarks

Compilation information

Synopsis

Select blobs for calculations and result retrieval.

Syntax

void MblobSelect(

MIL_ID ResultBlobId,	//in
MIL_INT64 Operation,	//in
MIL_INT64 SelectionCriterion,	//in
MIL_INT64 Condition,	//in
MIL_DOUBLE CondLow,	//in
MIL_DOUBLE CondHigh	//in

)

Description

This function selects or merges blobs that meet a specified criterion. These blobs will be included in or excluded from future operations (calculations or result retrieval), or deleted entirely from the result buffer. Selection criterion can be based on a calculated feature or on the current status of the blobs. MblobCalculate() must have been called at least once before calling this function.

If this function is not called at least once, all blobs are included by default. If there is more than one call to this function, the effect of the calls is cumulative unless M_INCLUDE_ONLY or M_EXCLUDE_ONLY is specified as the operation to perform.

If a blob is excluded or deleted, its index is reassigned; that is, the index of blobs with indices greater than that of the excluded/deleted blob are reduced by one. This ensures that included blobs have consecutive indices. Label values of included and excluded blobs, however, are left as is; therefore, it is possible to specify the label value of an excluded blob. You can get a list of valid blob label values by calling MblobGetResult() with M_LABEL_VALUE. Deleted blobs' label values are set to 0.

Once a blob has been excluded, it can normally be re-included only by specifying M_INCLUDE or M_INCLUDE_ONLY in a future call to this function (with the correct criterion). However, if you change the processing mode of a Blob analysis context (using MblobControl()), or use the result buffer with different images, the subsequent call to MblobCalculate() will cause all results in the buffer to be discarded and all blobs will be re-included.

The limits of the blob selection criterion are set using the CondLow and CondHigh parameters. If the blobs were taken from a calibrated image, these parameters can be set in pixel units or world units. To set the units, use MblobControl() with M_INPUT_SELECT_UNITS. Note that if you set this control type to M_WORLD but you don't pass MblobSelect() a result buffer whose results were obtained from a calibrated target image, the function will generate an error.

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 which MIL system’s documentation you should use in its place and any possible differences.

Parameters

This function is not supported on the selected boards.

This function reference has not been updated for the selected MIL system. To show the content of this page, choose a second MIL system; refer to the MIL system's release note to see which MIL system’s documentation to choose and any possible differences.

Parameters

ResultBlobId

Specifies the identifier of the Blob Analysis result buffer to use in the blob selection process.

Operation

Specifies the operation to perform on the specified blobs. This parameter can be set to one of the following.

For specifying the operation to perform
Value	Description
M_DELETE	Deletes blobs that meet the specified condition. M_DELETE affects only included blobs, unless otherwise stated by the SelectionCriterion parameter. M_DELETE removes blobs permanently from the result buffer and, consequently, prevents these blobs from being re-included. (summarize) Deletes blobs that meet the specified condition. (more details...)
M_EXCLUDE	Excludes all blobs that meet the specified condition. M_EXCLUDE affects only the status of currently included blobs. (summarize) Excludes all blobs that meet the specified condition. (more details...)
M_EXCLUDE_ONLY	Excludes only those blobs that meet the specified condition and includes all others. The exclusion does not consider the present status of blobs (whether they are excluded), except for blobs that have been deleted (M_DELETE), unless otherwise stated by the SelectionCriterion parameter. (summarize) Excludes only those blobs that meet the specified condition and includes all others. (more details...)
M_INCLUDE	Includes all blobs that meet the specified condition. M_INCLUDE affects only the status of currently excluded blobs. (summarize) Includes all blobs that meet the specified condition. (more details...)
M_INCLUDE_ONLY	Includes only those blobs that meet the specified condition and excludes all others. The inclusion does not consider the present status of blobs (whether they are included), except for blobs that have been deleted (M_DELETE), unless otherwise stated by the SelectionCriterion parameter. (summarize) Includes only those blobs that meet the specified condition and excludes all others. (more details...)
M_MERGE	Groups all the blobs that meet the specified condition. Once grouped, the blobs are treated as one blob (a grouped blob). The grouped blob is assigned a unique blob label. Only features that were calculated for all the individual blobs in the group are re-calculated for the new grouped blob; calculations are made using the results of the individual blobs in the group. Note that if you add a specified moment to the context (using MblobControl() with M_MOMENT_GENERAL and M_SAVE_RUNS disabled, M_MERGE will not be able to perform the moment calculation. Except when using M_EXCLUDED_BLOBS as the feature for selection, this grouping operation only applies to included blobs. If you are using M_MERGE, you cannot use MblobControl() with M_BLOB_IDENTIFICATION_MODE set to M_LABELED_TOUCHING. (summarize) Groups all the blobs that meet the specified condition. (more details...)

SelectionCriterion

Specifies the feature to use as part of the selection criterion or the status of the blobs to affect. See MblobControl() for a full description of the features. The specified result buffer must already contain the results for the specified feature.

To use as part of the criterion a feature that has only a binary definition, select one of the following.

For a selection criterion based on a feature that has only a binary definition
Value	Description
M_AREA	Uses the number of foreground pixels in a blob (holes are not counted).
M_BLOB_TOUCHING_IMAGE_BORDERS	Uses all blobs that touched the border of the blob identifier image.
M_BOX_AREA	Uses the area covered by the bounding box of a blob.
M_BOX_ASPECT_RATIO	Uses the ratio of the horizontal size to the vertical size of the bounding box of a blob.
M_BOX_FILL_RATIO	Uses the ratio of the area of a blob to the area of the bounding box of the blob.
M_BOX_X_MAX	Uses the extreme right coordinate of the bounding box of a blob.
M_BOX_X_MIN	Uses the extreme left coordinate of the bounding box of a blob.
M_BOX_Y_MAX	Uses the extreme bottom coordinate of the bounding box of a blob.
M_BOX_Y_MIN	Uses the extreme top coordinate of the bounding box of a blob.
M_BREADTH	Uses the breadth of a blob.
M_COMPACTNESS	Uses the compactness feature.
M_CONVEX_HULL_AREA	Uses the area of the convex hull of a blob.
M_CONVEX_HULL_COG_X	Uses the X-component of the center of gravity of a blob.
M_CONVEX_HULL_COG_Y	Uses the Y-component of the center of gravity of a blob.
M_CONVEX_HULL_FILL_RATIO	Uses the ratio of the area of a blob to the area of its convex hull.
M_CONVEX_HULL_PERIMETER	Uses the perimeter of the convex hull of a blob.
M_CONVEX_PERIMETER	Uses the approximation of the perimeter of the convex hull of a blob.
M_ELONGATION	Uses the elongation of a blob.
M_EULER_NUMBER	Uses the number of blobs - number of holes.
M_FERET_ELONGATION	Uses the measure of the shape of a blob. It is equal to M_FERET_MAX_DIAMETER / M_FERET_MIN_DIAMETER. (summarize) Uses the measure of the shape of a blob. (more details...)
M_FERET_GENERAL	Uses the Feret diameter feature.
M_FERET_MAX_ANGLE	Uses the angle at which the maximum Feret diameter is found, in degrees, relative to the input coordinate system specified using MblobControl() with M_INPUT_SELECT_UNITS. An angle interpreted with respect to the pixel coordinate system is always measured counter-clockwise. For information on the angle's direction of rotation when interpreting the angle with respect to the relative coordinate system, see the Angle convention in MIL subsection of the Working with real-world units section of Chapter 26: Calibrating your camera setup. (summarize) Uses the angle at which the maximum Feret diameter is found, in degrees, relative to the input coordinate system specified using MblobControl() with M_INPUT_SELECT_UNITS. (more details...)
M_FERET_MAX_DIAMETER	Uses the largest Feret diameter found after checking a certain number of angles.
M_FERET_MAX_DIAMETER_ELONGATION	Uses the ratio of the maximum Feret diameter by its perpendicular Feret diameter.
M_FERET_MEAN_DIAMETER	Uses the average Feret diameter at all the angles checked.
M_FERET_MIN_ANGLE	Uses the angle at which the minimum Feret diameter is found, in degrees, relative to the input coordinate system specified using MblobControl() with M_INPUT_SELECT_UNITS. An angle interpreted with respect to the pixel coordinate system is always measured counter-clockwise. For information on the angle's direction of rotation when interpreting the angle with respect to the relative coordinate system, see the Angle convention in MIL subsection of the Working with real-world units section of Chapter 26: Calibrating your camera setup. (summarize) Uses the angle at which the minimum Feret diameter is found, in degrees, relative to the input coordinate system specified using MblobControl() with M_INPUT_SELECT_UNITS. (more details...)
M_FERET_MIN_DIAMETER	Uses the smallest Feret diameter found after checking a certain number of angles.
M_FERET_MIN_DIAMETER_ELONGATION	Uses the ratio of the minimum Feret diameter by its perpendicular Feret diameter.
M_FERET_PERPENDICULAR_TO_MAX_DIAMETER	Uses the Feret diameter that is perpendicular to the maximum Feret diameter.
M_FERET_PERPENDICULAR_TO_MIN_DIAMETER	Uses the Feret diameter that is perpendicular to the minimum Feret diameter.
M_FERET_X	Uses the dimension of the minimum bounding box of a blob in the horizontal direction.
M_FERET_Y	Uses the dimension of the minimum bounding box of a blob in the vertical direction.
M_FIRST_POINT_X	Uses the x-coordinate of the top left-most pixel along the perimeter of a blob.
M_FIRST_POINT_Y	Uses the y-coordinate of the top left-most pixel along the perimeter of a blob.
M_INDEX_VALUE	Uses the index value.
M_INTERCEPT_0	Uses the number of times a transition from background to foreground (not vice versa) occurs in the horizontal direction for the entire blob. In other words, it is equal to the number of times the neighborhood configuration [ B, F ] occurs in a blob, where B is a background pixel and F is a foreground pixel. (summarize) Uses the number of times a transition from background to foreground (not vice versa) occurs in the horizontal direction for the entire blob. (more details...)
M_INTERCEPT_45	Determines the number of times that the neighborhood configuration occurs in a blob, where F is a foreground pixel, B is a background pixel, and a dot can be any pixel value. (summarize) Determines the number of times that the neighborhood configuration occurs in a blob, where F is a foreground pixel, B is a background pixel, and a dot can be any pixel value. (more details...)
M_INTERCEPT_90	Determines the number of times that the neighborhood configuration occurs in a blob. (summarize) Determines the number of times that the neighborhood configuration occurs in a blob. (more details...)
M_INTERCEPT_135	Determines the number of times that the neighborhood configuration occurs in a blob. (summarize) Determines the number of times that the neighborhood configuration occurs in a blob. (more details...)
M_LABEL_VALUE	Uses the label feature.
M_LENGTH	Uses the measure of the true length of a blob.
M_MIN_AREA_BOX_ANGLE	Uses the angle of the minimum-area bounding box. An angle interpreted with respect to the pixel coordinate system is always measured counter-clockwise. For information on the angle's direction of rotation when interpreting the angle with respect to the relative coordinate system, see the Angle convention in MIL subsection of the Working with real-world units section of Chapter 26: Calibrating your camera setup. (summarize) Uses the angle of the minimum-area bounding box. (more details...)
M_MIN_AREA_BOX_AREA	Uses the area of the minimum-area bounding box.
M_MIN_AREA_BOX_CENTER_X	Uses the X-coordinate of the center of the minimum-area bounding box.
M_MIN_AREA_BOX_CENTER_Y	Uses the Y-coordinate of the center of the minimum-area bounding box.
M_MIN_AREA_BOX_HEIGHT	Uses the height of the minimum-area bounding box.
M_MIN_AREA_BOX_PERIMETER	Uses the perimeter of the minimum-area bounding box.
M_MIN_AREA_BOX_WIDTH	Uses the width of the minimum-area bounding box.
M_MIN_PERIMETER_BOX_ANGLE	Uses the angle of the minimum-perimeter bounding box. An angle interpreted with respect to the pixel coordinate system is always measured counter-clockwise. For information on the angle's direction of rotation when interpreting the angle with respect to the relative coordinate system, see the Angle convention in MIL subsection of the Working with real-world units section of Chapter 26: Calibrating your camera setup. (summarize) Uses the angle of the minimum-perimeter bounding box. (more details...)
M_MIN_PERIMETER_BOX_AREA	Uses the area of the minimum-perimeter bounding box.
M_MIN_PERIMETER_BOX_CENTER_X	Uses the X-coordinate of the center of the minimum-perimeter bounding box.
M_MIN_PERIMETER_BOX_CENTER_Y	Uses the Y-coordinate of the center of the minimum-perimeter bounding box.
M_MIN_PERIMETER_BOX_HEIGHT	Uses the height of the minimum-perimeter bounding box.
M_MIN_PERIMETER_BOX_PERIMETER	Uses the perimeter of the minimum-perimeter bounding box.
M_MIN_PERIMETER_BOX_WIDTH	Uses the width of the minimum-perimeter bounding box.
M_MOMENT_GENERAL	Uses the moment calculation.
M_NUMBER_OF_CHAINED_PIXELS	Uses the number of chained pixels in a blob.
M_NUMBER_OF_HOLES	Uses the number of holes in a blob.
M_NUMBER_OF_RUNS	Uses the total number of runs in a blob.
M_PERIMETER	Uses the total length of edges in a blob (including the edges of any holes), with an allowance made for the staircase effect that is produced when diagonal edges are digitized.
M_RECTANGULARITY	Uses the degree to which a blob is similar to a rectangle. To do this, MblobSelect() calculates the ratio of the blob's area to the product of its minimum Feret diameter and the Feret diameter perpendicular to the minimum Feret diameter. (summarize) Uses the degree to which a blob is similar to a rectangle. (more details...)
M_ROUGHNESS	Uses the roughness feature.
M_WORLD_BOX_X_MAX	Uses the extreme right X-coordinate of a blob, calculated in the relative coordinate system.
M_WORLD_BOX_X_MIN	Uses the extreme left X-coordinate of a blob, calculated in the relative coordinate system.
M_WORLD_BOX_Y_MAX	Uses the extreme bottom Y-coordinate of a blob, calculated in the relative coordinate system.
M_WORLD_BOX_Y_MIN	Uses the extreme top Y-coordinate of a blob, calculated in the relative coordinate system.
M_WORLD_FERET_X	Uses the dimension of the minimum bounding box of a blob in the horizontal direction, calculated in the relative coordinate system (that is, M_WORLD_BOX_X_MAX - M_WORLD_BOX_X_MIN + 1).
M_WORLD_FERET_Y	Uses the dimension of the minimum bounding box of a blob in the vertical direction, calculated in the relative coordinate system (that is, M_WORLD_BOX_Y_MAX - M_WORLD_BOX_Y_MIN + 1).
M_WORLD_X_AT_Y_MAX	Uses the X-coordinate at the maximum Y-coordinate of a blob, calculated in the relative coordinate system.
M_WORLD_X_AT_Y_MIN	Uses the X-coordinate at the minimum Y-coordinate of a blob, calculated in the relative coordinate system.
M_WORLD_Y_AT_X_MAX	Uses the Y-coordinate at the maximum X-coordinate of a blob, calculated in the relative coordinate system.
M_WORLD_Y_AT_X_MIN	Uses the Y-coordinate at the minimum X-coordinate of a blob, calculated in the relative coordinate system.
M_X_MAX_AT_Y_MAX	Uses the maximum X-coordinate at the maximum Y-coordinate of the blob, calculated in the pixel coordinate system.
M_X_MAX_AT_Y_MIN	Uses the maximum X-coordinate at the minimum Y-coordinate of the blob, calculated in the pixel coordinate system.
M_X_MIN_AT_Y_MAX	Uses the minimum X-coordinate at the maximum Y-coordinate of the blob, calculated in the pixel coordinate system.
M_X_MIN_AT_Y_MIN	Uses the minimum X-coordinate at the minimum Y-coordinate of the blob, calculated in the pixel coordinate system.
M_Y_MAX_AT_X_MAX	Uses the maximum Y-coordinate at the maximum X-coordinate of the blob, calculated in the pixel coordinate system.
M_Y_MAX_AT_X_MIN	Uses the maximum Y-coordinate at the minimum X-coordinate of the blob, calculated in the pixel coordinate system.
M_Y_MIN_AT_X_MAX	Uses the minimum Y-coordinate at the maximum X-coordinate of the blob, calculated in the pixel coordinate system.
M_Y_MIN_AT_X_MIN	Uses the minimum Y-coordinate at the minimum X-coordinate of the blob, calculated in the pixel coordinate system.

To use as part of the criterion a feature that has only a grayscale definition, select one of the following. You can specify one of these features as part of your selection criterion only if both a blob identifier image and a grayscale image were passed to MblobCalculate() (and the features were selected for calculation).

For a selection criterion based on a feature that has only a grayscale definition
Value	Description
M_BLOB_CONTRAST	Uses the difference between the maximum and minimum pixel values of a blob.
M_MAX_PIXEL	Uses the maximum pixel value in a blob.
M_MEAN_PIXEL	Uses the mean pixel value in a blob.
M_MIN_PIXEL	Uses the minimum pixel value in a blob.
M_SIGMA_PIXEL	Uses the standard deviation of pixel values in a blob.
M_SUM_PIXEL	Uses the sum of all pixel values in a blob.
M_SUM_PIXEL_SQUARED	Uses the sum of the squares of the pixel values in a blob.

To use as part of the criterion a feature that has two different definitions (a binary and a grayscale definition), select one of the following.

If you did not provide both a blob identifier image and a grayscale image to MblobCalculate(), only the binary version was calculated. If you did provide a grayscale image, both versions were calculated, unless otherwise specified. In the latter case, see combination values below to specify which to use as part of the criterion. If both versions were calculated and no version is specified, then the grayscale version of the feature is selected as the criterion.

For a selection criterion based on a feature that has two different definitions
Value	Description
M_AXIS_PRINCIPAL_ANGLE +	Uses the feature specifying the angle, in degrees, at which a blob has the least moment of inertia, relative to the input coordinate system specified using MblobControl() with M_INPUT_SELECT_UNITS. An angle interpreted with respect to the pixel coordinate system is always measured counter-clockwise. For information on the angle's direction of rotation when interpreting the angle with respect to the relative coordinate system, see the Angle convention in MIL subsection of the Working with real-world units section of Chapter 26: Calibrating your camera setup. (summarize) Uses the feature specifying the angle, in degrees, at which a blob has the least moment of inertia, relative to the input coordinate system specified using MblobControl() with M_INPUT_SELECT_UNITS. (more details...)
M_AXIS_SECONDARY_ANGLE +	Uses the feature specifying the angle, in degrees, perpendicular to M_AXIS_PRINCIPAL_ANGLE, relative to the input coordinate system specified using MblobControl() with M_INPUT_SELECT_UNITS. An angle interpreted with respect to the pixel coordinate system is always measured counter-clockwise. For information on the angle's direction of rotation when interpreting the angle with respect to the relative coordinate system, see the Angle convention in MIL subsection of the Working with real-world units section of Chapter 26: Calibrating your camera setup. (summarize) Uses the feature specifying the angle, in degrees, perpendicular to M_AXIS_PRINCIPAL_ANGLE, relative to the input coordinate system specified using MblobControl() with M_INPUT_SELECT_UNITS. (more details...)
M_CENTER_OF_GRAVITY_X +	Uses the feature specifying the X-position of the center of gravity of a blob.
M_CENTER_OF_GRAVITY_Y +	Uses the feature specifying the Y-position of the center of gravity of a blob.
M_FERET_AT_PRINCIPAL_AXIS_ANGLE +	Uses the Feret diameter at the principal axis of a blob. The principal axis is the axis at which the blob has the least moment of inertia. Also, if the blob is symmetrical, the principal axis is aligned with the blob's axis of symmetry. (summarize) Uses the Feret diameter at the principal axis of a blob. (more details...)
M_FERET_AT_SECONDARY_AXIS_ANGLE +	Uses the Feret diameter at the secondary axis of a blob. The secondary axis is perpendicular to the principal axis. (summarize) Uses the Feret diameter at the secondary axis of a blob. (more details...)
M_FERET_PRINCIPAL_AXIS_ELONGATION +	Uses the ratio of the Feret diameter at the principal axis to the Feret diameter at the secondary axis.
M_MOMENT_CENTRAL_X0_Y2 +	Uses the feature specifying the central moment of a blob, where the order of X equals 0 and the order of Y equals 2.
M_MOMENT_CENTRAL_X1_Y1 +	Uses the feature specifying the central moment of a blob, where the order of X equals 1 and the order of Y equals 1.
M_MOMENT_CENTRAL_X2_Y0 +	Uses the feature specifying the central moment of a blob, where the order of X equals 2 and the order of Y equals 0.
M_MOMENT_X0_Y1 +	Uses the feature specifying the ordinary moment of a blob, where the order of X equals 0 and the order of Y equals 1.
M_MOMENT_X0_Y2 +	Uses the feature specifying the ordinary moment of a blob, where the order of X equals 0 and the order of Y equals 2.
M_MOMENT_X1_Y0 +	Uses the feature specifying the ordinary moment of a blob, where the order of X equals 1 and the order of Y equals 0.
M_MOMENT_X1_Y1 +	Uses the feature specifying the ordinary moment of a blob, where the order of X equals 1 and the order of Y equals 1.
M_MOMENT_X2_Y0 +	Uses the feature specifying the ordinary moment of a blob, where the order of X equals 2 and the order of Y equals 0.

Combination values for the values listed in For a selection criterion based on a feature that has two different definitions.

You can add one of the following values to the above-mentioned values to set whether to use the binary or grayscale version of the selected feature.

Note that the selected feature must have both a binary definition and a grayscale definition, and both versions must have been calculated.

For features with a binary and grayscale definition (both have been calculated)
Combination value	Description
M_BINARY	Uses the binary version of the selected feature.
M_GRAYSCALE	Uses the grayscale version of the selected feature. This is the default value. (summarize) Uses the grayscale version of the selected feature. (more details...)

To use as part of the selection criterion the current status of the blobs, set the SelectionCriterion parameter to one of the following values. For example, you can delete all currently excluded blobs from the list of blobs on which to operate.

When the selection criterion is based on the current status of blobs, you must set the Condition, CondLow, and CondHigh parameters to M_NULL.

For a selection criterion based on the current status of blobs
Value	Description
M_ALL_BLOBS	Uses all blobs.
M_EXCLUDED_BLOBS	Uses all excluded blobs.
M_INCLUDED_BLOBS	Uses all included blobs.

Condition

Specifies the condition for the blob selection. This parameter must be set to one of the values below.

When the selection criterion is based on the current status of blobs or M_BLOB_TOUCHING_IMAGE_BORDERS, set the Condition parameter to M_NULL.

When the selection criterion is based on a feature (except M_BLOB_TOUCHING_IMAGE_BORDERS), you can specify one of the following conditions that use two limits (CondLow and CondHigh).

For blob selection using two limits
Value	Description
M_IN_RANGE	Specifies that blobs with values for the specified feature in the range CondLow to CondHigh, inclusive, are included, excluded, or deleted from future operations on the specified result buffer.
M_OUT_RANGE	Specifies that blobs with values for the specified feature less than CondLow, or greater than CondHigh, are included, excluded, or deleted from future operations on the specified result buffer.

When the selection criterion is based on a feature (except M_BLOB_TOUCHING_IMAGE_BORDERS), you can specify one of the following conditions that use only one limit (CondLow).

For blob selection using only one limit
Value	Description
M_EQUAL	Specifies that blobs with values for the specified feature equal to CondLow are included, excluded, or deleted from future operations on the specified result buffer.
M_GREATER	Specifies that blobs with values for the specified feature greater than CondLow are included, excluded, or deleted from future operations on the specified result buffer.
M_GREATER_OR_EQUAL	Specifies that blobs with values for the specified feature greater than or equal to CondLow are included, excluded, or deleted from future operations on the specified result buffer.
M_LESS	Specifies that blobs with values for the specified feature less than CondLow are included, excluded, or deleted from future operations on the specified result buffer.
M_LESS_OR_EQUAL	Specifies that blobs with values for the specified feature less than or equal to CondLow are included, excluded, or deleted from future operations on the specified result buffer.
M_NOT_EQUAL	Specifies that blobs with values for the specified feature not equal to CondLow are included, excluded, or deleted from future operations on the specified result buffer.

CondLow

Specifies the lower limit of the selected condition.

For the lower limit of the selected condition
Value	Description
M_NULL	Specifies that this parameter is not applicable. Specify this value when and only when the selection criterion is based on the status of blobs or M_BLOB_TOUCHING_IMAGE_BORDERS. (summarize) Specifies that this parameter is not applicable. (more details...)
Value	Specifies the lower limit of the condition, relative to the input coordinate system specified using MblobControl() with M_INPUT_SELECT_UNITS.

CondHigh

Specifies the upper limit of the selected condition.

For the upper limit of the selected condition
Value	Description
M_NULL	Specifies that this parameter is not applicable. Specify this value when: the condition uses only one limit, the selection criterion is based on the status of blobs, or the selection criterion is based on M_BLOB_TOUCHING_IMAGE_BORDERS. (summarize) Specifies that this parameter is not applicable. (more details...)
Value	Specifies the upper limit of the condition, relative to the input coordinate system specified using MblobControl() with M_INPUT_SELECT_UNITS.

Remark

The prototypes of functions in the Mblob module changed as of MIL 10 PP2. For C applications, by default the original prototypes are used to ensure backward-compatibility. To use the updated prototypes, add #define M_USE_OLD_MBLOB_API_IN_C 0 before including mil.h. For information about the original API for the Mblob module refer to the MIL 10 PP1 documentation, available online to registered users at https://www.matrox.com/imaging/en/products/software/mil/documentation/.

Compilation information

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