MIL_ID ContextOrResultId, | //in |
MIL_INT Index, | //in |
MIL_INT64 InquireType, | //in |
void *UserVarPtr | //out |
This function inquires information about a specified Model Finder context, the models contained therein, or a specified Model Finder result buffer. Note that Model Finder result buffer values can be obtained with MmodGetResult().
If the inquired control value setting is set to M_DEFAULT, MmodInquire() will return M_DEFAULT. To inquire its default value, add M_DEFAULT to the inquire type.
Specifies the Model Finder context or Model Finder result buffer about which to inquire information. The Model Finder context or result buffer must have been previously allocated on the required system using MmodAlloc() or MmodAllocResult(), respectively.
Specifies that information will be inquired about the Model Finder context, an individual model, or a Model Finder result buffer. This parameter should be set to one of the following values:
For specifying a context, model, or
result buffer
|
|||||||||||||||||||||||||||||||||||||||
Value | Description
|
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_CONTEXT |
Inquires information about a Model Finder context, if one is specified. |
||||||||||||||||||||||||||||||||||||||
M_GENERAL |
Inquires general information about the Model Finder result buffer, if one is specified. |
||||||||||||||||||||||||||||||||||||||
Value |
Inquires information about a model, if a Model Finder context is specified. (more details...) |
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 MmodInquire() 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.
For M_CONTEXT or individual model inquiries, the InquireType parameter can be set to one of the following:
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.
For returning the number of models to
find
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_NUMBER + |
Inquires the number of models for which to search. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value. INFO |
||||||||||||||||||||||||||||||||||||||
M_ALL |
Specifies to find all occurrences. INFO |
||||||||||||||||||||||||||||||||||||||
Value > 0 |
Specifies the number of occurrences. INFO |
To inquire about the system on which the Model Finder context or result buffer has been allocated, set the InquireType parameter to the value below.
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.
For inquiring about the
system
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_OWNER_SYSTEM + |
Inquires the identifier of the system on which the Model Finder context or result buffer was allocated. SET SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT_HOST |
Specifies the default Host system of the current MIL application. |
||||||||||||||||||||||||||||||||||||||
MIL system identifier |
Specifies a valid system identifier, previously allocated using MsysAlloc(). |
For M_CONTEXT, the InquireType parameter can be set to one of the following:
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.
For M_CONTEXT
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_ACCURACY + |
Inquires the search accuracy. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_MEDIUM. |
||||||||||||||||||||||||||||||||||||||
M_HIGH |
Specifies high accuracy. |
||||||||||||||||||||||||||||||||||||||
M_LOW |
Specifies low accuracy. |
||||||||||||||||||||||||||||||||||||||
M_MEDIUM |
Specifies medium accuracy. |
||||||||||||||||||||||||||||||||||||||
M_ACTIVE_EDGELS + |
Inquires the degree to which MIL processes active edgels in the target. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 100.0%. |
||||||||||||||||||||||||||||||||||||||
0.0 <= Value <= 100.0 |
Specifies the degree to which MIL processes target edgels, in percent. INFO |
||||||||||||||||||||||||||||||||||||||
M_ASPECT_RATIO + |
Inquires the nominal search aspect ratio. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 1.0. |
||||||||||||||||||||||||||||||||||||||
0.5 <= Value <= 2.0 |
Specifies the pixel width/pixel height of the target. |
||||||||||||||||||||||||||||||||||||||
M_CONTEXT_TYPE + |
Inquires the type of search context allocated. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_GEOMETRIC |
Specifies that the Model Finder context uses a general geometric search algorithm. INFO |
||||||||||||||||||||||||||||||||||||||
M_GEOMETRIC_CONTROLLED |
Specifies that the Model Finder context uses a controlled geometric search algorithm. INFO |
||||||||||||||||||||||||||||||||||||||
M_SHAPE_CIRCLE |
Specifies that the Model Finder context uses a circular model search algorithm. INFO |
||||||||||||||||||||||||||||||||||||||
M_DETAIL_LEVEL + |
Inquires the level of details to extract from the model source and target image. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_MEDIUM. |
||||||||||||||||||||||||||||||||||||||
M_HIGH |
Specifies a high level of detail. |
||||||||||||||||||||||||||||||||||||||
M_MEDIUM |
Specifies a medium level of detail. |
||||||||||||||||||||||||||||||||||||||
M_VERY_HIGH |
Specifies a very high level of detail. |
||||||||||||||||||||||||||||||||||||||
M_FIRST_LEVEL + |
Inquires the resolution level for the initial stage of the search. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_AUTO. |
||||||||||||||||||||||||||||||||||||||
M_AUTO |
Specifies that the first resolution is determined automatically. |
||||||||||||||||||||||||||||||||||||||
0 <= Value <= 7 |
Specifies the resolution level. INFO |
||||||||||||||||||||||||||||||||||||||
M_LAST_LEVEL + |
Inquires the resolution level for the final stage of the search. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_AUTO. |
||||||||||||||||||||||||||||||||||||||
M_AUTO |
Specifies that the last resolution is determined automatically. |
||||||||||||||||||||||||||||||||||||||
0 <= Value <= 7 |
Specifies the resolution level. INFO |
||||||||||||||||||||||||||||||||||||||
M_MODIFICATION_COUNT + |
Inquires the current value of the modification counter. (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the current value of the modification counter. |
||||||||||||||||||||||||||||||||||||||
M_NUMBER_MODELS + |
Inquires the number of models in the context. (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the number of models. |
||||||||||||||||||||||||||||||||||||||
M_PREPROCESSED + |
Inquires whether the Model Finder context is preprocessed. (more details...) |
||||||||||||||||||||||||||||||||||||||
0 |
Specifies that the context is not preprocessed. |
||||||||||||||||||||||||||||||||||||||
Value!= 0 |
Specifies that the context is preprocessed. |
||||||||||||||||||||||||||||||||||||||
M_SAVE_TARGET_EDGES + |
Inquires whether the target edges in the result will be saved. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_DISABLE. |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies that target edges cannot be saved. |
||||||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies that target edges can be saved. INFO |
||||||||||||||||||||||||||||||||||||||
M_SEARCH_ANGLE_RANGE + |
Inquires whether to perform calculations specific to angular-range search strategies. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value. INFO |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies that calculations specific to angular-range search strategies are disabled. |
||||||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies that calculations specific to angular-range search strategies are enabled. |
||||||||||||||||||||||||||||||||||||||
M_SEARCH_POSITION_RANGE + |
Inquires whether to perform calculations specific to position-range search strategies. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_ENABLE. |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies that calculations specific to position-range search strategies are disabled. |
||||||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies that calculations specific to position-range search strategies are enabled. |
||||||||||||||||||||||||||||||||||||||
M_SEARCH_SCALE_RANGE + |
Inquires whether to perform calculations specific to scale-range search strategies. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_DISABLE. |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies that calculations specific to scale-range search strategies are disabled. |
||||||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies that calculations specific to scale-range search strategies are enabled. INFO |
||||||||||||||||||||||||||||||||||||||
M_SHARED_EDGES + |
Inquires whether multiple occurrences can share edges. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_DISABLE. |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies to disable the sharing of edges. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies to enable the sharing of edges. |
||||||||||||||||||||||||||||||||||||||
M_SMOOTHNESS + |
Inquires the degree of smoothness (denoising) applied to the model images and the target images during edge extraction. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 50.0. |
||||||||||||||||||||||||||||||||||||||
0.0 <= Value <= 100.0 |
Specifies the smoothness value applied to the images. INFO |
||||||||||||||||||||||||||||||||||||||
M_SPEED + |
Inquires the search speed. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_MEDIUM. |
||||||||||||||||||||||||||||||||||||||
M_HIGH |
Specifies a high speed. |
||||||||||||||||||||||||||||||||||||||
M_LOW |
Specifies a low speed. |
||||||||||||||||||||||||||||||||||||||
M_MEDIUM |
Specifies a medium speed. |
||||||||||||||||||||||||||||||||||||||
M_VERY_HIGH |
Specifies a very high speed. |
||||||||||||||||||||||||||||||||||||||
M_TARGET_CACHING + |
Inquires whether target caching is enabled. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_DISABLE. |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies to disable target caching. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies to enable target caching in the result. |
||||||||||||||||||||||||||||||||||||||
M_TIMEOUT + |
Inquires the maximum search time for MmodFind(), in msec. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 2000.0msec. |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies an infinite amount of search time. |
||||||||||||||||||||||||||||||||||||||
Value >= 0 |
Specifies the maximum search time, in msecs. |
For individual model inquiries, the InquireType parameter can be set to one of the following:
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.
For models
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_ACCEPTANCE + |
Inquires the acceptance level for the score. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 60.0%. |
||||||||||||||||||||||||||||||||||||||
0.0 <= Value <= 100.0 |
Specifies an acceptable score, in percent. INFO |
||||||||||||||||||||||||||||||||||||||
M_ACCEPTANCE_TARGET + |
Inquires the acceptance level for the target score. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 0.0%. |
||||||||||||||||||||||||||||||||||||||
0.0 <= Value <= 100.0 |
Specifies an acceptable target score, in percent. INFO |
||||||||||||||||||||||||||||||||||||||
M_ALLOC_OFFSET_X + |
Inquires the X-offset of the model in the model source image. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the X-offset of the model, in pixels. |
||||||||||||||||||||||||||||||||||||||
M_ALLOC_OFFSET_Y + |
Inquires the Y-offset of the model in the model source image. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the Y-offset of the model, in pixels. |
||||||||||||||||||||||||||||||||||||||
M_ALLOC_SIGN + |
Inquires whether the data range of the model image is signed or unsigned. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_SIGNED |
Specifies that the data is signed. |
||||||||||||||||||||||||||||||||||||||
M_UNSIGNED |
Specifies that the data is unsigned. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_ALLOC_SIZE_BAND + |
Inquires the number of bands of the model image. (more details...) |
||||||||||||||||||||||||||||||||||||||
1 |
Specifies a 1-band buffer. |
||||||||||||||||||||||||||||||||||||||
3 |
Specifies a 3-band buffer. |
||||||||||||||||||||||||||||||||||||||
M_ALLOC_SIZE_BIT + |
Inquires the depth per band, in bits, of the model image. (more details...) |
||||||||||||||||||||||||||||||||||||||
1 |
Specifies that the data depth is 1 bit per band. |
||||||||||||||||||||||||||||||||||||||
8 |
Specifies that the data depth is 8 bits per band. |
||||||||||||||||||||||||||||||||||||||
16 |
Specifies that the data depth is 16 bits per band. |
||||||||||||||||||||||||||||||||||||||
32 |
Specifies that the data depth is 32 bits per band. |
||||||||||||||||||||||||||||||||||||||
M_ALLOC_SIZE_X + |
Inquires the width of the model box. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
16.0 <= Value <= 1024.0 |
Specifies the width of the model (in X), in pixels. |
||||||||||||||||||||||||||||||||||||||
M_ALLOC_SIZE_Y + |
Inquires the height of the model box. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
16.0 <= Value <= 1024.0 |
Specifies the height of the model (in Y), in pixels. |
||||||||||||||||||||||||||||||||||||||
M_ALLOC_TYPE + |
Inquires the data type and depth of the model image. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_FLOAT + 32 |
Specifies 32-bit floating-point data. |
||||||||||||||||||||||||||||||||||||||
M_SIGNED + 8 |
Specifies 8-bit signed data. |
||||||||||||||||||||||||||||||||||||||
M_SIGNED + 16 |
Specifies 16-bit signed data. |
||||||||||||||||||||||||||||||||||||||
M_SIGNED + 32 |
Specifies 32-bit signed data. |
||||||||||||||||||||||||||||||||||||||
M_UNSIGNED + 1 |
Specifies 1-bit unsigned data. |
||||||||||||||||||||||||||||||||||||||
M_UNSIGNED + 8 |
Specifies 8-bit unsigned data. |
||||||||||||||||||||||||||||||||||||||
M_UNSIGNED + 16 |
Specifies 16-bit unsigned data. |
||||||||||||||||||||||||||||||||||||||
M_UNSIGNED + 32 |
Specifies 32-bit unsigned data. |
||||||||||||||||||||||||||||||||||||||
M_ANGLE + |
Inquires the nominal search angle, relative to the model reference axis angle. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 0.0°. |
||||||||||||||||||||||||||||||||||||||
0.0 <= Value <= 360.0 |
Specifies the nominal search angle, in degrees. INFO |
||||||||||||||||||||||||||||||||||||||
M_ANGLE_DELTA_NEG + |
Inquires the lower limit of the angular range, relative to the nominal search angle. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 180.0°. |
||||||||||||||||||||||||||||||||||||||
0.0 <= Value <= 180.0 |
Specifies the lower limit of the angular range, in degrees. INFO |
||||||||||||||||||||||||||||||||||||||
M_ANGLE_DELTA_POS + |
Inquires the upper limit of the angular range, relative to the nominal search angle. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 180.0°. |
||||||||||||||||||||||||||||||||||||||
0.0 <= Value <= 180.0 |
Specifies the upper limit of the angular range, in degrees. INFO |
||||||||||||||||||||||||||||||||||||||
M_ASSOCIATED_CALIBRATION + |
Inquires the calibration context associated with the specified model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_NULL |
Specifies that there is no calibration context associated with the model. |
||||||||||||||||||||||||||||||||||||||
MIL Calibration context identifier |
Specifies the calibration context that is associated with the model. |
||||||||||||||||||||||||||||||||||||||
M_BOX_MARGIN_BOTTOM + |
Inquires the margin at the bottom of the bounding box of the model's active edges, in the user-defined units for the model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 10.0% of the height of the bounding box of the model's active edges. |
||||||||||||||||||||||||||||||||||||||
Value >= 0.0 |
Specifies the margin, in the user-defined units for the model. |
||||||||||||||||||||||||||||||||||||||
M_BOX_MARGIN_LEFT + |
Inquires the margin at the left of the bounding box of the model's active edges, in the user-defined units for the model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 10.0% of the width of the bounding box of the model's active edges. |
||||||||||||||||||||||||||||||||||||||
Value >= 0.0 |
Specifies the margin, in the user-defined units for the model. |
||||||||||||||||||||||||||||||||||||||
M_BOX_MARGIN_RIGHT + |
Inquires the margin at the right of the bounding box of the model's active edges, in the user-defined units for the model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 10.0% of the width of the bounding box of the model's active edges. |
||||||||||||||||||||||||||||||||||||||
Value >= 0.0 |
Specifies the margin, in the user-defined units for the model. |
||||||||||||||||||||||||||||||||||||||
M_BOX_MARGIN_TOP + |
Inquires the margin at the top of the bounding box of the model's active edges, in the user-defined units for the model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 10.0% of the height of the bounding box of the model's active edges. |
||||||||||||||||||||||||||||||||||||||
Value >= 0.0 |
Specifies the margin, in the user-defined units for the model. |
||||||||||||||||||||||||||||||||||||||
M_BOX_OFFSET_X + |
Inquires the X-offset of the top-left corner of the model box from the model origin. (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the X-offset, in the user-defined units for the model. |
||||||||||||||||||||||||||||||||||||||
M_BOX_OFFSET_Y + |
Inquires the Y-offset of the top-left corner of the model box from the model origin. (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the Y-offset, in the user-defined units for the model. |
||||||||||||||||||||||||||||||||||||||
M_BOX_SIZE_X + |
Inquires the size along the X-axis of the model box. (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the X-size, in the user-defined units for the model. |
||||||||||||||||||||||||||||||||||||||
M_BOX_SIZE_Y + |
Inquires the size along the Y-axis of the model box. (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the Y-size, in the user-defined units for the model. |
||||||||||||||||||||||||||||||||||||||
M_CAD_Y_AXIS + |
Inquires the direction of the Y-axis for a CAD-type model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value. INFO |
||||||||||||||||||||||||||||||||||||||
M_FLIP |
Specifies to flip the Y-axis for the model so that the Y-axis is positive going down. |
||||||||||||||||||||||||||||||||||||||
M_NO_FLIP |
Specifies not to flip the Y-axis for the model. |
||||||||||||||||||||||||||||||||||||||
M_CERTAINTY + |
Inquires the certainty level for the score. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 90.0%. |
||||||||||||||||||||||||||||||||||||||
0.0 <= Value <= 100.0 |
Specifies the certainty level for the score, in percent. INFO |
||||||||||||||||||||||||||||||||||||||
M_CERTAINTY_TARGET + |
Inquires the certainty level for the target score. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 0.0%. |
||||||||||||||||||||||||||||||||||||||
0.0 <= Value <= 100.0 |
Specifies the certainty level for the target score, in percent. INFO |
||||||||||||||||||||||||||||||||||||||
M_CHAIN_ANGLE + |
Inquires the angle value of each edgel in the chains composing the model's active edges. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: array of type MIL_DOUBLE |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the angle value of the edgel. |
||||||||||||||||||||||||||||||||||||||
M_CHAIN_INDEX + |
Inquires the indices which differentiate each active edge's chain of edgels, for each edgel within the model. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: array of type MIL_INT |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the index of the chain. |
||||||||||||||||||||||||||||||||||||||
M_CHAIN_X + |
Inquires the X-coordinates, in pixels (with subpixel accuracy), of each edgel in the chains composing the model's active edges. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: array of type MIL_DOUBLE |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the X-coordinate of the edgel. |
||||||||||||||||||||||||||||||||||||||
M_CHAIN_Y + |
Inquires the Y-coordinates, in pixels (with subpixel accuracy), of each edgel in the chains composing the model's active edges. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: array of type MIL_DOUBLE |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the Y-coordinate of the edgel. |
||||||||||||||||||||||||||||||||||||||
M_CORNER_RADIUS + |
Inquires the radius used to round corners of the model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 0.0. |
||||||||||||||||||||||||||||||||||||||
Value >= 0.0 |
Specifies the radius, in the user-defined units for the model. INFO |
||||||||||||||||||||||||||||||||||||||
M_FIT_ERROR_WEIGHTING_FACTOR + |
Inquires the contribution of the fit error in the score and target score calculation. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value. INFO |
||||||||||||||||||||||||||||||||||||||
0.0 <= Value <= 100.0 |
Specifies the fit error weighting factor, in percent. INFO |
||||||||||||||||||||||||||||||||||||||
M_FOREGROUND_VALUE + |
Inquires the foreground value of the model. SET SET SET SET SET SET SET SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value. INFO |
||||||||||||||||||||||||||||||||||||||
M_ANY |
Specifies that the model has no specific polarity. INFO |
||||||||||||||||||||||||||||||||||||||
M_FOREGROUND_BLACK |
Specifies that black is the foreground color of the model. |
||||||||||||||||||||||||||||||||||||||
M_FOREGROUND_WHITE |
Specifies that white is the foreground color of the model. |
||||||||||||||||||||||||||||||||||||||
M_HEIGHT + |
Inquires the height of the shape in the model. SET SET SET SET SET (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the height of the shape, in the user-defined units for the model. |
||||||||||||||||||||||||||||||||||||||
M_HORIZONTAL_THICKNESS + |
Inquires the horizontal thickness of the cross in the model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the horizontal thickness of the cross, in the user-defined units for the model. |
||||||||||||||||||||||||||||||||||||||
M_INNER_RADIUS + |
Inquires the inner radius of the ring in the model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the inner radius of the ring, in the user-defined units for the model. |
||||||||||||||||||||||||||||||||||||||
M_MIN_SEPARATION_ANGLE + |
Inquires the minimum angular separation required for two occurrences to be considered distinct matches. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 10.0degrees. |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Disables the minimum angle separation criteria. INFO |
||||||||||||||||||||||||||||||||||||||
0.0 < Value <= 180.0 |
Specifies the minimum angular separation required, in degrees. INFO |
||||||||||||||||||||||||||||||||||||||
M_MIN_SEPARATION_SCALE + |
Inquires the minimum separation required in scale for two occurrences to be considered distinct matches. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 1.1. |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies to disable the minimum scale separation criteria. INFO |
||||||||||||||||||||||||||||||||||||||
1.0 < Value <= 4.0 |
Specifies the criteria for minimum separation in scale. |
||||||||||||||||||||||||||||||||||||||
M_MIN_SEPARATION_X + |
Inquires the minimum separation required along the X-axis for two occurrences to be considered distinct matches. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 10.0%. |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies to disable the minimum separation in X criteria. INFO |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the minimum separation as a percentage of the model's width at M_SCALE. INFO |
||||||||||||||||||||||||||||||||||||||
M_MIN_SEPARATION_Y + |
Inquires the minimum separation required along the Y-axis for two occurrences to be considered distinct matches. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 10.0%. |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies to disable the minimum separation in Y criteria. INFO |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the minimum separation as a percentage of the model's height at M_SCALE. INFO |
||||||||||||||||||||||||||||||||||||||
M_MODEL_TYPE + |
Inquires the type of model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_AUTO_DEFINE |
Specifies a unique model whose features are extracted from an automatically selected region of the model source image. INFO |
||||||||||||||||||||||||||||||||||||||
M_CIRCLE |
Specifies a predefined circle as the model. INFO |
||||||||||||||||||||||||||||||||||||||
M_CROSS |
Specifies a predefined cross as the model. INFO |
||||||||||||||||||||||||||||||||||||||
M_DIAMOND |
Specifies a predefined diamond as the model. INFO |
||||||||||||||||||||||||||||||||||||||
M_DXF_FILE |
Specifies a model defined from the entities in the specified CAD DXF file. INFO |
||||||||||||||||||||||||||||||||||||||
M_EDGE_RESULT |
Specifies a model defined from the results of an edge extraction performed using Edge Finder. INFO |
||||||||||||||||||||||||||||||||||||||
M_ELLIPSE |
Specifies a predefined ellipse as the model. INFO |
||||||||||||||||||||||||||||||||||||||
M_IMAGE |
Specifies a model defined from the specified model source image. INFO |
||||||||||||||||||||||||||||||||||||||
M_MERGE_MODEL |
Specifies a model defined from two other models. INFO |
||||||||||||||||||||||||||||||||||||||
M_MOD_RESULT |
Specifies a model defined from a Model Finder result buffer. INFO |
||||||||||||||||||||||||||||||||||||||
M_RECTANGLE |
Specifies a predefined rectangle as the model. INFO |
||||||||||||||||||||||||||||||||||||||
M_RING |
Specifies a predefined ring as the model. INFO |
||||||||||||||||||||||||||||||||||||||
M_SQUARE |
Specifies a predefined square as the model. INFO |
||||||||||||||||||||||||||||||||||||||
M_TRIANGLE |
Specifies a predefined triangle as the model. INFO |
||||||||||||||||||||||||||||||||||||||
M_NUMBER_OF_CHAINED_EDGELS + |
Inquires the total number of chained edgels in the active edges of the model. (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the number of chained edgels. |
||||||||||||||||||||||||||||||||||||||
M_ORIGINAL_X + |
Inquires the X-coordinate of the model's reference axis origin, relative to the top-left corner of the model source image. (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the X-coordinate of the model's reference axis origin. |
||||||||||||||||||||||||||||||||||||||
M_ORIGINAL_Y + |
Inquires the Y-coordinate of the model's reference axis origin, relative to the top-left corner of the model source image This is only valid for image-type and Edge Finder-type models. (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the Y-coordinate of the model's reference axis origin. |
||||||||||||||||||||||||||||||||||||||
M_OUTER_RADIUS + |
Inquires the outer radius of the ring in the model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the outer radius of the ring, in the user-defined units for the model. |
||||||||||||||||||||||||||||||||||||||
M_PIXEL_SCALE + |
Inquires the pixel scale of the model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value of the pixel scale. INFO |
||||||||||||||||||||||||||||||||||||||
Value > 0.0 |
Specifies the pixel scale. INFO |
||||||||||||||||||||||||||||||||||||||
M_POLARITY + |
Inquires the expected polarity of occurrences relative to the model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value. INFO |
||||||||||||||||||||||||||||||||||||||
M_ANY |
Specifies that the occurrences can be a mixture of polarities. |
||||||||||||||||||||||||||||||||||||||
M_REVERSE |
Specifies that the polarity of occurrences is the reverse of that of the model. |
||||||||||||||||||||||||||||||||||||||
M_SAME |
Specifies that the polarity of occurrences is the same as that of the model. |
||||||||||||||||||||||||||||||||||||||
M_SAME_OR_REVERSE |
Specifies that the polarity of occurrences can be either the same or the reverse of that of the model. |
||||||||||||||||||||||||||||||||||||||
M_POSITION_DELTA_NEG_X + |
Inquires the position range, in the negative X-direction relative to the nominal search position. SET SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 0.0. |
||||||||||||||||||||||||||||||||||||||
M_INFINITE |
Specifies the position range as the entire image plane in the negative X-direction. INFO |
||||||||||||||||||||||||||||||||||||||
Value >= 0.0 |
Specifies the position range's negative X-offset, in pixels, and can be specified with subpixel accuracy; for an M_SHAPE_CIRCLE type of Model Finder context, the value is specified relative to the target's coordinate system. |
||||||||||||||||||||||||||||||||||||||
M_POSITION_DELTA_NEG_Y + |
Inquires the position range, in the negative Y-direction relative to the nominal search position. SET SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 0.0. |
||||||||||||||||||||||||||||||||||||||
M_INFINITE |
Specifies the position range as the entire image plane in the negative Y-direction. INFO |
||||||||||||||||||||||||||||||||||||||
Value >= 0.0 |
Specifies the position range's negative Y-offset, in pixels, and can be specified with subpixel accuracy; for an M_SHAPE_CIRCLE type of Model Finder context, the value is specified relative to the target's coordinate system. |
||||||||||||||||||||||||||||||||||||||
M_POSITION_DELTA_POS_X + |
Inquires the position range, in the positive X-direction relative to the nominal search position. SET SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_INFINITE. |
||||||||||||||||||||||||||||||||||||||
M_INFINITE |
Specifies the position range as the entire image plane in the positive X-direction. INFO |
||||||||||||||||||||||||||||||||||||||
Value >= 0.0 |
Specifies the position range's positive X-offset, in pixels, and can be specified with subpixel accuracy; for an M_SHAPE_CIRCLE type of Model Finder context, the value is specified relative to the target's coordinate system. |
||||||||||||||||||||||||||||||||||||||
M_POSITION_DELTA_POS_Y + |
Inquires the position range, in the positive Y-direction relative to the nominal search position. SET SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_INFINITE. |
||||||||||||||||||||||||||||||||||||||
M_INFINITE |
Specifies the position range as the entire image plane in the positive Y-direction. INFO |
||||||||||||||||||||||||||||||||||||||
Value >= 0.0 |
Specifies the position range's positive Y-offset, in pixels, and can be specified with subpixel accuracy; for an M_SHAPE_CIRCLE type of Model Finder context, the value is specified relative to the target's coordinate system. |
||||||||||||||||||||||||||||||||||||||
M_POSITION_X + |
Inquires the nominal search position for the X-coordinate. SET SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_ALL. |
||||||||||||||||||||||||||||||||||||||
M_ALL |
Specifies all X-coordinates. |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the nominal search position, in pixels, and can be specified with subpixel accuracy; for an M_SHAPE_CIRCLE type of Model Finder context, the value is specified relative to the target's coordinate system. |
||||||||||||||||||||||||||||||||||||||
M_POSITION_Y + |
Inquires the nominal search position for the Y-coordinate. SET SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_ALL. |
||||||||||||||||||||||||||||||||||||||
M_ALL |
Specifies all Y-coordinates. |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the nominal search position, in pixels, and can be specified with subpixel accuracy; for an M_SHAPE_CIRCLE type of Model Finder context, the value is specified relative to the target's coordinate system. |
||||||||||||||||||||||||||||||||||||||
M_RADIUS + |
Inquires the radius of the circle in the model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the radius of the circle, in the user-defined units for the model. |
||||||||||||||||||||||||||||||||||||||
M_REFERENCE_ANGLE + |
Inquires the reference axis angle of the model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 0.0degrees. |
||||||||||||||||||||||||||||||||||||||
0.0 <= Value <= 360.0 |
Specifies the angle, in degrees. INFO |
||||||||||||||||||||||||||||||||||||||
M_REFERENCE_X + |
Inquires the X-coordinate, in pixels, of the reference axis origin of the model, relative to the model origin. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies that the default X-offset will be used. INFO |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the X-offset value. INFO |
||||||||||||||||||||||||||||||||||||||
M_REFERENCE_Y + |
Inquires the Y-coordinate, in pixels, of the reference axis origin of the model, relative to the model origin. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies that the default Y-offset will be used. INFO |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the Y-offset value. INFO |
||||||||||||||||||||||||||||||||||||||
M_SAGITTA_TOLERANCE + |
Inquires the tolerance for finding deformed circles (allowable radii variation) for an M_CIRCLE type model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 25.0%. |
||||||||||||||||||||||||||||||||||||||
0.0 <= Value <= 100.0 |
Specifies the tolerance as a percentage of the allowable radii variation given the other Model Finder constraints. INFO |
||||||||||||||||||||||||||||||||||||||
M_SCALE + |
Inquires the nominal search scale. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 1.0. |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the value of the nominal search scale. INFO |
||||||||||||||||||||||||||||||||||||||
M_SCALE_MAX_FACTOR + |
Inquires the factor used to determine the upper limit (maximum permitted scale) of the scale range. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 2.0. |
||||||||||||||||||||||||||||||||||||||
M_INFINITE |
Specifies that the upper limit of the scale range is infinite. INFO |
||||||||||||||||||||||||||||||||||||||
1.0 <= Value <= 2.0 |
Specifies the factor that determines the maximum scale of the occurrence for a model in an M_GEOMETRIC or M_GEOMETRIC_CONTROLLED type of Model Finder context. |
||||||||||||||||||||||||||||||||||||||
Value >= 1.0 |
Specifies the factor that determines the maximum scale of the occurrence for a model in an M_SHAPE_CIRCLE type of Model Finder context. |
||||||||||||||||||||||||||||||||||||||
M_SCALE_MIN_FACTOR + |
Inquires the factor used to determine the lower limit (minimum permitted scale) of the scale range. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 0.5. |
||||||||||||||||||||||||||||||||||||||
0.0 < Value <= 1.0 |
Specifies the factor that determines the minimum scale of the occurrence for a model in an M_SHAPE_CIRCLE type of Model Finder context. |
||||||||||||||||||||||||||||||||||||||
0.5 <= Value <= 1.0 |
Specifies the factor that determines the minimum scale of the occurrence for a model in an M_GEOMETRIC or M_GEOMETRIC_CONTROLLED type of Model Finder context. |
||||||||||||||||||||||||||||||||||||||
M_USER_LABEL + |
Inquires the user-defined label. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_NO_LABEL. |
||||||||||||||||||||||||||||||||||||||
M_NO_LABEL |
Specifies that no user label is associated with the model. |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the user label of the model. INFO |
||||||||||||||||||||||||||||||||||||||
M_VALID + |
Inquires whether the model is valid or not. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_FALSE |
Specifies that the model is not valid. |
||||||||||||||||||||||||||||||||||||||
M_TRUE |
Specifies that the model is valid. |
||||||||||||||||||||||||||||||||||||||
M_VERTICAL_THICKNESS + |
Inquires the vertical thickness of the cross in the model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the vertical thickness of the cross, in the user-defined units for the model. |
||||||||||||||||||||||||||||||||||||||
M_WIDTH + |
Inquires the width of the shape in the model. SET SET SET SET SET SET (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the width of the shape, in the user-defined units for the model. |
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.
For inquiring the default value of an
inquire type
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Inquires the default value of the specified inquire type. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_DOUBLE |
For result buffer inquiries, the InquireType parameter can be set to one of the following:
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.
For a result buffer
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_MOD_DEFINE_COMPATIBLE + |
Inquires whether the information necessary to define a model from an occurrence will be saved in the result buffer. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_DISABLE. |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies not to save any information. |
||||||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies to save all the necessary information. |
||||||||||||||||||||||||||||||||||||||
M_RESULT_OUTPUT_UNITS + |
Inquires whether results are returned in pixel or world units. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_ACCORDING_TO_CALIBRATION. |
||||||||||||||||||||||||||||||||||||||
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. |
||||||||||||||||||||||||||||||||||||||
M_PIXEL |
Specifies that results are returned in pixel units, with respect to the pixel coordinate system. |
||||||||||||||||||||||||||||||||||||||
M_WORLD |
Specifies that results are returned in world units, with respect to the relative coordinate system. INFO |
For user label inquiries (that is, when the Index parameter is set to the user label of a model), the InquireType parameter can be set to the following:
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.
For user label inquires
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_INDEX_FROM_LABEL + |
Inquires the model index associated with a model user label if the user label is used. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_INVALID |
Specifies that the user label is invalid. (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the model index that is associated with the specified user label. |
You can add the following value to the above-mentioned values to determine whether an inquire type is supported.
For inquiring whether an inquire type is
supported
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_SUPPORTED |
Inquires whether the specified inquire type is supported. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_DOUBLE |
||||||||||||||||||||||||||||||||||||||
0 |
Specifies that the inquire type is not supported. |
||||||||||||||||||||||||||||||||||||||
Value != 0 |
Specifies that the inquire type is supported. (more details...) |
You can add one of the following values to the above-mentioned values to cast the requested information to the required data type.
For specifying the data
type
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_TYPE_MIL_DOUBLE |
Casts the requested information to a MIL_DOUBLE. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
|
||||||||||||||||||||||||||||||||||||||
M_TYPE_MIL_ID |
Casts the requested information to a MIL_ID. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
|
||||||||||||||||||||||||||||||||||||||
M_TYPE_MIL_INT |
Casts the requested information to a MIL_INT. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
|
||||||||||||||||||||||||||||||||||||||
M_TYPE_MIL_INT32 |
Casts the requested information to a MIL_INT32. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
|
||||||||||||||||||||||||||||||||||||||
M_TYPE_MIL_INT64 |
Casts the requested information to a MIL_INT64. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
|
Header | Include mil.h. |
Library | Use mil.lib; milmod.lib. |
DLL | Requires mil.dll; milmod.dll. |