Filters
Filter values by
Object Type
  • Blob context settings
    • General Blob context settings
    • Binary features
    • Grayscale features
  • Blob result buffer settings
Type of blob feature to inquire
  • Area and perimeter features
  • Dimension features
  • Shape features
  • Location and bounding box features
  • Moment features
  • Run features
  • Statistic features
| Customize Help
| Save Settings

MblobInquire



Function Map
Synopsis
Inquire about a Blob Analysis setting.
Syntax
MIL_INT MblobInquire(
MIL_ID ContextOrResultBlobId, //in
MIL_INT64 InquireType, //in
void *UserVarPtr //out
)
Description

This function inquires about a specified setting associated with a Blob Analysis context or result buffer.

You can use MblobControl() to change a setting associated with a context or a result buffer.

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
ContextOrResultBlobId

Specifies the identifier of a Blob Analysis context or result buffer.

InquireType

Specifies the type of setting about which to inquire.

See the Parameter associations section for possible values that can be specified.

UserVarPtr
Accepts the address of one of the following (see the Parameter associations section for specifics on which is expected):
  • MIL_DOUBLE
  • MIL_ID
  • MIL_INT
  • MIL_INT32
  • MIL_INT64

Specifies the address in which to write the requested information. Since the MblobInquire() function also returns the requested information, you can set this parameter to M_NULL.

See the Parameter associations section for possible values that can be returned.

For the following inquire type, the ContextOrResultBlobId parameter can specify a Blob Analysis result buffer or context.

function map For inquiring the system on which the result buffer or context is allocated
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_OWNER_SYSTEM +

Inquires the identifier of the system on which the blob result buffer or context is allocated. SET SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT_HOST

Specifies the default Host system of the current MIL application.

Click to summarize MIL system identifier

Specifies a valid system identifier, previously allocated using MsysAlloc().

For the following inquire types, the ContextOrResultBlobId parameter can specify a Blob Analysis context.

function map For inquiring about the global processing settings of a Blob Analysis context that cause results to be recalculated
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_BLOB_IDENTIFICATION_MODE +

Inquires the blob identification mode that was selected. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_INDIVIDUAL. INFO

Click to summarize M_INDIVIDUAL

Specifies that all blobs are measured individually. INFO

Click to summarize M_LABELED

Specifies that blobs with the same label are grouped together, and that touching blobs with different labels are also grouped together. INFO

Click to summarize M_LABELED_TOUCHING

Specifies that blobs with the same label are grouped together, and that touching blobs with different labels are measured individually. INFO

Click to summarize M_WHOLE_IMAGE

Specifies that all blobs are grouped together. INFO

Click to summarize M_CONNECTIVITY +

Inquires the image lattice. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_8_CONNECTED.

Click to summarize M_4_CONNECTED

Specifies that each pixel has 4 neighbors.

Click to summarize M_8_CONNECTED

Specifies that each pixel has 8 neighbors.

Click to summarize M_FERET_ANGLE_SEARCH_END +

Inquires the upper limit of the angular search range used in the calculation of the minimum or maximum Feret diameter. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
Click to summarize M_DEFAULT

Specifies the default value; the default value is 180.

Click to summarize 0 <= Value <= 180

Specifies the upper limit of the angular search range. INFO

Click to summarize M_FERET_ANGLE_SEARCH_START +

Inquires the lower limit of the angular search range used in the calculation of the minimum or maximum Feret diameter. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
Click to summarize M_DEFAULT

Specifies the default value; the default value is 0.

Click to summarize 0 <= Value <= 180

Specifies the lower limit of the angular search range. INFO

Click to summarize M_FOREGROUND_VALUE +

Inquires the pixel values that are considered to be in the foreground. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_NONZERO.

Click to summarize M_NONZERO

Specifies the blobs consisting of non-zero pixels.

Click to summarize M_ZERO

Specifies the blobs consisting of zero pixels.

Click to summarize M_NUMBER_OF_FERETS +

Inquires the number of Feret angles set to calculate a Feret feature. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_INFINITE

Specifies the use of a high precision algorithm to accurately calculate Feret features (and features based on Feret features). INFO

Click to summarize M_MIN_FERETS

Specifies the minimum number of Feret angles. INFO

Click to summarize Value > M_MIN_FERETS

Specifies the number of Feret angles. INFO

For the following inquire types, the ContextOrResultBlobId parameter must specify a Blob Analysis context.

function map For inquiring about a global processing settings of a Blob Analysis context that do not cause results to be recalculated
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_FERET_CONTACT_POINTS +

Inquires whether Feret contact points will be calculated. If enabled, the M_FERET_CONTACT_POINTS_... combination constants are available in MblobGetResult(). SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that the Feret contact points for supported features will not be calculated.

Click to summarize M_ENABLE

Specifies that the Feret contact points for supported features will be calculated.

Click to summarize M_FERET_GENERAL_ANGLE +

Inquires the angle to use when calculating the user-specified Feret. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
Click to summarize M_DEFAULT

Specifies the default value; the default value is 0.0.

Click to summarize -360.0 <= Value <= 360.0

Specifies the angle, in degrees.

Click to summarize M_IDENTIFIER_TYPE +

Inquires the values that the non-zero pixels in the image have. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_GRAYSCALE.

Click to summarize M_BINARY

Specifies that non-zero pixels must have the maximum value of the buffer (for example, 0xff for an 8-bit image).

Click to summarize M_GRAYSCALE

Specifies that non-zero pixels can have any value.

Click to summarize M_MAX_BLOBS +

Inquires the maximum number of blobs to process. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that there is no limit on the maximum number of blobs.

Click to summarize Value >= 0

Specifies the maximum number of blobs.

