Filters
Filter values by
  • General bead context settings
  • General bead result buffer settings
  • Bead template settings
    • Training related settings
    • Verification settings
| Customize Help
| Save Settings

MbeadInquire



Function Map
Synopsis
Inquire information about a bead context, template, or result.
Syntax
MIL_INT MbeadInquire(
MIL_ID ContextOrResultBeadId, //in
MIL_INT LabelOrIndex, //in
MIL_INT64 InquireType, //in
void *UserVarPtr //out
)
Description

This function inquires information about a specified bead context, a template contained within the context, or a bead result buffer. You can also use this function to inquire about operations performed with MbeadGetNeighbors(). Values are returned in the unit in which they were set (that is, either pixel or world units), using MbeadControl() and M_..._INPUT_UNITS.

If the inquired setting is set to M_DEFAULT (for example, in MbeadControl()), MbeadInquire() will return M_DEFAULT. To inquire the actual default value, add M_DEFAULT to the InquireType parameter.

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
ContextOrResultBeadId

Specifies the identifier of the bead context or the identifier of the bead result buffer about which to inquire. Both the bead context and result buffer must have been previously allocated on the required system using MbeadAlloc() or MbeadAllocResult(), respectively.

LabelOrIndex

Specifies the bead template about which to inquire, or specifies that you are inquiring about a global setting of the bead context or result. Unless otherwise specified, the LabelOrIndex parameter values require that the ContextOrResultBeadId parameter specifies the identifier of a bead context.

This parameter can be set to one of the following values:

function map For specifying what to inquire about
Click to summarizeValue Description
Click to summarize M_DEFAULT

Specifies the default.

If ContextOrResultBeadId is set to a bead context, the default is the same as M_CONTEXT.

If ContextOrResultBeadId is set to a bead result, the default is the same as M_GENERAL.

(summarize)
Click to summarize

Specifies the index of an existing template about which to inquire.

(summarize)
Parameters

Specifies the index. The index must be greater than or equal to 0.

Click to summarize

Specifies the label of an existing template about which to inquire.

(summarize)
Parameters

Specifies the label. The label must be greater than 0.

Click to summarize M_CONTEXT

Inquires information about a global setting of a bead context.

Click to summarize M_GENERAL

Inquires information about a setting of a bead result buffer. When using M_GENERAL, ContextOrResultBeadId must specify a bead result buffer.

(summarize)
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):
  • array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ]
  • array of type MIL_ID [optionally, in C++: a reference to a std::vector<MIL_ID> ]
  • array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ]
  • array of type MIL_INT32 [optionally, in C++: a reference to a std::vector<MIL_INT32> ]
  • array of type MIL_INT64 [optionally, in C++: a reference to a std::vector<MIL_INT64> ]
  • MIL_DOUBLE
  • MIL_ID
  • MIL_INT
  • MIL_INT32
  • MIL_INT64

Specifies the address in which to write the requested information. Since the MbeadInquire() 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.

To inquire about a bead template setting for the training phase, the InquireType parameter can be set to one of the following values. In this case, you must set the ContextOrResultBeadId parameter to the identifier of a bead context, and the LabelOrIndex parameter to a specific template, using either M_TEMPLATE_INDEX() or M_TEMPLATE_LABEL().

function map To inquire about a bead template setting for the training phase
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_INDIVIDUAL_WIDTH_NOMINAL +

Inquires the specified width of the template at the position of each of its vertices. This value applies only to templates whose path follows a polyline. SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE
Click to summarize Value

Specifies the width.

Click to summarize M_INTENSITY_NOMINAL_MODE +

Inquires how to establish the nominal pixel intensity of the template. 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_AUTO

Specifies to establish the nominal pixel intensity from the training image.

Click to summarize M_DISABLE

Specifies that M_INTENSITY_NOMINAL_MODE has no effect.

Click to summarize M_USER_DEFINED

Specifies that you will explicitly set the pixel intensity, using M_INTENSITY_NOMINAL.

Click to summarize M_POSITION_X +

Inquires the X-coordinates of the vertices in a template whose path follows a polyline. You can add, delete, or modify a template's vertices using MbeadTemplate(). SET SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE
Click to summarize Value

Specifies the X-coordinates of the template's vertices.

Click to summarize M_POSITION_Y +

