| MIL 10 Reference
| Customize Help
| Save Settings

MblobInquire


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

Available on Windows
Available on Linux

Available on Non-Matrox computer
Available on Matrox 4Sight-X
Available on Matrox 4Sight GP
Available on Matrox Supersight
function map Function map
Examples
None.
MblobGetRuns
MblobLabel
Synopsis
Inquire about a processing setting associated with a blob analysis result buffer.
Syntax
MIL_INT MblobInquire(
MIL_ID ResOrFeatListBlobId, //in
MIL_INT64 InquireType, //in
void *UserVarPtr //out
)
Description

This function inquires about a specified processing setting associated with a blob analysis result buffer.

You can use MblobControl() to change a processing setting associated with 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 if there is complementary information.
Parameters
This function is not supported on the selected boards.
Parameters
ResOrFeatListBlobId

Specifies the identifier of a blob analysis result buffer or feature list.

InquireType

Specifies the type of processing 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.

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

Parameter associations

The tables below list possible values for the InquireType parameter and possible values returned to the UserVarPtr parameter.

For the following inquire type, the ResOrFeatListBlobId parameter can specify a blob analysis result buffer or feature list.

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.

function map For inquiring the system on which the result buffer or feature list is allocated
CollapseInquireType Description
UserVarPtr
- Possible values returned
Collapse M_OWNER_SYSTEM +

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

(summarize)
Collapse M_DEFAULT_HOST

Specifies the default Host system of the current MIL application.
Collapse MIL system identifier

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

For the following inquire types, the ResOrFeatListBlobId parameter must specify a blob analysis result buffer.

Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.

function map For inquiring about a processing setting in a blob analysis result buffer
CollapseInquireType Description
UserVarPtr
- Possible values returned
Collapse M_BLOB_IDENTIFICATION +

Inquires the blob identification mode that was selected. SET

(summarize)
Collapse M_INDIVIDUAL

Specifies that all blobs are measured individually.
Collapse M_LABELED

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

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

Specifies that all blobs are grouped together.
Collapse 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)
Collapse 0 <= Value <= 180

Specifies the upper limit of the angular search range. INFO
Collapse 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)
Collapse 0 <= Value <= 180

Specifies the lower limit of the angular search range. INFO
Collapse M_FOREGROUND_VALUE +

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

(summarize)
Collapse M_NONZERO

Specifies the blobs consisting of non-zero pixels.
Collapse M_ZERO

Specifies the blobs consisting of zero pixels.
Collapse M_IDENTIFIER_TYPE +

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

(summarize)
Collapse M_BINARY

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

Specifies that non-zero pixels can have any value.
Collapse 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)
Collapse M_PIXEL

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

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

Inquires the image lattice. SET

(summarize)
Collapse M_4_CONNECTED

Specifies that each pixel has 4 neighbors.
Collapse M_8_CONNECTED

Specifies that each pixel has 8 neighbors.
Collapse M_MAX_BLOBS +

Inquires the maximum number of blobs to process. SET

(summarize)
Collapse M_DISABLE

Specifies that there is no limit on the maximum number of blobs.
Collapse Value >= 0

Specifies the maximum number of blobs.
Collapse M_MAX_LABEL +

Inquires the maximum label value given to any included blob in the result buffer.

Label values for blobs are generated when a call to MblobCalculate() is made. The maximum label value is not necessarily the same as the total number of blobs because some label values might not be used, depending on the blob's shape. One of the uses for obtaining the maximum label value is to determine if an 8 or 16-bit image buffer is needed for MblobLabel().

(summarize)
Collapse Value

Specifies the maximum label value.
Collapse M_NUMBER_OF_FERETS +

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

(summarize)
Collapse M_INFINITE

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

Specifies the minimum number of Feret angles. INFO
Collapse Value > M_MIN_FERETS

Specifies the number of Feret angles. INFO
Collapse M_OWNER_SYSTEM +

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

(summarize)
Collapse M_DEFAULT_HOST

Specifies the default Host system of the current MIL application.
Collapse MIL system identifier

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

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

(summarize)
Collapse Value

Specifies the pixel width/pixel height.
Collapse M_RESULT_OUTPUT_UNITS +

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

(summarize)
Collapse M_ACCORDING_TO_CALIBRATION

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

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

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

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

(summarize)
Collapse M_DISABLE

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

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

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

(summarize)
Collapse M_DISABLE

Specifies not to save run information. INFO
Collapse M_ENABLE

Specifies to save run information. INFO
Collapse M_TIMEOUT +

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

(summarize)
Collapse M_DISABLE

Specifies that there is no maximum processing time.
Collapse Value >= 0

Specifies the maximum processing time, in msec.

You can add one of the following values to the above-mentioned values to set the requested results to a data type.

function map For specifying the data type
CollapseInquireType Description
UserVarPtr
- Possible values returned
Collapse M_TYPE_MIL_DOUBLE

Casts the requested information to a MIL_DOUBLE.

(summarize)
Collapse UserVarPtr data type info

Data type: MIL_DOUBLE

Collapse M_TYPE_MIL_ID

Casts the requested information to a MIL_ID.

(summarize)
Collapse UserVarPtr data type info

Data type: MIL_ID

Collapse M_TYPE_MIL_INT

Casts the requested information to a MIL_INT.

(summarize)
Collapse UserVarPtr data type info

Data type: MIL_INT

Collapse M_TYPE_MIL_INT32

Casts the requested information to a MIL_INT32.

(summarize)
Collapse UserVarPtr data type info

Data type: MIL_INT32

Collapse M_TYPE_MIL_INT64

Casts the requested information to a MIL_INT64.

(summarize)
Collapse UserVarPtr data type info

Data type: MIL_INT64

Return value
The returned value is the requested information, cast to a MIL_INT.
Compilation information
Header Include mil.h.
Library Use mil.lib; milblob.lib.
DLL Requires mil.dll; milblob.dll.
OWNER SYSTEM DEFAULT HOST BLOB IDENTIFICATION INDIVIDUAL LABELED LABELED TOUCHING WHOLE IMAGE FERET ANGLE SEARCH END FERET ANGLE SEARCH START FOREGROUND VALUE NONZERO ZERO IDENTIFIER TYPE BINARY GRAYSCALE INPUT SELECT UNITS PIXEL WORLD LATTICE 4 CONNECTED 8 CONNECTED MAX BLOBS DISABLE MAX LABEL NUMBER OF FERETS INFINITE MIN FERETS MIN FERETS OWNER SYSTEM DEFAULT HOST PIXEL ASPECT RATIO RESULT OUTPUT UNITS ACCORDING TO CALIBRATION PIXEL WORLD RETURN PARTIAL RESULTS DISABLE ENABLE SAVE RUNS DISABLE ENABLE TIMEOUT DISABLE TYPE MIL DOUBLE TYPE MIL ID TYPE MIL INT TYPE MIL INT32 TYPE MIL INT64