MblobGetResult

Retrieves whether each blob is included in calculations and retrieval of results.

Retrieves the indices which indicate the chain to which each chained pixel belongs. Each blob's border chain is identified as index 1. Chains that delimit holes in the blob are identified by subsequent indices. When retrieving the chain index of each chained pixel for all included blobs in the image, you can use M_NUMBER_OF_CHAINED_PIXELS to determine the number of chained pixels in each blob, and therefore determine to which blob each chained pixel belongs. The calculation of this feature can be enabled using MblobControl() with M_CHAINS.

Retrieves the X-coordinate of each chained pixel in the specified blob, for all chains contained within the blob (both the pixels bordering a blob and those delimiting its holes). Chained pixels always form a closed chain. This implies that the starting pixel in the chain is also the closing one. If your blob has regions which are 1 pixel wide, these pixels are chained twice, once in the forward direction and then in the opposite direction. The calculation of this feature can be enabled using MblobControl() with M_CHAINS.

Blobs with holes have multiple chains. To determine the chain to which a pixel's X-coordinate belongs, use M_CHAIN_INDEX.

Results are only available in pixel units.

This result is not affected by the setting of M_RESULT_OUTPUT_UNITS.

Retrieves the Y-coordinate of each chained pixel in the specified blob, for all chains contained within the blob (both the pixels bordering a blob and those delimiting its holes). Chained pixels always form a closed chain. This implies that the starting pixel in the chain is also the closing one. If your blob has regions which are 1 pixel wide, these pixels are chained twice, once in the forward direction and then in the opposite direction. The calculation of this feature can be enabled using MblobControl() with M_CHAINS.

Blobs with holes have multiple chains. To determine the chain to which a pixel's Y-coordinate belongs, use M_CHAIN_INDEX.

Results are only available in pixel units.

This result is not affected by the setting of M_RESULT_OUTPUT_UNITS.

Retrieves the X-coordinate of each point on the convex perimeter of the specified blob. Convex perimeter pixels always form a closed figure. This implies that the starting pixel on the convex perimeter is also the closing one. The calculation of this feature can be enabled using MblobControl() with M_CONVEX_HULL.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into the relative coordinate system, taking into account distortions as best as possible.

Retrieves the packed coordinates (X, Y) of each point on the perimeter of the specified blob. Convex perimeter pixels always form a closed figure. This implies that the starting pixel on the convex perimeter is also the closing one. The calculation of this feature can be enabled using MblobControl() with M_CONVEX_HULL.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into the relative coordinate system, taking into account distortions as best as possible.

Retrieves the Y-coordinate of each point on the convex perimeter of the specified blob. Convex perimeter pixels always form a closed figure. This implies that the starting pixel on the convex perimeter is also the closing one. The calculation of this feature can be enabled using MblobControl() with M_CONVEX_HULL.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into the relative coordinate system, taking into account distortions as best as possible.

Retrieves all the Feret diameters of the specified blob in the image.

This feature is not available if you have previously set M_NUMBER_OF_FERETS to M_INFINITE using MblobControl(). The calculation of this feature can be enabled using MblobControl() with M_FERETS.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves the index value for the specified blob(s) in the image. Note that when blob's are excluded or deleted, the index of blobs with indices greater than that of the excluded/deleted blob are reduced by one. Therefore, if you need to specify a specific blob, you might want to use its blob label instead since it doesn't change.

Retrieves the X-coordinate of the n ^th vertex of the minimum-area bounding box of each blob, where n stands for an integer between 1 and 4. The calculation of this feature can be enabled using MblobControl() with M_MIN_AREA_BOX.

Note that the labeling of the vertices might be inconsistent from one blob to another within the blob identifier image.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into the relative coordinate system, taking into account distortions as best as possible.

Retrieves the Y-coordinate of the n ^th vertex of the minimum-area bounding box of each blob, where n stands for an integer between 1 and 4. The calculation of this feature can be enabled using MblobControl() with M_MIN_AREA_BOX.

Note that the labeling of the vertices might be inconsistent from one blob to another within the blob identifier image.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into the relative coordinate system, taking into account distortions as best as possible.

Retrieves the X-coordinate of the n ^th vertex of the minimum-perimeter bounding box of each blob, where n stands for an integer between 1 and 4. The calculation of this feature can be enabled using MblobControl() with M_MIN_PERIMETER_BOX.