Inquires the Y-coordinates of the vertices in a template whose path follows a polyline. You can add, delete, or modify a template's vertices using MbeadTemplate(). SET SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE
Click to summarize Value

Specifies the Y-coordinates of the template's vertices.

Click to summarize M_SIZE +

Inquires the number of vertices in a template whose path follows a polyline. You can add, delete, or modify a template's vertices using MbeadTemplate(). SET 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 Value

Specifies the number of points.

Click to summarize M_TEMPLATE_CIRCLE_CENTER_X +

Inquires the X-coordinate of the center of a template whose path follows a circle. 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 Value

Specifies the center's X-coordinate, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS.

Click to summarize M_TEMPLATE_CIRCLE_CENTER_Y +

Inquires the Y-coordinate of the center of a template whose path follows a circle. 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 Value

Specifies the center's Y-coordinate, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS.

Click to summarize M_TEMPLATE_CIRCLE_RADIUS +

Inquires the radius of a template whose path follows a circle. 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 Value

Specifies the radius, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS.

Click to summarize M_TEMPLATE_INPUT_UNITS +

Inquires the units with which to interpret the M_CLOSEST_POINT_MAX_DISTANCE, M_FAIL_WARNING_OFFSET, M_GAP_MAX_LENGTH, M_OFFSET_MAX, M_TEMPLATE_CIRCLE_CENTER_X, M_TEMPLATE_CIRCLE_CENTER_Y, M_TEMPLATE_CIRCLE_RADIUS, M_TEMPLATE_SEGMENT_END_X, M_TEMPLATE_SEGMENT_END_Y, M_TEMPLATE_SEGMENT_START_X, M_TEMPLATE_SEGMENT_START_Y, M_WIDTH_DELTA_NEG, M_WIDTH_DELTA_POS, and M_WIDTH_NOMINAL inquire types, as well as the units with which to interpret the template's position and dimension values specified using MbeadTemplate(). This essentially inquires the input coordinate system used. 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_PIXEL.

Click to summarize M_PIXEL

Specifies to interpret the values in pixel units, with respect to the pixel coordinate system.

Click to summarize M_WORLD

Specifies to interpret the values in world units, with respect to the relative coordinate system. INFO

Click to summarize M_TEMPLATE_SEGMENT_END_X +

Inquires the X-coordinate of the end of a template whose path follows a segment. 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 Value

Specifies the X-coordinate of the end of the segment, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS.

Click to summarize M_TEMPLATE_SEGMENT_END_Y +

Inquires the Y-coordinate of the end of a template whose path follows a segment. 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 Value

Specifies the Y-coordinate of the end of the segment, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS.

Click to summarize M_TEMPLATE_SEGMENT_START_X +

Inquires the X-coordinate of the start of a template whose path follows a segment. 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 Value

Specifies the X-coordinate of the start of the segment, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS.

Click to summarize M_TEMPLATE_SEGMENT_START_Y +

Inquires the Y-coordinate of the start of a template whose path follows a segment. 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 Value

Specifies the Y-coordinate of the start of the segment, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS.

Click to summarize M_TRAINING_BOX_HEIGHT +

Inquires the height of the search boxes. 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 10.0.

Click to summarize Value > 0.0

Specifies the height, relative to the input coordinate system specified using M_TRAINING_BOX_INPUT_UNITS.

Click to summarize M_TRAINING_BOX_INPUT_UNITS +

Inquires the units with which to interpret the M_TRAINING_BOX_HEIGHT, M_TRAINING_BOX_WIDTH, M_TRAINING_BOX_SPACING, and M_TRAINING_WIDTH_NOMINAL inquire types. 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_PIXEL.

Click to summarize M_PIXEL

Specifies to interpret the values in pixel units, with respect to the pixel coordinate system.

Click to summarize M_WORLD

Specifies to interpret the values in world units, with respect to the relative coordinate system. INFO

Click to summarize M_TRAINING_BOX_SPACING +

Inquires the distance between the search boxes. 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 10.0.

Click to summarize M_DISABLE

Specifies that M_TRAINING_BOX_SPACING has no effect. INFO

Click to summarize Value > 0.0

Specifies the spacing, relative to the input coordinate system specified using M_TRAINING_BOX_INPUT_UNITS.

Click to summarize M_TRAINING_BOX_WIDTH +