Click to summarize M_MOMENT_GENERAL_MODE +

Inquires the type of moment that will be calculated when calculating a user-specified moment. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_ORDINARY.

Click to summarize M_CENTRAL

Specifies a central moment. INFO

Click to summarize M_ORDINARY

Specifies an ordinary moment. INFO

Click to summarize M_MOMENT_GENERAL_ORDER_X +

Inquires the order of the X-component of the specified general moment. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
Click to summarize M_DEFAULT

Specifies the default value; the default value is 0.

Click to summarize Value >= 0

Specifies the X-order of the moment.

Click to summarize M_MOMENT_GENERAL_ORDER_Y +

Inquires the order of the Y-component of the specified general moment. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
Click to summarize M_DEFAULT

Specifies the default value; the default value is 0.

Click to summarize Value >= 0

Specifies the Y-order of the moment.

Click to summarize M_PIXEL_ASPECT_RATIO +

Inquires the pixel aspect ratio that you set for the image(s). SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
Click to summarize M_DEFAULT

Specifies the default value; the default value is 1.0.

Click to summarize Value > 0

Specifies the pixel width/pixel height.

Click to summarize M_RETURN_PARTIAL_RESULTS +

Inquires whether results from partially scanned images will be available after a stop condition is met. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies to discard results of partially scanned images when processing is interrupted.

Click to summarize M_ENABLE

Specifies to make results of partially scanned images available when processing is interrupted.

Click to summarize M_SAVE_RUNS +

Inquires whether the run information will be saved when calling MblobCalculate(). SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_ENABLE.

Click to summarize M_DISABLE

Specifies not to save run information. INFO

Click to summarize M_ENABLE

Specifies to save run information. INFO

Click to summarize M_SORTn +

Inquires the feature used as the n th sorting key, where n stands for an integer between 1 and 3. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_AREA

Specifies that the following is used as the sorting key; the number of foreground pixels in each blob (holes are not counted). INFO

Click to summarize M_AXIS_PRINCIPAL_ANGLE +

Specifies that the following is used as the sorting key; the angle, in degrees, at which each blob has the least moment of inertia. INFO

(summarize)
Click to summarize M_AXIS_SECONDARY_ANGLE +

Specifies that the following is used as the sorting key; the angle perpendicular to M_AXIS_PRINCIPAL_ANGLE of each blob, in degrees. INFO

(summarize)
Click to summarize M_BLOB_CONTRAST

Specifies that the following is used as the sorting key; the difference between the maximum and minimum pixel values of a blob. INFO

Click to summarize M_BLOB_TOUCHING_IMAGE_BORDERS

Specifies that the following is used as the sorting key; whether each blob is touching the borders of the image.

Click to summarize M_BOX_AREA

Specifies that the following is used as the sorting key; the area covered by the image-axis-aligned bounding box of each blob. INFO

Click to summarize M_BOX_ASPECT_RATIO

Specifies that the following is used as the sorting key; the ratio between the horizontal size and the vertical size of the image-axis-aligned bounding box of each blob. INFO

Click to summarize M_BOX_FILL_RATIO

Specifies that the following is used as the sorting key; the ratio between the area of the blob and the area of the image-axis-aligned bounding box of each blob. INFO

Click to summarize M_BOX_X_MAX

Specifies that the following is used as the sorting key; the extreme right X-coordinate of each blob, of the image-axis-aligned bounding box. INFO

Click to summarize M_BOX_X_MIN

Specifies that the following is used as the sorting key; the extreme left X-coordinate of each blob, of the image-axis-aligned bounding box. INFO

Click to summarize M_BOX_Y_MAX

Specifies that the following is used as the sorting key; the extreme bottom Y-coordinate of each blob, of the image-axis-aligned bounding box. INFO

Click to summarize M_BOX_Y_MIN

Specifies that the following is used as the sorting key; the extreme top Y-coordinate of each blob, of the image-axis-aligned bounding box. INFO

Click to summarize M_BREADTH

Specifies that the following is used as the sorting key; the breadth of each blob. INFO

Click to summarize M_CENTER_OF_GRAVITY_X +

Specifies that the following is used as the sorting key; the X-position of the center of gravity of each blob. INFO

(summarize)
Click to summarize M_CENTER_OF_GRAVITY_Y +

Specifies that the following is used as the sorting key; the Y-position of the center of gravity of each blob. INFO

(summarize)
Click to summarize M_COMPACTNESS

Specifies that the following is used as the sorting key; the compactness of each blob. INFO

Click to summarize M_CONVEX_HULL_AREA

Specifies that the following is used as the sorting key; the area of the convex hull of each blob. INFO

Click to summarize M_CONVEX_HULL_COG_X

Specifies that the following is used as the sorting key; the X-component of the center of gravity of the convex hull of each blob. INFO

Click to summarize M_CONVEX_HULL_COG_Y

Specifies that the following is used as the sorting key; the Y-component of the center of gravity of the convex hull of each blob. INFO

Click to summarize M_CONVEX_HULL_FILL_RATIO

Specifies that the following is used as the sorting key; the ratio between the blob's area and the area of its convex hull. INFO

Click to summarize M_CONVEX_HULL_PERIMETER

Specifies that the following is used as the sorting key; the perimeter of the convex hull of each blob. INFO

Click to summarize M_CONVEX_PERIMETER

Specifies that the following is used as the sorting key; an approximation of the perimeter of the convex hull of each blob. INFO

Click to summarize M_ELONGATION

Specifies that the following is used as the sorting key; a value that is equal to M_LENGTH / M_BREADTH of each blob. INFO

Click to summarize M_EULER_NUMBER

