Click here to show toolbars of the Web Online Help System: show toolbars |
MIL_ID ContextOrResultBeadId, | //in |
MIL_INT LabelOrIndex, | //in |
MIL_INT64 InquireType, | //in |
void *UserVarPtr | //out |
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.
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.
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:
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the default. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the index of an existing template about which to inquire. |
||||||||||||||||||||||||||||||||||||||
Parameters | |||||||||||||||||||||||||||||||||||||||
Specifies the index. The index must be greater than or equal to 0. |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Specifies the label of an existing template about which to inquire. |
||||||||||||||||||||||||||||||||||||||
Parameters | |||||||||||||||||||||||||||||||||||||||
Specifies the label. The label must be greater than 0. |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires information about a global setting of a bead context. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires information about a setting of a bead result buffer. |
Specifies the type of setting about which to inquire.
See the Parameter associations section for possible values that can be specified.
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.
The tables below list possible values for the InquireType parameter and possible values returned to the UserVarPtr parameter.
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().
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the specified width of the template at the position of each of its vertices. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: array of type MIL_DOUBLE
(more
details...)
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the width. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires how to establish the nominal pixel intensity of the template. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Same as M_DISABLE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies to establish the nominal pixel intensity from the training image. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that M_INTENSITY_NOMINAL_MODE has no effect. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that you will explicitly set the pixel intensity, using M_INTENSITY_NOMINAL. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the X-coordinates of the vertices in a template whose path follows a polyline. SET SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: array of type MIL_DOUBLE
(more
details...)
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the X-coordinates of the template's vertices. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the Y-coordinates of the vertices in a template whose path follows a polyline. SET SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: array of type MIL_DOUBLE
(more
details...)
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the Y-coordinates of the template's vertices. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the number of vertices in a template whose path follows a polyline. SET SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the number of points. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the X-coordinate of the center of a template whose path follows a circle. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 0.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the center's X-coordinate, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the Y-coordinate of the center of a template whose path follows a circle. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 0.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the center's Y-coordinate, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the radius of a template whose path follows a circle. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 0.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the radius, relative to the input coordinate system specified using 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(). SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Same as M_PIXEL. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies to interpret the values in pixel units, with respect to the pixel coordinate system. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies to interpret the values in world units, with respect to the relative coordinate system. INFO |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the X-coordinate of the end of a template whose path follows a segment. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 0.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the X-coordinate of the end of the segment, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the Y-coordinate of the end of a template whose path follows a segment. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 0.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the Y-coordinate of the end of the segment, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the X-coordinate of the start of a template whose path follows a segment. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info: Data
type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 0.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the X-coordinate of the start of the segment, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the Y-coordinate of the start of a template whose path follows a segment. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 0.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the Y-coordinate of the start of the segment, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the height of the search boxes. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 10.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the height, relative to the input coordinate system specified using 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 |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Same as M_PIXEL. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies to interpret the values in pixel units, with respect to the pixel coordinate system. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies to interpret the values in world units, with respect to the relative coordinate system. INFO |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the distance between the search boxes. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 10.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that M_TRAINING_BOX_SPACING has no effect. INFO |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the spacing, relative to the input coordinate system specified using M_TRAINING_BOX_INPUT_UNITS. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the width of the search boxes. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 200.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the width, relative to the input coordinate system specified using M_TRAINING_BOX_INPUT_UNITS. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires how MIL establishes the path of the bead template. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Same as M_POLYLINE_SEED. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
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 |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the path of the bead template follows a fixed polyline. INFO |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the path of the bead template follows a polyline that is refined by the training image set with MbeadTrain(). INFO |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
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 |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the width with which to validate the template's automatically established nominal width. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Same as M_DISABLE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that M_TRAINING_WIDTH_NOMINAL has no effect. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the width, relative to the input coordinate system specified using M_TRAINING_BOX_INPUT_UNITS. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the scale factor by which to determine the upper limit (maximum permitted scale) of the bead width. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 1.2. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that M_TRAINING_WIDTH_SCALE_MAX has no effect. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the maximum scale factor. INFO |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the scale factor by which to determine the lower limit (minimum permitted scale) of the bead width. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 0.8. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that M_TRAINING_WIDTH_SCALE_MIN has no effect. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the minimum scale factor. INFO |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the nominal width to use, when it is explicitly defined. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 10.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the nominal width, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires how to establish the nominal width of the bead template. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Same as M_AUTO_UNIFORM. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
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 |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
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 |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
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().
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires whether the foreground of the measured bead should be darker or lighter than the background. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Same as M_FOREGROUND_WHITE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the foreground is darker than the background. INFO |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the foreground is lighter than the background. INFO |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the degree of noise reduction that MIL uses when performing the edge extraction of the bead from an image. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 50.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the smoothness value. INFO |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires how to establish the threshold that MIL must use when performing the edge extraction of the bead from an image. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Same as M_USER_DEFINED. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the threshold is explicitly defined with M_THRESHOLD_VALUE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the value beneath which a grayscale variation within the image is not considered an edge of the bead. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 10.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.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the trained height of the search boxes. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the trained height of the search boxes. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the trained distance between the search boxes in which to establish the trained points. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the trained distance between the search boxes. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the trained width of the search boxes. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the trained width of the search boxes. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the trained width of the template at the position of each individual trained point. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: array of type
MIL_DOUBLE (more
details...)
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the trained width for each trained point. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the trained X-position of the trained points. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: array of type
MIL_DOUBLE (more
details...)
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the trained X-position for each trained point. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the trained Y-position of the trained points. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: array of type
MIL_DOUBLE (more
details...)
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the trained Y-position for each trained point. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the number of trained points. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the number of trained points. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the trained nominal width of the template. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the trained nominal width of the bead. |
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().
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the acceptance level for the score of the template's corresponding measured bead. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 100.0 %. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the acceptance level, as a percentage. INFO |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the maximum angular deviation from the automatically established angle with which to verify the width of the template's measured bead. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 0.0 °. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the angular deviation, in degrees. INFO |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the additional width for the search boxes used to verify the template's measured bead. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 50.0 %. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the additional width used for verification, as a percentage. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the additional width specified for the search box where a measured point can be found, but will have a failed status. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 0.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the width, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the maximum allowable length of one single gap, for the template's measured bead to have a passing status. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 0.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that M_GAP_MAX_LENGTH has no effect. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the maximum gap length, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS. INFO |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the percentage of the total allowable gaps (all gaps added together), for the template's measured bead to have a passing status. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 0.0 %. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the total allowable gaps, as a percentage. INFO |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the lowest pixel intensity that is considered valid for the template's measured bead, relative to M_INTENSITY_NOMINAL. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 0.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the lowest valid pixel intensity. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the highest pixel intensity that is considered valid for the template's measured bead, relative to M_INTENSITY_NOMINAL. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 0.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the highest valid pixel intensity. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the nominal pixel intensity of the template's measured bead. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default value; the default value is 0.0. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the nominal pixel intensity. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
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 |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Same as M_DISABLE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that M_OFFSET_MAX has no effect. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the allowable offset, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
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 |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Same as M_DISABLE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that M_WIDTH_DELTA_NEG has no effect. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the tolerance, relative to the input coordinate system specified using M_TEMPLATE_INPUT_UNITS. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
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 |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Same as M_DISABLE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that M_WIDTH_DELTA_POS has no effect. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
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.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the type of the bead. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default type. INFO |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies a bead template consisting of an edge. INFO |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies a bead template consisting of a stripe. INFO |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the index associated with the template. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the template label you specified is not valid (not associated with a template). |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the index value associated with the specified template label. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the label that MIL automatically associated with the template when it was added to the context. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
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.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the camera calibration context associated with the training image. SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Same as M_NULL. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that there is no camera calibration context that has been associated with the training image using M_ASSOCIATED_CALIBRATION. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the camera calibration context that is associated with the training image. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the current value of the modification counter. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the current value of the modification counter. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the number of templates in the bead context. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the number of templates. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the training status of the bead context. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the context is completely trained. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the context is not completely trained. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the context is partially trained. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the width of the internally saved training image (MbeadTrain() with M_SAVE_TRAINING_IMAGE). |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that there is no training image. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the width of the training image. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the height of the internally saved training image (MbeadTrain() with M_SAVE_TRAINING_IMAGE). |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that there is no training image. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the height of the training image. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the data type and data depth of the internally saved training image (MbeadTrain() with M_SAVE_TRAINING_IMAGE). |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that there is no training image. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
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.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the identifier of the system on which either the bead context or bead result buffer has been allocated. SET SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies the default Host system of the current MIL application. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
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.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the maximum distance specified for the M_CLOSEST_... operations in MbeadGetNeighbors(). SET |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Same as M_INFINITE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the maximum distance is infinite. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
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.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires the default value of the specified inquire type. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
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.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Inquires whether the specified inquire type is supported for the bead context. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
Specifies that the inquire type is not supported. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() ![]() |
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.
![]() |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Description | ||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Casts the requested information to a MIL_DOUBLE. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_DOUBLE | array of type
MIL_DOUBLE (more
details...)
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Casts the requested information to a MIL_ID. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_ID | array of type MIL_ID
(more
details...)
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Casts the requested information to a MIL_INT. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_INT | array of type
MIL_INT (more
details...)
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Casts the requested information to a MIL_INT32. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_INT32 | array of type
MIL_INT32 (more
details...)
|
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Casts the requested information to a MIL_INT64. |
||||||||||||||||||||||||||||||||||||||
![]() ![]() |
Data type info:
Data type: address of a
MIL_INT64 | array of type
MIL_INT64 (more
details...)
|
Header | Include mil.h. |
Library | Use mil.lib; milbead.lib. |
DLL | Requires mil.dll; milbead.dll. |