Inquires the width of the search boxes. 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 200.0.

Click to summarize Value > 0.0

Specifies the width, relative to the input coordinate system specified using M_TRAINING_BOX_INPUT_UNITS.

Click to summarize M_TRAINING_PATH +

Inquires how MIL establishes the path of the bead template. 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_POLYLINE_SEED.

Click to summarize M_CIRCLE

Specifies that the path of the bead template follows a fixed circle defined with M_TEMPLATE_CIRCLE_CENTER_X, M_TEMPLATE_CIRCLE_CENTER_Y, and M_TEMPLATE_CIRCLE_RADIUS. INFO

Click to summarize M_POLYLINE

Specifies that the path of the bead template follows a fixed polyline. INFO

Click to summarize M_POLYLINE_SEED

Specifies that the path of the bead template follows a polyline that is refined by the training image set with MbeadTrain(). INFO

Click to summarize M_SEGMENT

Specifies that the path of the bead template follows a fixed segment defined with M_TEMPLATE_SEGMENT_START_X, M_TEMPLATE_SEGMENT_START_Y, M_TEMPLATE_SEGMENT_END_X, and M_TEMPLATE_SEGMENT_END_Y. INFO

Click to summarize M_TRAINING_WIDTH_NOMINAL +

Inquires the width with which to validate the template's automatically established nominal width. 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 M_TRAINING_WIDTH_NOMINAL has no effect.

Click to summarize Value > 0.0

Specifies the width, relative to the input coordinate system specified using M_TRAINING_BOX_INPUT_UNITS.

Click to summarize M_TRAINING_WIDTH_SCALE_MAX +

Inquires the scale factor by which to determine the upper limit (maximum permitted scale) of the bead width. 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.2.

Click to summarize M_DISABLE

Specifies that M_TRAINING_WIDTH_SCALE_MAX has no effect.

Click to summarize Value > 0.0

Specifies the maximum scale factor. INFO

Click to summarize M_TRAINING_WIDTH_SCALE_MIN +

Inquires the scale factor by which to determine the lower limit (minimum permitted scale) of the bead width. 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.8.

Click to summarize M_DISABLE

Specifies that M_TRAINING_WIDTH_SCALE_MIN has no effect.

Click to summarize Value > 0.0

Specifies the minimum scale factor. INFO

Click to summarize M_WIDTH_NOMINAL +

Inquires the nominal width to use, when it is explicitly defined. 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 10.0.

Click to summarize Value > 0.0

Specifies the nominal width, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS.

Click to summarize M_WIDTH_NOMINAL_MODE +

Inquires how to establish the nominal width of the bead template. 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_AUTO_UNIFORM.

Click to summarize M_AUTO_CONTINUOUS

Specifies that the bead's nominal width is automatically established with MbeadTrain(), where the corresponding width at each vertex in the template can have its own unique value. INFO

Click to summarize M_AUTO_UNIFORM

Specifies that the bead's nominal width is automatically established with MbeadTrain(), where the corresponding width at all of the template's vertices must have the same value. INFO

Click to summarize M_USER_DEFINED

Specifies that you must explicitly set the bead's nominal width. INFO

To inquire about a bead template setting for the training and verification phases, the InquireType parameter can be set to one of the following values. In this case, you must set the ContextOrResultBeadId parameter to the identifier of a bead context, and the LabelOrIndex parameter to a specific template, using either M_TEMPLATE_INDEX() or M_TEMPLATE_LABEL().

function map To inquire about a bead template setting for the training and verification phases
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_FOREGROUND_VALUE +

Inquires whether the foreground of the measured bead should be darker or lighter than the background. 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_FOREGROUND_WHITE.

Click to summarize M_FOREGROUND_BLACK

Specifies that the foreground is darker than the background. INFO

Click to summarize M_FOREGROUND_WHITE

Specifies that the foreground is lighter than the background. INFO

Click to summarize M_SMOOTHNESS +

Inquires the degree of noise reduction that MIL uses when performing the edge extraction of the bead from an image. 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 50.0.

Click to summarize 0.0 <= Value <= 100.0

Specifies the smoothness value. INFO

Click to summarize M_THRESHOLD_MODE +

Inquires how to establish the threshold that MIL must use when performing the edge extraction of the bead from an image. 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_USER_DEFINED.