Note that the labeling of the vertices might be inconsistent from one blob to another within the blob identifier image.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into the relative coordinate system, taking into account distortions as best as possible.

Retrieves the Y-coordinate of the n ^th vertex of the minimum-perimeter bounding box of each blob, where n stands for an integer between 1 and 4. The calculation of this feature can be enabled using MblobControl() with M_MIN_PERIMETER_BOX.

Note that the labeling of the vertices might be inconsistent from one blob to another within the blob identifier image.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into the relative coordinate system, taking into account distortions as best as possible.

Retrieves the number of Feret diameters calculated for each blob. The calculation of this feature can be enabled using MblobControl() with M_FERETS.

Retrieves the length of each run in the specified blob(s). A run is defined as a horizontal series of consecutive foreground pixels. When retrieving the length of each run for all included blobs in the image, you can use M_NUMBER_OF_RUNS to determine the number of runs each blob has, and therefore determine to which blob each length corresponds. The calculation of this feature can be enabled using MblobControl() with M_RUNS.

Retrieves the X-coordinate of the start (left-most pixel) of each run in the specified blob(s). The calculation of this feature can be enabled using MblobControl() with M_RUNS.

Retrieves the Y-coordinate of the start (left-most pixel) of each run in the specified blob(s). The calculation of this feature can be enabled using MblobControl() with M_RUNS.

Retrieves the number of foreground pixels in each blob (holes are not counted). This feature is always calculated.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves whether each blob is touching the borders of the image.

Retrieves the area covered by the image-axis-aligned bounding box of each blob.

The image-axis-aligned bounding box is the bounding box that is aligned with the pixel coordinate system's axes.

The calculation of this feature can be enabled using MblobControl() with M_BOX.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves the ratio between the horizontal size and the vertical size of the image-axis-aligned bounding box of each blob.

The image-axis-aligned bounding box is the bounding box that is aligned with the pixel coordinate system's axes.

The calculation of this feature can be enabled using MblobControl() with M_BOX.

Even if you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS, this result is calculated and returned in the pixel coordinate system.

Retrieves the ratio between the area of the blob and the area of the image-axis-aligned bounding box of each blob.

The image-axis-aligned bounding box is the bounding box that is aligned with the pixel coordinate system's axes.

The calculation of this feature can be enabled using MblobControl() with M_BOX.

Even if you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS, this result is calculated and returned in the pixel coordinate system.

Retrieves the extreme right X-coordinate of each blob, of the image-axis-aligned bounding box.

The image-axis-aligned bounding box is the bounding box that is aligned with the pixel coordinate system's axes.

The calculation of this feature can be enabled using MblobControl() with M_BOX.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into the relative coordinate system, taking into account distortions as best as possible.

Retrieves the extreme left X-coordinate of each blob, of the image-axis-aligned bounding box.

The image-axis-aligned bounding box is the bounding box that is aligned with the pixel coordinate system's axes.

The calculation of this feature can be enabled using MblobControl() with M_BOX.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into the relative coordinate system, taking into account distortions as best as possible.

Retrieves the extreme bottom Y-coordinate of each blob, of the image-axis-aligned bounding box.

The image-axis-aligned bounding box is the bounding box that is aligned with the pixel coordinate system's axes.

The calculation of this feature can be enabled using MblobControl() with M_BOX.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into the relative coordinate system, taking into account distortions as best as possible.

Retrieves the extreme top Y-coordinate of each blob, of the image-axis-aligned bounding box.

The image-axis-aligned bounding box is the bounding box that is aligned with the pixel coordinate system's axes.

The calculation of this feature can be enabled using MblobControl() with M_BOX.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into the relative coordinate system, taking into account distortions as best as possible.

Retrieves the breadth of each blob. This feature is only accurate for certain blob types (for example, long thin blobs) because it is derived from the perimeter (P) and area (A) assuming that P = 2(length + breadth) and A = length x breadth. The calculation of this feature can be enabled using MblobControl() with M_BREADTH.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves the compactness of each blob. This is the ratio between the area of a circle with the same perimeter as the blob in question, and the area of the blob itself. The minimum theoretical value of 1.0 is obtained if the blob is a perfect circle. In practice, the minimum obtainable value is slightly above 1. This is due to the effect of square pixel discretization. The more convoluted the shape, the greater the value.