Specifies that the following is used as the sorting key; the number of blobs minus the number of holes (number of blobs - number of holes). INFO

Click to summarize M_FERET_AT_PRINCIPAL_AXIS_ANGLE +

Specifies that the following is used as the sorting key; the Feret diameter at the principal axis of each blob. INFO

(summarize)
Click to summarize M_FERET_AT_SECONDARY_AXIS_ANGLE +

Specifies that the following is used as the sorting key; the Feret diameter at the secondary axis of each blob. INFO

(summarize)
Click to summarize M_FERET_ELONGATION

Specifies that the following is used as the sorting key; the measure of the shape of each blob. INFO

Click to summarize M_FERET_GENERAL

Specifies that the following is used as the sorting key; the Feret diameter at the user-specified angle (set using MblobControl() with M_FERET_GENERAL_ANGLE). INFO

Click to summarize M_FERET_MAX_ANGLE

Specifies that the following is used as the sorting key; the angle, in degrees, at which the maximum Feret diameter is found for each blob. INFO

Click to summarize M_FERET_MAX_DIAMETER

Specifies that the following is used as the sorting key; the largest Feret diameter found after checking a certain number of angles. INFO

Click to summarize M_FERET_MAX_DIAMETER_ELONGATION

Specifies that the following is used as the sorting key; the ratio between the maximum Feret diameter of each blob and its perpendicular Feret diameter. INFO

Click to summarize M_FERET_MEAN_DIAMETER

Specifies that the following is used as the sorting key; the average of the Feret diameters at the angles checked for each blob. INFO

Click to summarize M_FERET_MIN_ANGLE

Specifies that the following is used as the sorting key; the angle, in degrees, at which the minimum Feret diameter is found for each blob. INFO

Click to summarize M_FERET_MIN_DIAMETER

Specifies that the following is used as the sorting key; the minimum Feret diameter found after checking a certain number of angles. INFO

Click to summarize M_FERET_MIN_DIAMETER_ELONGATION

Specifies that the following is used as the sorting key; the ratio between the minimum Feret diameter of each blob and its perpendicular Feret diameter. INFO

Click to summarize M_FERET_PERPENDICULAR_TO_MAX_DIAMETER

Specifies that the following is used as the sorting key; the Feret diameter that is perpendicular to the maximum Feret diameter of each blob. INFO

Click to summarize M_FERET_PERPENDICULAR_TO_MIN_DIAMETER

Specifies that the following is used as the sorting key; the Feret diameter that is perpendicular to the minimum Feret diameter of each blob. INFO

Click to summarize M_FERET_PRINCIPAL_AXIS_ELONGATION +

Specifies that the following is used as the sorting key; the ratio between the Feret diameter at the principal axis and the Feret diameter at the secondary axis of each blob. INFO

(summarize)
Click to summarize M_FERET_X

Specifies that the following is used as the sorting key; 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). INFO

Click to summarize M_FERET_Y

Specifies that the following is used as the sorting key; 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). INFO

Click to summarize M_FIRST_POINT_X

Specifies that the following is used as the sorting key; the X-coordinate of a unique point (along with M_FIRST_POINT_Y) for each blob, that is on the perimeter of the blob. INFO

Click to summarize M_FIRST_POINT_Y

Specifies that the following is used as the sorting key; the Y-coordinate of a unique point (along with M_FIRST_POINT_X) for each blob, that is on the perimeter of the blob. INFO

Click to summarize M_INTERCEPT_0

Specifies that the following is used as the sorting key; the number of times a transition from background to foreground (not vice versa) occurs in the horizontal direction for the entire blob. INFO

Click to summarize M_INTERCEPT_45

Specifies that the following is used as the sorting key; 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. INFO

(summarize)
Click to summarize M_INTERCEPT_90

Specifies that the following is used as the sorting key; the number of times that the neighborhood configuration occurs in a blob. INFO

(summarize)
Click to summarize M_INTERCEPT_135

Specifies that the following is used as the sorting key; the number of times that the neighborhood configuration occurs in a blob. INFO

(summarize)
Click to summarize M_LABEL_VALUE

Specifies that the following is used as the sorting key; the label value of each blob. INFO

Click to summarize M_LENGTH

Specifies that the following is used as the sorting key; the length of each blob. INFO

Click to summarize M_MAX_PIXEL

Specifies that the following is used as the sorting key; the maximum pixel value found in each blob. INFO

Click to summarize M_MEAN_PIXEL

Specifies that the following is used as the sorting key; the mean pixel value in each blob. INFO

Click to summarize M_MIN_AREA_BOX_ANGLE

Specifies that the following is used as the sorting key; the angle of the minimum-area bounding box of each blob. INFO

Click to summarize M_MIN_AREA_BOX_AREA

Specifies that the following is used as the sorting key; the area of the minimum-area bounding box of each blob. INFO

Click to summarize M_MIN_AREA_BOX_CENTER_X

Specifies that the following is used as the sorting key; the X-coordinate of the center of the minimum-area bounding box of each blob. INFO

Click to summarize M_MIN_AREA_BOX_CENTER_Y

Specifies that the following is used as the sorting key; the Y-coordinate of the center of the minimum-area bounding box of each blob. INFO

Click to summarize M_MIN_AREA_BOX_HEIGHT

Specifies that the following is used as the sorting key; the height (shortest side) of the minimum-area bounding box of each blob. INFO

Click to summarize M_MIN_AREA_BOX_PERIMETER

Specifies that the following is used as the sorting key; the perimeter of the minimum-area bounding box of each blob. INFO

Click to summarize M_MIN_AREA_BOX_WIDTH

Specifies that the following is used as the sorting key; the width (longest side) of the minimum-area bounding box of each blob. INFO