Click to summarize M_USER_DEFINED

Specifies that the threshold is explicitly defined with M_THRESHOLD_VALUE.

Click to summarize M_THRESHOLD_VALUE +

Inquires the value beneath which a grayscale variation within the image is not considered an edge of the bead. 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 10.0.

Click to summarize 0.0 <= Value <= 100.0

Specifies the threshold value. INFO

To inquire about a trained setting of a bead template, the InquireType parameter can be set to one of the following values. In this case, you must set the ContextOrResultBeadId parameter to the identifier of a bead context, and the LabelOrIndex parameter to a specific template, using either M_TEMPLATE_INDEX() or M_TEMPLATE_LABEL().

MIL typically bases trained values on their related training values and modifies them accordingly when you call MbeadTrain(). For example, MIL adjusts the specified spacing for the search boxes (M_TRAINING_BOX_SPACING) to achieve an even distribution of search boxes along the template's path (M_TRAINED_BOX_SPACING). If you do not retrain the templates, the trained value represents the value MIL uses for verification.

function map To inquire about a trained setting of a bead template
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_TRAINED_BOX_HEIGHT +

Inquires the trained height of the search boxes. MIL bases this value on M_TRAINING_BOX_HEIGHT and internally modifies it during the training phase to achieve the best possible trained height.

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

Specifies the trained height of the search boxes.

Click to summarize M_TRAINED_BOX_SPACING +

Inquires the trained distance between the search boxes in which to establish the trained points. MIL bases this value on M_TRAINING_BOX_SPACING and internally modifies it during the training phase to achieve an even distribution of trained search boxes.

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

Specifies the trained distance between the search boxes.

Click to summarize M_TRAINED_BOX_WIDTH +

Inquires the trained width of the search boxes. MIL bases this value on a variety of settings, such as M_TRAINING_BOX_WIDTH, to achieve the best possible trained width.

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

Specifies the trained width of the search boxes.

Click to summarize M_TRAINED_INDIVIDUAL_WIDTH_NOMINAL +

Inquires the trained width of the template at the position of each individual trained point. MIL bases this value on a variety of settings, such as M_WIDTH_..., to achieve the best possible trained widths.

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE
Click to summarize Value

Specifies the trained width for each trained point.

Click to summarize M_TRAINED_POSITION_X +

Inquires the trained X-position of the trained points. MIL bases this value on a variety of settings, such as M_TRAINING_PATH, to achieve the best possible trained positions.

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE
Click to summarize Value > 0

Specifies the trained X-position for each trained point.

Click to summarize M_TRAINED_POSITION_Y +

Inquires the trained Y-position of the trained points. MIL bases this value on a variety of settings, such as M_TRAINING_PATH, to achieve the best possible trained positions.

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE
Click to summarize Value > 0

Specifies the trained Y-position for each trained point.

Click to summarize M_TRAINED_SIZE +

Inquires the number of trained points. MIL considers the number of trained points in a template to be its size.

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

Specifies the number of trained points.

Click to summarize M_TRAINED_WIDTH_NOMINAL +

Inquires the trained nominal width of the template. MIL bases this value on a variety of settings, such as M_WIDTH_NOMINAL_MODE, to achieve the best possible trained nominal width.

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

Specifies the trained nominal width of the bead.

You can add the following value to the above-mentioned values to determine the required array size (number of elements) to store the returned values.

function map For determining the required array size (number of elements) to store the returned values
Click to summarizeInquireType combination value Description
UserVarPtr
- Possible values returned
Click to summarize M_NB_ELEMENTS

Retrieves the required array size (number of elements) to store the returned values.

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

To inquire about a bead template setting for the verification phase, the InquireType parameter can be set to one of the following values. In this case, you must set the ContextOrResultBeadId parameter to the identifier of a bead context, and the LabelOrIndex parameter to a specific template, using either M_TEMPLATE_INDEX() or M_TEMPLATE_LABEL().

function map To inquire about a bead template setting for the verification phase
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_ACCEPTANCE +

Inquires the acceptance level for the score of the template's corresponding measured bead. 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 100.0 %.

Click to summarize 0.0 <= Value <= 100.0

Specifies the acceptance level, as a percentage. INFO

Click to summarize M_ANGLE_ACCURACY_MAX_DEVIATION +