The formula used is equal to where A is the area of the blob and p is the perimeter of the blob.

In the illustration above, the blobs have similar sizes but can be distinguished by their shapes. The compactness of the left blob is slightly above 1.0, while the compactness of the right blob is 1.24. The calculation of this feature can be enabled using MblobControl() with M_COMPACTNESS.

Even if you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS, this result is calculated and returned in the pixel coordinate system.

Retrieves the area of the convex hull of each blob. The calculation of this feature can be enabled using MblobControl() with M_CONVEX_HULL.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves the X-component of the center of gravity of the convex hull of each blob. The calculation of this feature can be enabled using MblobControl() with M_CONVEX_HULL.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves the Y-component of the center of gravity of the convex hull of each blob. The calculation of this feature can be enabled using MblobControl() with M_CONVEX_HULL.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves the ratio between the blob's area and the area of its convex hull.

In the example above, the left blob has a convex hull fill ratio of 1.0, whereas the middle and right-most blobs have a convex hull fill ratio of 0.9. The calculation of this feature can be enabled using MblobControl() with M_CONVEX_HULL.

Retrieves the perimeter of the convex hull of each blob. The perimeter is calculated by summing up the distance between every 2 consecutive points on the convex hull of a blob. The calculation of this feature can be enabled using MblobControl() with M_CONVEX_HULL.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves an approximation of the perimeter of the convex hull of each blob. It is derived from several Feret diameters; so, a larger number of Ferets gives a more accurate result. The calculation of this feature can be enabled using MblobControl() with M_CONVEX_PERIMETER.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves a value that is equal to M_LENGTH / M_BREADTH of each blob. It is similar to M_FERET_ELONGATION, except that it should be used for long thin objects. The calculation of this feature can be enabled using MblobControl() with M_ELONGATION.

Even if you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS, this result is calculated and returned in the pixel coordinate system.

Retrieves the number of blobs minus the number of holes (number of blobs - number of holes). This value is more useful if calculated using the M_WHOLE_IMAGE blob identification mode instead of the M_INDIVIDUAL blob identification mode. Unlike its usual effect, when using the M_WHOLE_IMAGE blob identification mode, each blob is treated individually, as opposed to grouping all of the blobs in an image together. So M_EULER_NUMBER returns (number of blobs - number of holes). Whereas as usual, when using the M_INDIVIDUAL blob identification mode, each blob is treated separately; therefore, the Euler number for each blob is just 1 - the number of holes. The calculation of this feature can be enabled using MblobControl() with M_EULER_NUMBER.

This result is not affected by the setting of M_RESULT_OUTPUT_UNITS.

Retrieves the measure of the shape of each blob. It is equal to M_FERET_MAX_DIAMETER / M_FERET_MIN_DIAMETER. The calculation of this feature can be enabled using MblobControl() with M_FERETS.

It is accurate for reasonably compact objects, but becomes less accurate for very elongated objects (because M_FERET_MIN_DIAMETER becomes less accurate). For very elongated objects, M_ELONGATION should be used.

Even if you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS, this result is calculated and returned in the pixel coordinate system.

Retrieves the Feret diameter at the user-specified angle (set using MblobControl() with M_FERET_GENERAL_ANGLE). The calculation of this feature can be enabled using MblobControl() with M_FERET_GENERAL.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves the angle, in degrees, at which the maximum Feret diameter is found for each blob. The calculation of this feature can be enabled using MblobControl() with M_FERETS.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

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.

Retrieves the largest Feret diameter found after checking a certain number of angles. More angles will give a more accurate result, but will take longer to calculate. With regards to the number of angles evaluated, the maximum Feret diameter is less sensitive than the minimum Feret diameter; generally, evaluating the potential maximum Feret diameter over 8 angles will give an accurate result.

The calculation of this feature can be enabled using MblobControl() with M_FERETS.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves the ratio between the maximum Feret diameter of each blob and its perpendicular Feret diameter. The calculation of this feature can be enabled using MblobControl() with M_FERET_MAX_DIAMETER_ELONGATION.

Even if you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS, this result is calculated and returned in the pixel coordinate system.