Click to summarize M_MIN_PERIMETER_BOX_ANGLE

Specifies that the following is used as the sorting key; the angle of the minimum-perimeter bounding box of each blob. INFO

Click to summarize M_MIN_PERIMETER_BOX_AREA

Specifies that the following is used as the sorting key; the area of the minimum-perimeter bounding box of each blob. INFO

Click to summarize M_MIN_PERIMETER_BOX_CENTER_X

Specifies that the following is used as the sorting key; the X-coordinate of the center of the minimum-perimeter bounding box of each blob. INFO

Click to summarize M_MIN_PERIMETER_BOX_CENTER_Y

Specifies that the following is used as the sorting key; the Y-coordinate of the center of the minimum-perimeter bounding box of each blob. INFO

Click to summarize M_MIN_PERIMETER_BOX_HEIGHT

Specifies that the following is used as the sorting key; the height (shortest side) of the minimum-perimeter bounding box of each blob. INFO

Click to summarize M_MIN_PERIMETER_BOX_PERIMETER

Specifies that the following is used as the sorting key; the perimeter of the minimum-perimeter bounding box of each blob. INFO

Click to summarize M_MIN_PERIMETER_BOX_WIDTH

Specifies that the following is used as the sorting key; the width (longest side) of the minimum-perimeter bounding box of each blob. INFO

Click to summarize M_MIN_PIXEL

Specifies that the following is used as the sorting key; the minimum pixel value found in each blob. INFO

Click to summarize M_MOMENT_CENTRAL_X0_Y2 +

Specifies that the following is used as the sorting key; the central moment of each blob where the order of X equals 0 and the order of Y equals 2. INFO

(summarize)
Click to summarize M_MOMENT_CENTRAL_X1_Y1 +

Specifies that the following is used as the sorting key; the central moment of each blob where the order of X equals 1 and the order of Y equals 1. INFO

(summarize)
Click to summarize M_MOMENT_CENTRAL_X2_Y0 +

Specifies that the following is used as the sorting key; the central moment of each blob where the order of X equals 2 and the order of Y equals 0. INFO

(summarize)
Click to summarize M_MOMENT_GENERAL +

Specifies that the following is used as the sorting key; the moment calculation, based on the settings specified using MblobControl() with M_MOMENT_GENERAL_MODE, M_MOMENT_GENERAL_ORDER_X, and M_MOMENT_GENERAL_ORDER_Y. INFO

(summarize)
Click to summarize M_MOMENT_X0_Y1 +

Specifies that the following is used as the sorting key; the ordinary moment of each blob where the order of X equals 0 and the order of Y equals 1. INFO

(summarize)
Click to summarize M_MOMENT_X0_Y2 +

Specifies that the following is used as the sorting key; the ordinary moment of each blob where the order of X equals 0 and the order of Y equals 2. INFO

(summarize)
Click to summarize M_MOMENT_X1_Y0 +

Specifies that the following is used as the sorting key; the ordinary moment of each blob where the order of X equals 1 and the order of Y equals 0. INFO

(summarize)
Click to summarize M_MOMENT_X1_Y1 +

Specifies that the following is used as the sorting key; the ordinary moment of each blob where the order of X equals 1 and the order of Y equals 1. INFO

(summarize)
Click to summarize M_MOMENT_X2_Y0 +

Specifies that the following is used as the sorting key; the ordinary moment of each blob where the order of X equals 2 and the order of Y equals 0. INFO

(summarize)
Click to summarize M_NO_SORT

Specifies that the sorting key is removed.

Click to summarize M_NUMBER_OF_CHAINED_PIXELS

Specifies that the following is used as the sorting key; the number of chained pixels in each blob. INFO

Click to summarize M_NUMBER_OF_CONVEX_HULL_POINTS

Specifies that the following is used as the sorting key; the number of points on the convex perimeter of each blob. INFO

Click to summarize M_NUMBER_OF_HOLES

Specifies that the following is used as the sorting key; the number of holes in each blob. INFO

Click to summarize M_NUMBER_OF_RUNS

Specifies that the following is used as the sorting key; the total number of runs in each blob. INFO

Click to summarize M_PERIMETER

Specifies that the following is used as the sorting key; the total length of edges in each blob (including the edges of any holes), whereby an allowance made for the staircase effect that is produced when diagonal edges are digitized (inside corners are counted as 1.414, rather than 2.0). INFO

Click to summarize M_RECTANGULARITY

Specifies that the following is used as the sorting key; the degree to which each blob is similar to a rectangle. INFO

Click to summarize M_ROUGHNESS

Specifies that the following is used as the sorting key; the roughness and irregularity of a blob is, and is equal to M_PERIMETER / M_CONVEX_PERIMETER. INFO

Click to summarize M_SIGMA_PIXEL

Specifies that the following is used as the sorting key; the standard deviation of pixel values in each blob. INFO

Click to summarize M_SUM_PIXEL

Specifies that the following is used as the sorting key; the sum of all pixel values in each blob. INFO

Click to summarize M_SUM_PIXEL_SQUARED

Specifies that the following is used as the sorting key; the sum of the squares of each pixel value in each blob. INFO

Click to summarize M_WORLD_BOX_X_MAX

Specifies that the following is used as the sorting key; the extreme right X-coordinate of the world-axis-aligned bounding box, of each blob. INFO

Click to summarize M_WORLD_BOX_X_MIN

Specifies that the following is used as the sorting key; the extreme left X-coordinate of the world-axis-aligned bounding box, of each blob. INFO

Click to summarize M_WORLD_BOX_Y_MAX

Specifies that the following is used as the sorting key; the extreme bottom Y-coordinate of the world-axis-aligned bounding box, of each blob. INFO