Inquires the maximum angular deviation from the automatically established angle with which to verify the width of the template's measured bead. 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 0.0 <= Value <= 180.0

Specifies the angular deviation, in degrees. INFO

Click to summarize M_BOX_WIDTH_MARGIN +

Inquires the additional width for the search boxes used to verify the template's measured bead. 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 50.0 %.

Click to summarize Value >= 0.0

Specifies the additional width used for verification, as a percentage.

Click to summarize M_FAIL_WARNING_OFFSET +

Inquires the additional width specified for the search box where a measured point can be found, but will have a failed status. 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 Value >= 0.0

Specifies the width, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS.

Click to summarize M_GAP_MAX_LENGTH +

Inquires the maximum allowable length of one single gap, for the template's measured bead to have a passing status. 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 M_DISABLE

Specifies that M_GAP_MAX_LENGTH has no effect.

Click to summarize Value >= 0.0

Specifies the maximum gap length, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS. INFO

Click to summarize M_GAP_TOLERANCE +

Inquires the percentage of the total allowable gaps (all gaps added together), for the template's measured bead to have a passing status. 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 0.0 <= Value <= 100.0

Specifies the total allowable gaps, as a percentage. INFO

Click to summarize M_INTENSITY_DELTA_NEG +

Inquires the lowest pixel intensity that is considered valid for the template's measured bead, relative to M_INTENSITY_NOMINAL. 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 Value

Specifies the lowest valid pixel intensity.

Click to summarize M_INTENSITY_DELTA_POS +

Inquires the highest pixel intensity that is considered valid for the template's measured bead, relative to M_INTENSITY_NOMINAL. 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 Value

Specifies the highest valid pixel intensity.

Click to summarize M_INTENSITY_NOMINAL +

Inquires the nominal pixel intensity of the template's measured bead. 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 Value

Specifies the nominal pixel intensity.

Click to summarize M_OFFSET_MAX +

Inquires the maximum allowable distance between the position of the trained points in the template, and the position of the measured points in the target, for the measured bead to have a passing status. 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 M_OFFSET_MAX has no effect.

Click to summarize Value > 0.0

Specifies the allowable offset, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS.

Click to summarize M_WIDTH_DELTA_NEG +

Inquires the valid delta negative tolerance between the width of the measured bead and the width of the template, for the measured bead to have a passing status. 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 M_WIDTH_DELTA_NEG has no effect.

Click to summarize Value > 0.0

Specifies the tolerance, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS.

Click to summarize M_WIDTH_DELTA_POS +

Inquires the valid delta positive tolerance between the width of the measured bead and the width of the template, for the measured bead to have a passing status. 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 M_WIDTH_DELTA_POS has no effect.

Click to summarize Value > 0.0

Specifies the tolerance, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS.

To inquire about a global bead template setting, the InquireType parameter can be set to one of the following values. In this case, you must set the ContextOrResultBeadId parameter to the identifier of a bead context, and the LabelOrIndex parameter to a specific template, using either M_TEMPLATE_INDEX() or M_TEMPLATE_LABEL(), unless otherwise specified.

function map To inquire about a global setting of a bead template
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_BEAD_TYPE +

Inquires the type of the bead. 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 type. INFO

Click to summarize M_BEAD_EDGE

Specifies a bead template consisting of an edge. INFO

Click to summarize M_BEAD_STRIPE

Specifies a bead template consisting of a stripe. INFO

Click to summarize M_INDEX_VALUE +

Inquires the index associated with the template. In this case, you must set the LabelOrIndex parameter to the label of a template.