Retrieves the average of the Feret diameters at the angles checked for each blob. The calculation of this feature can be enabled using MblobControl() with M_FERETS.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves the angle, in degrees, at which the minimum Feret diameter is found for each blob. The calculation of this feature can be enabled using MblobControl() with M_FERETS.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

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.

Retrieves the minimum Feret diameter found after checking a certain number of angles. More angles will give a more accurate result, but will take longer to calculate. Note that this feature will not be very accurate for long thin blobs. However, you can get an accurate measure of the breadth of long thin blobs more quickly using M_BREADTH.

The calculation of this feature can be enabled using MblobControl() with M_FERETS.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves the ratio between the minimum Feret diameter of each blob and its perpendicular Feret diameter. The calculation of this feature can be enabled using MblobControl() with M_FERET_MIN_DIAMETER_ELONGATION.

Even if you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS, this result is calculated and returned in the pixel coordinate system.

Retrieves the Feret diameter that is perpendicular to the maximum Feret diameter of each blob. The calculation of this feature can be enabled using MblobControl() with M_FERET_PERPENDICULAR_TO_MAX_DIAMETER.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves the Feret diameter that is perpendicular to the minimum Feret diameter of each blob. The calculation of this feature can be enabled using MblobControl() with M_FERET_PERPENDICULAR_TO_MIN_DIAMETER.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves the dimension of the image-axis-aligned minimum bounding box of each blob, along the X-axis of the pixel coordinate system (that is, M_BOX_X_MAX - M_BOX_X_MIN + 1).

The image-axis-aligned bounding box is the bounding box that is aligned with the pixel coordinate system's axes.

The calculation of this feature can be enabled using MblobControl() with M_BOX.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves the dimension of the image-axis-aligned minimum bounding box of each blob, along the Y-axis of the pixel coordinate system (that is, M_BOX_Y_MAX - M_BOX_Y_MIN + 1).

The image-axis-aligned bounding box is the bounding box that is aligned with the pixel coordinate system's axes.

The calculation of this feature can be enabled using MblobControl() with M_BOX.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves the X-coordinate of a unique point (along with M_FIRST_POINT_Y) for each blob, that is on the perimeter of the blob. The X-coordinate is that of the left-most pixel on the top-most line of the blob. The calculation of this feature can be enabled using MblobControl() with M_BOX.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into the relative coordinate system, taking into account distortions as best as possible.

Retrieves the Y-coordinate of a unique point (along with M_FIRST_POINT_X) for each blob, that is on the perimeter of the blob. The Y-coordinate is that of the top-most line of the blob. The calculation of this feature can be enabled using MblobControl() with M_BOX.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into the relative coordinate system, taking into account distortions as best as possible.

Retrieves the label value of each blob. You can retrieve the label value of included or excluded blobs, but not deleted blobs. The label value is a positive integer (>= 1) that is unique for each blob.

Retrieves the length of each blob. This feature is only accurate for certain object types (for example, long thin blobs) because it is derived from the perimeter (P) and area (A) assuming that P = 2(length + breadth) and A = length x breadth. It complements M_FERET_MAX_DIAMETER because it is accurate for different blob types (for example, long thin blobs). Note, it is calculated much faster than the maximum Feret diameter. The calculation of this feature can be enabled using MblobControl() with M_LENGTH.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves the angle of the minimum-area bounding box of each blob. The angle is always measured from the X-axis of the pixel coordinate system, to the side of the box from which the width is measured. The calculation of this feature can be enabled using MblobControl() with M_MIN_AREA_BOX.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves the area of the minimum-area bounding box of each blob. The calculation of this feature can be enabled using MblobControl() with M_MIN_AREA_BOX.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into world units, taking into account distortions as best as possible.

Retrieves the X-coordinate of the center of the minimum-area bounding box of each blob. The calculation of this feature can be enabled using MblobControl() with M_MIN_AREA_BOX.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into the relative coordinate system, taking into account distortions as best as possible.

Retrieves the Y-coordinate of the center of the minimum-area bounding box of each blob. The calculation of this feature can be enabled using MblobControl() with M_MIN_AREA_BOX.

If you requested to retrieve results in world units with M_RESULT_OUTPUT_UNITS and the calculation was performed on appropriate buffers, the results returned are transformed into the relative coordinate system, taking into account distortions as best as possible.