Click to summarize M_WORLD_BOX_Y_MIN

Specifies that the following is used as the sorting key; the extreme top Y-coordinate of the world-axis-aligned bounding box, of each blob. INFO

Click to summarize M_WORLD_FERET_X

Specifies that the following is used as the sorting key; the dimension of the world-axis-aligned minimum bounding box, along the X-axis of the relative coordinate system (that is, M_WORLD_BOX_X_MAX - M_WORLD_BOX_X_MIN + 1). INFO

Click to summarize M_WORLD_FERET_Y

Specifies that the following is used as the sorting key; the dimension of the world-axis-aligned minimum bounding box, along the Y-axis of the relative coordinate system (that is, M_WORLD_BOX_Y_MAX - M_WORLD_BOX_Y_MIN + 1). INFO

Click to summarize M_WORLD_X_AT_Y_MAX

Specifies that the following is used as the sorting key; the X-coordinate at the maximum Y-coordinate of each blob, of the world-axis-aligned bounding box. INFO

Click to summarize M_WORLD_X_AT_Y_MIN

Specifies that the following is used as the sorting key; the X-coordinate at the minimum Y-coordinate of each blob, of the world-axis-aligned bounding box. INFO

Click to summarize M_WORLD_Y_AT_X_MAX

Specifies that the following is used as the sorting key; the Y-coordinate at the maximum X-coordinate of each blob, of the world-axis-aligned bounding box. INFO

Click to summarize M_WORLD_Y_AT_X_MIN

Specifies that the following is used as the sorting key; the Y-coordinate at the minimum X-coordinate of each blob, of the world-axis-aligned bounding box. INFO

Click to summarize M_X_MAX_AT_Y_MAX

Specifies that the following is used as the sorting key; the maximum X-coordinate at the maximum Y-coordinate of each blob. INFO

Click to summarize M_X_MAX_AT_Y_MIN

Specifies that the following is used as the sorting key; the maximum X-coordinate at the minimum Y-coordinate of each blob. INFO

Click to summarize M_X_MIN_AT_Y_MAX

Specifies that the following is used as the sorting key; the minimum X-coordinate at the maximum Y-coordinate of each blob. INFO

Click to summarize M_X_MIN_AT_Y_MIN

Specifies that the following is used as the sorting key; the minimum X-coordinate at the minimum Y-coordinate of each blob. INFO

Click to summarize M_Y_MAX_AT_X_MAX

Specifies that the following is used as the sorting key; the maximum Y-coordinate at the maximum X-coordinate of each blob. INFO

Click to summarize M_Y_MAX_AT_X_MIN

Specifies that the following is used as the sorting key; the maximum Y-coordinate at the minimum X-coordinate of each blob. INFO

Click to summarize M_Y_MIN_AT_X_MAX

Specifies that the following is used as the sorting key; the minimum Y-coordinate at the maximum X-coordinate of each blob. INFO

Click to summarize M_Y_MIN_AT_X_MIN

Specifies that the following is used as the sorting key; the minimum Y-coordinate at the minimum X-coordinate of each blob. INFO

Click to summarize M_SORTn_DIRECTION +

Inquires the direction in which the n th sorting key was sorted, where n stands for an integer between 1 and 3. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_SORT_UP.

Click to summarize M_SORT_DOWN

Specifies the feature as being sorted in descending order.

Click to summarize M_SORT_UP

Specifies the feature as being sorted in ascending order.

Click to summarize M_TIMEOUT +

Inquires the maximum processing time for MblobCalculate(), in msec. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
Click to summarize M_DISABLE

Specifies that there is no maximum processing time.

Click to summarize Value >= 0

Specifies the maximum processing time, in msec.

For the following inquire types, the ContextOrResultBlobId parameter can specify a Blob Analysis context. The following group of features do not use grayscale pixel values; they are calculated using only the blob identifier image.

function map For inquiring about features with only a binary definition
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_BOX +

Inquires whether image-axis-aligned bounding box features will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that these features will not be calculated.

Click to summarize M_ENABLE

Specifies that these features will be calculated.

Click to summarize M_BREADTH +

Inquires whether the breadth of a blob will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_CHAINS +

Inquires whether chain features will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that these features will not be calculated.

Click to summarize M_ENABLE

Specifies that these features will be calculated.

Click to summarize M_COMPACTNESS +

Inquires whether a measure of the compactness of an object will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_CONTACT_POINTS +

Inquires whether the contact features will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that these features will not be calculated.

Click to summarize M_ENABLE

Specifies that these features will be calculated.

Click to summarize M_CONVEX_HULL +

Inquires whether all convex hull features will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that these features will not be calculated.

Click to summarize M_ENABLE

Specifies that these features will be calculated.

Click to summarize M_CONVEX_PERIMETER +

Inquires whether the approximation of the perimeter of the convex hull of a blob will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_ELONGATION +

Inquires whether a measure of the elongation of an object will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_EULER_NUMBER +

Inquires whether the number of blobs - number of holes will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_FERET_GENERAL +

Inquires whether the user-specified Feret diameter will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_FERET_MAX_DIAMETER_ELONGATION +

Inquires whether the ratio between the maximum Feret diameter and its perpendicular Feret diameter will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_FERET_MIN_DIAMETER_ELONGATION +

Inquires whether the ratio between the minimum Feret diameter and its perpendicular Feret diameter will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_FERET_PERPENDICULAR_TO_MAX_DIAMETER +

Inquires whether the Feret diameter that is perpendicular to the maximum Feret diameter will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_FERET_PERPENDICULAR_TO_MIN_DIAMETER +