(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_INVALID

Specifies that the template label you specified is not valid (not associated with a template).

Click to summarize Value >= 0

Specifies the index value associated with the specified template label.

Click to summarize M_LABEL_VALUE +

Inquires the label that MIL automatically associated with the template when it was added to the context. In this case, you must set the LabelOrIndex parameter to the index of a template.

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

Specifies the label.

To inquire about a global setting of a bead context, the InquireType parameter can be set to one of the following values. In this case, you must set the ContextOrResultBeadId parameter to the identifier of a bead context, and the LabelOrIndex parameter to M_CONTEXT.

function map To inquire about a global setting of a bead context
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_ASSOCIATED_CALIBRATION +

Inquires the camera calibration context associated with the training image. 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_NULL.

Click to summarize M_NULL

Specifies that there is no camera calibration context that has been associated with the training image using M_ASSOCIATED_CALIBRATION.

Click to summarize MIL Calibration context identifier

Specifies the camera calibration context that is associated with the training image.

Click to summarize M_MODIFICATION_COUNT +

Inquires the current value of the modification counter. The modification counter is increased by one each time settings for the context are modified.

Although you cannot identify the modification counter's contents, you can compare them throughout your application to know if the context has been altered. If the modification counter has changed you can, for example, prompt the user to save before closing the application.

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

Specifies the current value of the modification counter.

Click to summarize M_NUMBER_OF_TEMPLATES +

Inquires the number of templates in the bead context. To add and remove templates, use MbeadTemplate().

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

Specifies the number of templates.

Click to summarize M_STATUS +

Inquires the training status of the bead context. MIL establishes the status after the last call to MbeadTrain() (using the most current settings of the bead module).

(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_COMPLETE

Specifies that the context is completely trained. This indicates that each template in the context is trained.

(summarize)
Click to summarize M_NOT_TRAINED

Specifies that the context is not completely trained. This indicates that there are one or more templates in the context that are not trained.

(summarize)
Click to summarize M_PARTIAL

Specifies that the context is partially trained. This indicates that all templates in the context are either partially trained, or both partially and completely trained. M_PARTIAL can also indicate that one or more sections of one or more templates were not found in the training image.

(summarize)
Click to summarize M_TRAINING_IMAGE_SIZE_X +

Inquires the width of the internally saved training image (MbeadTrain() with M_SAVE_TRAINING_IMAGE).

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

Specifies that there is no training image.

Click to summarize Value

Specifies the width of the training image.

Click to summarize M_TRAINING_IMAGE_SIZE_Y +

Inquires the height of the internally saved training image (MbeadTrain() with M_SAVE_TRAINING_IMAGE).

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

Specifies that there is no training image.

Click to summarize Value

Specifies the height of the training image.

Click to summarize M_TRAINING_IMAGE_TYPE +

Inquires the data type and data depth of the internally saved training image (MbeadTrain() with M_SAVE_TRAINING_IMAGE).

(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_NULL

Specifies that there is no training image.

Click to summarize M_UNSIGNED + 8

Specifies that the training image is 8-bit unsigned.

To inquire about a global setting of a bead context or bead result buffer, the InquireType parameter can be set to the following value. When inquiring about a bead context, set the ContextOrResultBeadId parameter to the identifier of a bead context, and the LabelOrIndex parameter to M_CONTEXT. When inquiring about a bead result buffer, set the ContextOrResultBeadId parameter to the identifier of a bead result buffer, and the LabelOrIndex parameter to M_GENERAL.

function map To inquire about a global setting of a bead context or bead result buffer
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_OWNER_SYSTEM +

Inquires the identifier of the system on which either the bead context or bead result buffer has been 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().

To inquire about settings for operations with MbeadGetNeighbors(), the InquireType parameter can be set to the following value. In this case, you must set the ContextOrResultBeadId parameter to the identifier of a bead context, and the LabelOrIndex parameter to M_CONTEXT.

function map To inquire about settings for operations with MbeadGetNeighbors()
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_CLOSEST_POINT_MAX_DISTANCE +

Inquires the maximum distance specified for the M_CLOSEST_... operations in MbeadGetNeighbors(). 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_INFINITE.

Click to summarize M_INFINITE

Specifies that the maximum distance is infinite.

Click to summarize Value > 0.0

Specifies the maximum distance, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS.

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 To inquire about the default value of an inquire type
Click to summarizeInquireType 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

You can add the following value to the above-mentioned values to determine whether an inquire type is supported.

function map To inquire whether an inquire type is supported
Click to summarizeInquireType Description
UserVarPtr
- Possible values returned
Click to summarize M_SUPPORTED

Inquires whether the specified inquire type is supported for the bead context.

(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_NULL

Specifies that the inquire type is not supported.

Click to summarize Value != 0

Specifies that the inquire type is supported.

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

Note: In C++, when using a standard vector (std::vector) instead of an array, the values listed in this combination table must not be used. If you need to use a specific data type, instantiate the vector with the necessary data type.

function map To specify 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  |  array of type MIL_DOUBLE [optionally, in C++: a reference to a std::vector<MIL_DOUBLE> ] MORE
Click to summarize M_TYPE_MIL_ID

Casts the requested information to a MIL_ID. Note that M_TYPE_MIL_ID should only be used with M_OWNER_SYSTEM.

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_ID  |  array of type MIL_ID [optionally, in C++: a reference to a std::vector<MIL_ID> ] MORE
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  |  array of type MIL_INT [optionally, in C++: a reference to a std::vector<MIL_INT> ] MORE
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  |  array of type MIL_INT32 [optionally, in C++: a reference to a std::vector<MIL_INT32> ] MORE
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  |  array of type MIL_INT64 [optionally, in C++: a reference to a std::vector<MIL_INT64> ] MORE
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; milbead.lib.
DLL Requires mil.dll; milbead.dll.
DEFAULT CONTEXT GENERAL INDIVIDUAL WIDTH NOMINAL INTENSITY NOMINAL MODE DEFAULT AUTO DISABLE USER DEFINED POSITION X POSITION Y SIZE TEMPLATE CIRCLE CENTER X DEFAULT TEMPLATE CIRCLE CENTER Y DEFAULT TEMPLATE CIRCLE RADIUS DEFAULT TEMPLATE INPUT UNITS DEFAULT PIXEL WORLD TEMPLATE SEGMENT END X DEFAULT TEMPLATE SEGMENT END Y DEFAULT TEMPLATE SEGMENT START X DEFAULT TEMPLATE SEGMENT START Y DEFAULT TRAINING BOX HEIGHT DEFAULT TRAINING BOX INPUT UNITS DEFAULT PIXEL WORLD TRAINING BOX SPACING DEFAULT DISABLE TRAINING BOX WIDTH DEFAULT TRAINING PATH DEFAULT CIRCLE POLYLINE POLYLINE SEED SEGMENT TRAINING WIDTH NOMINAL DEFAULT DISABLE TRAINING WIDTH SCALE MAX DEFAULT DISABLE TRAINING WIDTH SCALE MIN DEFAULT DISABLE WIDTH NOMINAL DEFAULT WIDTH NOMINAL MODE DEFAULT AUTO CONTINUOUS AUTO UNIFORM USER DEFINED FOREGROUND VALUE DEFAULT FOREGROUND BLACK FOREGROUND WHITE SMOOTHNESS DEFAULT THRESHOLD MODE DEFAULT USER DEFINED THRESHOLD VALUE DEFAULT TRAINED BOX HEIGHT TRAINED BOX SPACING TRAINED BOX WIDTH TRAINED INDIVIDUAL WIDTH NOMINAL TRAINED POSITION X TRAINED POSITION Y TRAINED SIZE TRAINED WIDTH NOMINAL NB ELEMENTS ACCEPTANCE DEFAULT ANGLE ACCURACY MAX DEVIATION DEFAULT BOX WIDTH MARGIN DEFAULT FAIL WARNING OFFSET DEFAULT GAP MAX LENGTH DEFAULT DISABLE GAP TOLERANCE DEFAULT INTENSITY DELTA NEG DEFAULT INTENSITY DELTA POS DEFAULT INTENSITY NOMINAL DEFAULT OFFSET MAX DEFAULT DISABLE WIDTH DELTA NEG DEFAULT DISABLE WIDTH DELTA POS DEFAULT DISABLE BEAD TYPE DEFAULT BEAD EDGE BEAD STRIPE INDEX VALUE INVALID LABEL VALUE ASSOCIATED CALIBRATION DEFAULT NULL MODIFICATION COUNT NUMBER OF TEMPLATES STATUS COMPLETE NOT TRAINED PARTIAL TRAINING IMAGE SIZE X TRAINING IMAGE SIZE Y TRAINING IMAGE TYPE NULL UNSIGNED 8 OWNER SYSTEM DEFAULT HOST CLOSEST POINT MAX DISTANCE DEFAULT INFINITE DEFAULT SUPPORTED NULL TYPE MIL DOUBLE TYPE MIL ID TYPE MIL INT TYPE MIL INT32 TYPE MIL INT64 CONTEXT DEFAULT GENERAL DEFAULT CONTEXT DEFAULT GENERAL