Inquires whether the Feret diameter that is perpendicular to the minimum Feret diameter will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_FERETS +

Inquires whether the Feret features will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that these features will not be calculated.

Click to summarize M_ENABLE

Specifies that these features will be calculated.

Click to summarize M_INTERCEPT +

Inquires whether the intercept features will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that these features will not be calculated.

Click to summarize M_ENABLE

Specifies that these features will be calculated.

Click to summarize M_LENGTH +

Inquires whether the length of a blob will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_MIN_AREA_BOX +

Inquires whether all the minimum-area bounding box features will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that these features will not be calculated.

Click to summarize M_ENABLE

Specifies that these features will be calculated.

Click to summarize M_MIN_PERIMETER_BOX +

Inquires whether all the minimum-perimeter bounding box features will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that these features will not be calculated.

Click to summarize M_ENABLE

Specifies that these features will be calculated.

Click to summarize M_NUMBER_OF_HOLES +

Inquires whether the number of holes in a blob will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_PERIMETER +

Inquires whether the total length of edges in a blob (including the edges of any holes) will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_RECTANGULARITY +

Inquires whether the degree to which a blob resembles a rectangle will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_ROUGHNESS +

Inquires if the roughness and irregularity of a blob will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_RUNS +

Inquires whether the blob run-length encoding information will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that these features will not be calculated.

Click to summarize M_ENABLE

Specifies that these features will be calculated.

Click to summarize M_WORLD_BOX +

Inquires whether all of the features related to the world-axis-aligned bounding box will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that these features will not be calculated.

Click to summarize M_ENABLE

Specifies that these features will be calculated.

For the following inquire types, the ContextOrResultBlobId parameter can specify a Blob Analysis context. The following features require grayscale pixel values, and can only be calculated if you provide a grayscale image.

function map For inquiring about features with only a grayscale definition
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_BLOB_CONTRAST +

Inquires whether the difference between the maximum and minimum pixel values of a blob will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_MAX_PIXEL +

Inquires whether the maximum pixel value in a blob will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_MEAN_PIXEL +

Inquires whether the mean pixel value in a blob will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_MIN_PIXEL +

Inquires whether the minimum pixel value in a blob will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_SIGMA_PIXEL +

Inquires whether the standard deviation of pixel values in a blob will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_SUM_PIXEL +

Inquires whether the sum of all pixel values in a blob will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_SUM_PIXEL_SQUARED +

Inquires whether the sum of the squares of each pixel value in a blob will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

For the following inquire types, the ContextOrResultBlobId parameter can specify a Blob Analysis context. The following features have two different definitions: a binary definition, where all pixels are considered equal, and a grayscale, where pixels are weighted by their value in the gray image (the grayscale version is much slower to calculate). If you do not provide a grayscale image, only the binary version can be calculated. If you do provide a grayscale image, both versions are calculated.

function map For inquiring about features with two definitions (binary and grayscale)
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_CENTER_OF_GRAVITY +

Inquires whether both X- and Y-coordinates of the center of gravity will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that these features will not be calculated.

Click to summarize M_ENABLE

Specifies that these features will be calculated.

Click to summarize M_FERET_AT_PRINCIPAL_AXIS_ANGLE +

Inquires whether the Feret diameter at the principal axis of a blob will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_FERET_AT_SECONDARY_AXIS_ANGLE +

Inquires whether the Feret diameter at the secondary axis of a blob will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_FERET_PRINCIPAL_AXIS_ELONGATION +

Inquires whether the ratio between the Feret diameter at the principal axis and the Feret diameter at the secondary axis will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_MOMENT_FIRST_ORDER +

Inquires whether the first-order moments will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that these features will not be calculated.

Click to summarize M_ENABLE

Specifies that these features will be calculated.

Click to summarize M_MOMENT_GENERAL +

Inquires whether the user-specified moment will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that this feature will not be calculated.

Click to summarize M_ENABLE

Specifies that this feature will be calculated.

Click to summarize M_MOMENT_SECOND_ORDER +

Inquires whether the second-order moments will be calculated. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_DEFAULT

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that these features will not be calculated.

Click to summarize M_ENABLE

Specifies that these features will be calculated.

Combination values for the following values of out-parameters: M_AXIS_PRINCIPAL_ANGLE (when InquireType=M_SORTn and UserVarPtr=M_AXIS_PRINCIPAL_ANGLE); M_AXIS_SECONDARY_ANGLE (when InquireType=M_SORTn and UserVarPtr=M_AXIS_SECONDARY_ANGLE); M_CENTER_OF_GRAVITY_X (when InquireType=M_SORTn and UserVarPtr=M_CENTER_OF_GRAVITY_X); M_CENTER_OF_GRAVITY_Y (when InquireType=M_SORTn and UserVarPtr=M_CENTER_OF_GRAVITY_Y); M_FERET_AT_PRINCIPAL_AXIS_ANGLE (when InquireType=M_SORTn and UserVarPtr=M_FERET_AT_PRINCIPAL_AXIS_ANGLE); M_FERET_AT_SECONDARY_AXIS_ANGLE (when InquireType=M_SORTn and UserVarPtr=M_FERET_AT_SECONDARY_AXIS_ANGLE); M_FERET_PRINCIPAL_AXIS_ELONGATION (when InquireType=M_SORTn and UserVarPtr=M_FERET_PRINCIPAL_AXIS_ELONGATION); M_MOMENT_CENTRAL_X0_Y2 (when InquireType=M_SORTn and UserVarPtr=M_MOMENT_CENTRAL_X0_Y2); M_MOMENT_CENTRAL_X1_Y1 (when InquireType=M_SORTn and UserVarPtr=M_MOMENT_CENTRAL_X1_Y1); M_MOMENT_CENTRAL_X2_Y0 (when InquireType=M_SORTn and UserVarPtr=M_MOMENT_CENTRAL_X2_Y0); M_MOMENT_GENERAL (when InquireType=M_SORTn and UserVarPtr=M_MOMENT_GENERAL); M_MOMENT_X0_Y1 (when InquireType=M_SORTn and UserVarPtr=M_MOMENT_X0_Y1); M_MOMENT_X0_Y2 (when InquireType=M_SORTn and UserVarPtr=M_MOMENT_X0_Y2); M_MOMENT_X1_Y0 (when InquireType=M_SORTn and UserVarPtr=M_MOMENT_X1_Y0); M_MOMENT_X1_Y1 (when InquireType=M_SORTn and UserVarPtr=M_MOMENT_X1_Y1); M_MOMENT_X2_Y0 (when InquireType=M_SORTn and UserVarPtr=M_MOMENT_X2_Y0).
Combination values for the following values of in-parameters: the values listed in For inquiring about features with two definitions (binary and grayscale).

The above-mentioned in-parameter values must be added to the following values. The above-mentioned out-parameter values are returned combined with the following values. In either case, the following values are used to set whether the results should be returned for the binary or grayscale version of the selected feature.

function map For feature parameters that have two definitions
Click to summarize
Combination value
Description
Click to summarize M_BINARY

Selects the binary definition of the selected feature.

Click to summarize M_GRAYSCALE

Selects the grayscale definition of the selected feature.

Combination value for the values listed in all the parameter association tables except For inquiring the system on which the result buffer or context is allocated, For inquiring about the global processing settings of a Blob Analysis context that cause results to be recalculated, For inquiring about a processing setting in a Blob Analysis result buffer.

You can add the following value to the above-mentioned values to determine the default value of an inquire type, regardless of the current value of the inquire type.

function map For inquiring the default value of an inquire type
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_DEFAULT

Inquires the default value of the specified inquire type.

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE

For the following inquire types, the ContextOrResultBlobId parameter must specify a Blob Analysis result buffer.

function map For inquiring about a processing setting in a Blob Analysis result buffer
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_INPUT_SELECT_UNITS +

Inquires the units in which the CondLow and CondHigh parameters of MblobSelect() expect the limits of the blob selection condition. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_PIXEL

Specifies that the limit values passed to MblobSelect() be interpreted in pixel units, with respect to the pixel coordinate system.

Click to summarize M_WORLD

Specifies that the limit values passed to MblobSelect() be interpreted in world units, with respect to the relative coordinate system. INFO

Click to summarize M_RESULT_OUTPUT_UNITS +

Inquires whether results are returned in pixel or world units. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE MORE
Click to summarize M_ACCORDING_TO_CALIBRATION

Specifies that results are returned in world units if the result was calculated on an image associated with a camera calibration context; otherwise, specifies that results are returned in pixel units.

Click to summarize M_PIXEL

Specifies that results are returned in pixel units, with respect to the pixel coordinate system.

Click to summarize M_WORLD

Specifies that results are returned in world units, with respect to the relative coordinate system. INFO

You can add one of the following values to the above-mentioned values to cast the requested information to the required data type.

function map For specifying the data type
Click to summarizeInquireType Description
UserVarPtr
- Possible values returned
Click to summarize M_TYPE_MIL_DOUBLE

Casts the requested information to a MIL_DOUBLE.

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
Click to summarize M_TYPE_MIL_ID

Casts the requested information to a MIL_ID.

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_ID
Click to summarize M_TYPE_MIL_INT

Casts the requested information to a MIL_INT.

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT
Click to summarize M_TYPE_MIL_INT32

Casts the requested information to a MIL_INT32.

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT32
Click to summarize M_TYPE_MIL_INT64

Casts the requested information to a MIL_INT64.

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
Return value
The returned value is the requested information, cast to a MIL_INT. If the requested information does not fit into a MIL_INT, this function will return M_NULL or truncate the information.
Compilation information
Header Include mil.h.
Library Use mil.lib; milblob.lib.
DLL Requires mil.dll; milblob.dll.
OWNER SYSTEM DEFAULT HOST BLOB IDENTIFICATION MODE DEFAULT INDIVIDUAL LABELED LABELED TOUCHING WHOLE IMAGE CONNECTIVITY DEFAULT 4 CONNECTED 8 CONNECTED FERET ANGLE SEARCH END DEFAULT FERET ANGLE SEARCH START DEFAULT FOREGROUND VALUE DEFAULT NONZERO ZERO NUMBER OF FERETS INFINITE MIN FERETS MIN FERETS FERET CONTACT POINTS DEFAULT DISABLE ENABLE FERET GENERAL ANGLE DEFAULT IDENTIFIER TYPE DEFAULT BINARY GRAYSCALE MAX BLOBS DEFAULT DISABLE MOMENT GENERAL MODE DEFAULT CENTRAL ORDINARY MOMENT GENERAL ORDER X DEFAULT MOMENT GENERAL ORDER Y DEFAULT PIXEL ASPECT RATIO DEFAULT RETURN PARTIAL RESULTS DEFAULT DISABLE ENABLE SAVE RUNS DEFAULT DISABLE ENABLE SORTn AREA AXIS PRINCIPAL ANGLE AXIS SECONDARY ANGLE BLOB CONTRAST BLOB TOUCHING IMAGE BORDERS BOX AREA BOX ASPECT RATIO BOX FILL RATIO BOX X MAX BOX X MIN BOX Y MAX BOX Y MIN BREADTH CENTER OF GRAVITY X CENTER OF GRAVITY Y COMPACTNESS CONVEX HULL AREA CONVEX HULL COG X CONVEX HULL COG Y CONVEX HULL FILL RATIO CONVEX HULL PERIMETER CONVEX PERIMETER ELONGATION EULER NUMBER FERET AT PRINCIPAL AXIS ANGLE FERET AT SECONDARY AXIS ANGLE FERET ELONGATION FERET GENERAL FERET MAX ANGLE FERET MAX DIAMETER FERET MAX DIAMETER ELONGATION FERET MEAN DIAMETER FERET MIN ANGLE FERET MIN DIAMETER FERET MIN DIAMETER ELONGATION FERET PERPENDICULAR TO MAX DIAMETER FERET PERPENDICULAR TO MIN DIAMETER FERET PRINCIPAL AXIS ELONGATION FERET X FERET Y FIRST POINT X FIRST POINT Y INTERCEPT 0 INTERCEPT 45 INTERCEPT 90 INTERCEPT 135 LABEL VALUE LENGTH MAX PIXEL MEAN PIXEL MIN AREA BOX ANGLE MIN AREA BOX AREA MIN AREA BOX CENTER X MIN AREA BOX CENTER Y MIN AREA BOX HEIGHT MIN AREA BOX PERIMETER MIN AREA BOX WIDTH MIN PERIMETER BOX ANGLE MIN PERIMETER BOX AREA MIN PERIMETER BOX CENTER X MIN PERIMETER BOX CENTER Y MIN PERIMETER BOX HEIGHT MIN PERIMETER BOX PERIMETER MIN PERIMETER BOX WIDTH MIN PIXEL MOMENT CENTRAL X0 Y2 MOMENT CENTRAL X1 Y1 MOMENT CENTRAL X2 Y0 MOMENT GENERAL MOMENT X0 Y1 MOMENT X0 Y2 MOMENT X1 Y0 MOMENT X1 Y1 MOMENT X2 Y0 NO SORT NUMBER OF CHAINED PIXELS NUMBER OF CONVEX HULL POINTS NUMBER OF HOLES NUMBER OF RUNS PERIMETER RECTANGULARITY ROUGHNESS SIGMA PIXEL SUM PIXEL SUM PIXEL SQUARED WORLD BOX X MAX WORLD BOX X MIN WORLD BOX Y MAX WORLD BOX Y MIN WORLD FERET X WORLD FERET Y WORLD X AT Y MAX WORLD X AT Y MIN WORLD Y AT X MAX WORLD Y AT X MIN X MAX AT Y MAX X MAX AT Y MIN X MIN AT Y MAX X MIN AT Y MIN Y MAX AT X MAX Y MAX AT X MIN Y MIN AT X MAX Y MIN AT X MIN SORTn DIRECTION DEFAULT SORT DOWN SORT UP TIMEOUT DISABLE BOX DEFAULT DISABLE ENABLE BREADTH DEFAULT DISABLE ENABLE CHAINS DEFAULT DISABLE ENABLE COMPACTNESS DEFAULT DISABLE ENABLE CONTACT POINTS DEFAULT DISABLE ENABLE CONVEX HULL DEFAULT DISABLE ENABLE CONVEX PERIMETER DEFAULT DISABLE ENABLE ELONGATION DEFAULT DISABLE ENABLE EULER NUMBER DEFAULT DISABLE ENABLE FERET GENERAL DEFAULT DISABLE ENABLE FERET MAX DIAMETER ELONGATION DEFAULT DISABLE ENABLE FERET MIN DIAMETER ELONGATION DEFAULT DISABLE ENABLE FERET PERPENDICULAR TO MAX DIAMETER DEFAULT DISABLE ENABLE FERET PERPENDICULAR TO MIN DIAMETER DEFAULT DISABLE ENABLE FERETS DEFAULT DISABLE ENABLE INTERCEPT DEFAULT DISABLE ENABLE LENGTH DEFAULT DISABLE ENABLE MIN AREA BOX DEFAULT DISABLE ENABLE MIN PERIMETER BOX DEFAULT DISABLE ENABLE NUMBER OF HOLES DEFAULT DISABLE ENABLE PERIMETER DEFAULT DISABLE ENABLE RECTANGULARITY DEFAULT DISABLE ENABLE ROUGHNESS DEFAULT DISABLE ENABLE RUNS DEFAULT DISABLE ENABLE WORLD BOX DEFAULT DISABLE ENABLE BLOB CONTRAST DEFAULT DISABLE ENABLE MAX PIXEL DEFAULT DISABLE ENABLE MEAN PIXEL DEFAULT DISABLE ENABLE MIN PIXEL DEFAULT DISABLE ENABLE SIGMA PIXEL DEFAULT DISABLE ENABLE SUM PIXEL DEFAULT DISABLE ENABLE SUM PIXEL SQUARED DEFAULT DISABLE ENABLE CENTER OF GRAVITY DEFAULT DISABLE ENABLE FERET AT PRINCIPAL AXIS ANGLE DEFAULT DISABLE ENABLE FERET AT SECONDARY AXIS ANGLE DEFAULT DISABLE ENABLE FERET PRINCIPAL AXIS ELONGATION DEFAULT DISABLE ENABLE MOMENT FIRST ORDER DEFAULT DISABLE ENABLE MOMENT GENERAL DEFAULT DISABLE ENABLE MOMENT SECOND ORDER DEFAULT DISABLE ENABLE BINARY GRAYSCALE DEFAULT INPUT SELECT UNITS PIXEL WORLD RESULT OUTPUT UNITS ACCORDING TO CALIBRATION PIXEL WORLD TYPE MIL DOUBLE TYPE MIL ID TYPE MIL INT TYPE MIL INT32 TYPE MIL INT64