MIL_ID ContextOrResultCodeId, | //in |
MIL_INT64 InquireType, | //in |
void *UserVarPtr | //out |
This function inquires about a setting of the specified code context, code model, or code result buffer.
Note that McodeInquire() in combination with McodeWrite() can also be used to determine the required image buffer size to encode a given string. First, call McodeWrite() with ImageBufId set to M_NULL and then call McodeInquire() to retrieve the minimum width (M_WRITE_SIZE_X) and height (M_WRITE_SIZE_Y) required for the code. This same method can be used to obtain the number of cells required to write your code (M_WRITE_CELL_NUMBER_X and M_WRITE_CELL_NUMBER_Y).
Specifies the identifier of the code context, code model, or code result buffer.
Specifies the setting about which to inquire.
See the Parameter associations section for possible values that can be specified.
Specifies the address in which to return the value of the inquired setting. Since this 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 get the number of code models in a code context, select the following.
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.
For inquiring about the number code
models in a code context
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_NUMBER_OF_CODE_MODELS + |
Inquires the number of code models in the code context. (more details...) |
||||||||||||||||||||||||||||||||||||||
Value >= 0 |
Specifies the number of code models in the code context. |
For a code context, the InquireType parameter can be set to one of the following to inquire about control settings relating only to read operations.
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.
For inquiring about a code context's
global settings relating to McodeRead() operations
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_TOTAL_NUMBER + |
Inquires the total number of codes to be read in one image. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_ALL |
Specifies to read all code occurrences in the source image, up to the maximum number of occurrences to read of each code model (M_NUMBER). |
||||||||||||||||||||||||||||||||||||||
Value >= 0 |
Specifies the maximum number of codes to read in the source image. |
For a code model, the InquireType parameter can be set to one of the following to inquire about control settings relating only to grading operations.
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.
For inquiring about a code context's
global settings relating to McodeGrade() operations
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_ABSOLUTE_APERTURE_SIZE |
Inquires the absolute size (diameter) of the aperture. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
Value >= 0 |
Specifies the absolute aperture size, relative to the input coordinate system specified using M_ABSOLUTE_APERTURE_SIZE_INPUT_UNITS. |
||||||||||||||||||||||||||||||||||||||
M_ABSOLUTE_APERTURE_SIZE_INPUT_UNITS |
Inquires the units with which to interpret the M_ABSOLUTE_APERTURE_SIZE inquire type. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_PIXEL |
Specifies to interpret the value in pixel units, with respect to the pixel coordinate system. |
||||||||||||||||||||||||||||||||||||||
M_WORLD |
Specifies to interpret the value in world units, with respect to the relative coordinate system. INFO |
||||||||||||||||||||||||||||||||||||||
M_APERTURE_MODE |
Inquires the mode to use to determine the aperture size. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_ABSOLUTE |
Specifies to use the absolute aperture size, set using M_ABSOLUTE_APERTURE_SIZE. |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies to disable the aperture. INFO |
||||||||||||||||||||||||||||||||||||||
M_RELATIVE |
Specifies to use a relative aperture size, based on the cell size (using M_CELL_SIZE...) and the relative aperture factor (using M_RELATIVE_APERTURE_FACTOR). |
||||||||||||||||||||||||||||||||||||||
M_EXTENDED_AREA_REFLECTANCE_CHECK |
Inquires that the grading must perform an additional reflectance check over an extended area (that is, 20 x beyond the code model on all sides). SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies to disable the additional reflectance check. |
||||||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies to enable the additional reflectance check. INFO |
||||||||||||||||||||||||||||||||||||||
M_GRADING_STANDARD |
Inquires the standard used when performing a grading operation. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_AIMDPM_GRADING |
Specifies the ISO/IEC TR 29158:2011 specification. INFO |
||||||||||||||||||||||||||||||||||||||
M_ISO_GRADING |
Specifies the ISO standard. |
||||||||||||||||||||||||||||||||||||||
M_INSPECTION_BAND_RATIO |
Inquires the height of the inspection band as a percentage of the average bar height. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default percentage. INFO |
||||||||||||||||||||||||||||||||||||||
0.0 < Value < 100.0 |
Specifies the percentage of the average bar height used as the height of the inspection band. |
||||||||||||||||||||||||||||||||||||||
M_MAXIMUM_CALIBRATED_REFLECTANCE |
Inquires the maximum possible grayscale value in the target image. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
0 <= Value <= 255 |
Specifies the maximum calibrated reflectance. |
||||||||||||||||||||||||||||||||||||||
M_MEAN_LIGHT_CALIBRATION |
Inquires the expected mean intensity of the centers of the white elements of the codes to inspect during the target verification phase (MLcal). SET SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value. INFO |
||||||||||||||||||||||||||||||||||||||
0 <= Value <= 255 |
Specifies the mean intensity. INFO |
||||||||||||||||||||||||||||||||||||||
M_MINIMUM_CALIBRATED_REFLECTANCE |
Inquires the minimum possible grayscale value in the target image. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
0 <= Value <= 255 |
Specifies the minimum calibrated reflectance. |
||||||||||||||||||||||||||||||||||||||
M_NUMBER_OF_SCANLINES |
Inquires the number of scanlines inside the inspection band to inspect during the grading operation, after the code has been located. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value. INFO |
||||||||||||||||||||||||||||||||||||||
M_ALL |
Specifies to use all possible scanlines inside the inspection band. |
||||||||||||||||||||||||||||||||||||||
Value > 0 |
Specifies the number of scanlines to inspect. INFO |
||||||||||||||||||||||||||||||||||||||
M_PIXEL_SIZE_IN_MM |
Inquires the scale between a pixel and its physical measurement, in millimeters per pixel units. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_UNKNOWN |
Specifies that the scale between a pixel and its physical measurement is not known, in mm per pixel units. |
||||||||||||||||||||||||||||||||||||||
Value > 0 |
Specifies the scale between a pixel and its physical measurement, in mm per pixel units. |
||||||||||||||||||||||||||||||||||||||
M_REFLECTANCE_CALIBRATION |
Inquires the expected reflectance value of the codes to inspect during the target verification phase (Rcal). SET SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value. INFO |
||||||||||||||||||||||||||||||||||||||
0 <= Value <= 255 |
Specifies the reflectance value. INFO |
||||||||||||||||||||||||||||||||||||||
M_RELATIVE_APERTURE_FACTOR |
Inquires the relative aperture factor. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_AUTO |
Specifies that the aperture factor is chosen according to ISO 15416 for all supported code types except 2D matrix code types, which are chosen according to ISO 15415. INFO |
||||||||||||||||||||||||||||||||||||||
0 <= Value <= 2 |
Specifies the aperture factor. |
||||||||||||||||||||||||||||||||||||||
M_SYSTEM_RESPONSE_CALIBRATION |
Inquires the System Response value associated with the reference code (SRcal). SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value. INFO |
||||||||||||||||||||||||||||||||||||||
Value > 0.0 |
Specifies the System Response value for the reference code. |
||||||||||||||||||||||||||||||||||||||
M_SYSTEM_RESPONSE_TARGET |
Inquires the System Response value associated with the target code (SRtarget). SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value. INFO |
||||||||||||||||||||||||||||||||||||||
Value > 0.0 |
Specifies the System Response value for the target code. |
For a code context, the InquireType parameter can be set to one of the following to inquire about control settings relating to read and grading operations.
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.
For inquiring about a code context's
global settings relating to McodeRead() and McodeGrade()
operations
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_MINIMUM_CONTRAST + |
Inquires the minimum possible contrast between the foreground and background in the target image. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 50. |
||||||||||||||||||||||||||||||||||||||
1 <= Value <= 255 |
Specifies the minimum contrast. |
||||||||||||||||||||||||||||||||||||||
M_SCANLINE_HEIGHT + |
Inquires the scanline height (or thickness). SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies that the scanline height is based on the value of M_SPEED. |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the scanline height, relative to the input coordinate system specified using M_SCANLINE_INPUT_UNITS. INFO |
||||||||||||||||||||||||||||||||||||||
M_SCANLINE_INPUT_UNITS + |
Inquires the units with which to interpret the M_SCANLINE_STEP and M_SCANLINE_HEIGHT inquire types. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_PIXEL |
Specifies to interpret the values in pixel units, with respect to the pixel coordinate system. |
||||||||||||||||||||||||||||||||||||||
M_WORLD |
Specifies to interpret the values in world units, with respect to the relative coordinate system. INFO |
||||||||||||||||||||||||||||||||||||||
M_SCANLINE_STEP + |
Inquires the scanline step (or interval). SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies that the scanline step is based on the value of M_SPEED. INFO |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the scanline step, relative to the input coordinate system specified using M_SCANLINE_INPUT_UNITS. INFO |
||||||||||||||||||||||||||||||||||||||
M_SEARCH_ANGLE_MODE + |
Inquires whether the search angular range algorithm for the code context is enabled. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies that the search angular range algorithm is not used. |
||||||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies that the search angular range algorithm is used. |
||||||||||||||||||||||||||||||||||||||
M_SPEED + |
Inquires the search speed. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_HIGH |
Specifies a high search speed. |
||||||||||||||||||||||||||||||||||||||
M_LOW |
Specifies a low search speed. |
||||||||||||||||||||||||||||||||||||||
M_MEDIUM |
Specifies a medium search speed. |
||||||||||||||||||||||||||||||||||||||
M_VERY_HIGH |
Specifies a very high search speed. |
||||||||||||||||||||||||||||||||||||||
M_VERY_LOW |
Specifies a very low search speed. |
||||||||||||||||||||||||||||||||||||||
M_THRESHOLD_MODE + |
Inquires the threshold mode used to internally binarize the source image. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_ADAPTIVE |
Specifies to use a fast dynamic local threshold. INFO |
||||||||||||||||||||||||||||||||||||||
M_GLOBAL_SEGMENTATION |
Specifies to use a global threshold value. INFO |
||||||||||||||||||||||||||||||||||||||
M_GLOBAL_WITH_LOCAL_RESEGMENTATION |
Specifies that the source image will be globally thresholded and then the edges in the binarized image are resegmented according to the intensities of the surrounding bars and spaces in the original source image. INFO |
||||||||||||||||||||||||||||||||||||||
M_THRESHOLD_VALUE + |
Inquires the threshold value used to internally binarize the source image, depending on the threshold mode. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_AUTO_COMPUTE |
Specifies the threshold value automatically. |
||||||||||||||||||||||||||||||||||||||
0 <= Value <= 255 |
Specifies the threshold value. |
||||||||||||||||||||||||||||||||||||||
M_TIMEOUT + |
Inquires the maximum decoding time for a read or grading operation. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies that there is no maximum decoding time. |
||||||||||||||||||||||||||||||||||||||
Value >= 0 |
Specifies the maximum decoding time, in msec. |
To get the code type of a code model, select the following.
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.
For inquiring about a code model's code
type
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_CODE_TYPE + |
Inquires the code type of the specified model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_4_STATE |
Specifies a 4-state code type. |
||||||||||||||||||||||||||||||||||||||
M_AZTEC |
Specifies an Aztec code type. INFO |
||||||||||||||||||||||||||||||||||||||
M_BC412 |
Specifies a BC412 code type. |
||||||||||||||||||||||||||||||||||||||
M_CODABAR |
Specifies a Codabar code type. |
||||||||||||||||||||||||||||||||||||||
M_CODE39 |
Specifies a Code 39 code type. |
||||||||||||||||||||||||||||||||||||||
M_CODE93 |
Specifies a Code 93 code type. |
||||||||||||||||||||||||||||||||||||||
M_CODE128 |
Specifies a Code 128 code type. |
||||||||||||||||||||||||||||||||||||||
M_COMPOSITECODE |
Specifies a composite code type. INFO |
||||||||||||||||||||||||||||||||||||||
M_DATAMATRIX |
Specifies a Data Matrix code type. INFO |
||||||||||||||||||||||||||||||||||||||
M_EAN8 |
Specifies an EAN 8 code type. |
||||||||||||||||||||||||||||||||||||||
M_EAN13 |
Specifies an EAN 13 code type. |
||||||||||||||||||||||||||||||||||||||
M_EAN14 |
Specifies an EAN 14 code type. |
||||||||||||||||||||||||||||||||||||||
M_GS1_128 |
Specifies a GS1-128 code type. |
||||||||||||||||||||||||||||||||||||||
M_GS1_DATABAR |
Specifies a GS1 Databar code type. |
||||||||||||||||||||||||||||||||||||||
M_INDUSTRIAL25 |
Specifies an Industrial 2 of 5 (standard 2 of 5) code type. |
||||||||||||||||||||||||||||||||||||||
M_INTERLEAVED25 |
Specifies an Interleaved 25 (ITF-14) code type. INFO |
||||||||||||||||||||||||||||||||||||||
M_MAXICODE |
Specifies a Maxicode code type. INFO |
||||||||||||||||||||||||||||||||||||||
M_MICROPDF417 |
Specifies a MicroPDF417 code type. INFO |
||||||||||||||||||||||||||||||||||||||
M_MICROQRCODE |
Specifies a Micro QR code type. INFO |
||||||||||||||||||||||||||||||||||||||
M_PDF417 |
Specifies a PDF417 code type. INFO |
||||||||||||||||||||||||||||||||||||||
M_PHARMACODE |
Specifies a Pharmacode code type. |
||||||||||||||||||||||||||||||||||||||
M_PLANET |
Specifies a Planet code type. |
||||||||||||||||||||||||||||||||||||||
M_POSTNET |
Specifies a Postnet code type. |
||||||||||||||||||||||||||||||||||||||
M_QRCODE |
Specifies a QR code type. INFO |
||||||||||||||||||||||||||||||||||||||
M_TRUNCATED_PDF417 |
Specifies a Truncated PDF417 code type. INFO |
||||||||||||||||||||||||||||||||||||||
M_UPC_A |
Specifies a UPC-A code type. |
||||||||||||||||||||||||||||||||||||||
M_UPC_E |
Specifies a UPC-E code type. |
For a code model, the InquireType parameter can be set to one of the following to inquire about control settings relating only to read operations.
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.
For inquiring about a code model's
settings relating to McodeRead() operations
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_CHECK_QUIET_ZONE + |
Inquires whether the presence of the quiet zone is necessary for a successful read operation of this code type. (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_ENABLE. |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies that a quiet zone is not necessary. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies that a quiet zone is necessary. |
||||||||||||||||||||||||||||||||||||||
M_ECC_CORRECTED_NUMBER + |
Inquires whether or not a more robust read operation will be performed. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies not to perform a more robust read operation. |
||||||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies to perform a more robust read operation. |
||||||||||||||||||||||||||||||||||||||
M_NUMBER + |
Inquires the maximum number of codes to be read for the specified code model. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 1. |
||||||||||||||||||||||||||||||||||||||
M_ALL |
Specifies that all code model occurrences are read up to the maximum number limited by M_TOTAL_NUMBER. |
||||||||||||||||||||||||||||||||||||||
Value >= 0 |
Specifies the maximum number of codes to read for the specified code model. |
||||||||||||||||||||||||||||||||||||||
M_POSITION_ACCURACY + |
Inquires the positional accuracy of the read operation. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_LOW. |
||||||||||||||||||||||||||||||||||||||
M_HIGH |
Specifies to report the positional results of code read operations with high accuracy. |
||||||||||||||||||||||||||||||||||||||
M_LOW |
Specifies to report the positional results of code read operations with low accuracy. |
For a code model, the InquireType parameter can be set to one of the following to inquire about control settings relating to read and grading operations.
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.
For inquiring about a code model's
settings relating to McodeRead() and McodeGrade()
operations
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_BEARER_BAR + |
Inquires whether bearer bars surround the codes to read. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_ABSENT. |
||||||||||||||||||||||||||||||||||||||
M_ABSENT |
Specifies that no bearer bars are above and below the code. |
||||||||||||||||||||||||||||||||||||||
M_PRESENT |
Specifies that there are bearer bars above an below the code. |
||||||||||||||||||||||||||||||||||||||
M_CELL_NUMBER_X_MAX + |
Inquires the maximum number of cells for which to search in the X-direction. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_ANY. |
||||||||||||||||||||||||||||||||||||||
M_ANY |
Specifies to search for codes with any number of cells. |
||||||||||||||||||||||||||||||||||||||
Value > 0 |
Specifies the maximum number of cells for which to search. INFO |
||||||||||||||||||||||||||||||||||||||
M_CELL_NUMBER_X_MIN + |
Inquires the minimum number of cells for which to search in the X-direction. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_ANY. |
||||||||||||||||||||||||||||||||||||||
M_ANY |
Specifies to search for codes with any number of cells. |
||||||||||||||||||||||||||||||||||||||
Value > 0 |
Specifies the minimum number of cells for which to search. INFO |
||||||||||||||||||||||||||||||||||||||
M_CELL_NUMBER_Y_MAX + |
Inquires the maximum number of cells for which to search in the Y-direction. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_ANY. |
||||||||||||||||||||||||||||||||||||||
M_ANY |
Specifies to search for codes with any number of cells. |
||||||||||||||||||||||||||||||||||||||
Value > 0 |
Specifies the maximum number of cells for which to search. INFO |
||||||||||||||||||||||||||||||||||||||
M_CELL_NUMBER_Y_MIN + |
Inquires the minimum number of cells for which to search in the Y-direction. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_ANY. |
||||||||||||||||||||||||||||||||||||||
M_ANY |
Specifies to search for codes with any number of cells. |
||||||||||||||||||||||||||||||||||||||
Value > 0 |
Specifies the minimum number of cells for which to search. INFO |
||||||||||||||||||||||||||||||||||||||
M_CHECK_FINDER_PATTERN + |
Inquires whether or not the check for false Data Matrix codes is enabled. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_DISABLE. |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies that the Code module will not check for false Data Matrix code types. |
||||||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies that the Code module will check for false Data Matrix code types. |
||||||||||||||||||||||||||||||||||||||
M_CODE_FLIP + |
Inquires whether the code should be flipped or read in the opposite direction to be read properly. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_NO_FLIP. |
||||||||||||||||||||||||||||||||||||||
M_FLIP |
Specifies that the code needs to be flipped or read in the opposite direction to be read properly. INFO |
||||||||||||||||||||||||||||||||||||||
M_NO_FLIP |
Specifies that the code does not need to be flipped or read in the opposite direction. INFO |
||||||||||||||||||||||||||||||||||||||
M_DISTORTION + |
Inquires the distortion compensation algorithm needed to read the code properly. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_NONE. |
||||||||||||||||||||||||||||||||||||||
M_NONE |
Specifies not to use distortion compensation. |
||||||||||||||||||||||||||||||||||||||
M_PERSPECTIVE_UNEVEN_GRID_STEP |
Specifies to use an algorithm that reads or grades Data Matrix codes that have perspective distortion and/or different column widths or row heights. INFO |
||||||||||||||||||||||||||||||||||||||
M_UNEVEN_GRID_STEP |
Specifies to use an algorithm that reads or grades Aztec, Data Matrix, or QR code types that have different column widths or row heights and/or slight perspective distortion. |
||||||||||||||||||||||||||||||||||||||
M_DOT_SPACING + |
Inquires the expected distance between 2 dots in a matrix code composed of dots. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies no spacing. |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the distance, relative to the input coordinate system specified using M_DOT_SPACING_INPUT_UNITS. INFO |
||||||||||||||||||||||||||||||||||||||
M_DOT_SPACING_INPUT_UNITS + |
Inquires the units with which to interpret the M_DOT_SPACING inquire type. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_PIXEL. |
||||||||||||||||||||||||||||||||||||||
M_PIXEL |
Specifies to interpret the value in pixel units, with respect to the pixel coordinate system. |
||||||||||||||||||||||||||||||||||||||
M_WORLD |
Specifies to interpret the value in world units, with respect to the relative coordinate system. INFO |
||||||||||||||||||||||||||||||||||||||
M_FINDER_PATTERN_EXHAUSTIVE_SEARCH + |
Inquires whether an exhaustive search is to be used. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies to not perform an exhaustive search. |
||||||||||||||||||||||||||||||||||||||
M_ENABLE |
Specifies to perform an exhaustive search. |
||||||||||||||||||||||||||||||||||||||
M_FINDER_PATTERN_INPUT_UNITS + |
Inquires the units with which to interpret the M_FINDER_PATTERN_EXHAUSTIVE_SEARCH and M_FINDER_PATTERN_MINIMUM_LENGTH inquire types. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_PIXEL. |
||||||||||||||||||||||||||||||||||||||
M_PIXEL |
Specifies to interpret the values in pixel units, with respect to the pixel coordinate system. |
||||||||||||||||||||||||||||||||||||||
M_WORLD |
Specifies to interpret the values in world units, with respect to the relative coordinate system. INFO |
||||||||||||||||||||||||||||||||||||||
M_FINDER_PATTERN_MAX_GAP + |
Inquires the maximum tolerable gap in the finder pattern of a Data Matrix code. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_AUTO. |
||||||||||||||||||||||||||||||||||||||
M_AUTO |
Specifies that the maximum tolerable gap in the finder pattern is 6 times the minimum cell size specified using M_CELL_SIZE_MIN. |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the maximum gap allowed, in input units specified using M_FINDER_PATTERN_INPUT_UNITS. |
||||||||||||||||||||||||||||||||||||||
M_FINDER_PATTERN_MINIMUM_LENGTH + |
Inquires the shortest acceptable length of either "arm" of the finder pattern of a Data Matrix code. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_AUTO. |
||||||||||||||||||||||||||||||||||||||
M_AUTO |
Specifies that the minimum acceptable finder pattern "arm" length is 6 times the minimum cell size specified using M_CELL_SIZE_MIN. |
||||||||||||||||||||||||||||||||||||||
Value |
The minimum acceptable finder pattern "arm" length, in input units specified using M_FINDER_PATTERN_INPUT_UNITS. |
||||||||||||||||||||||||||||||||||||||
M_SEARCH_ANGLE + |
Inquires the nominal search angle. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 0.0. |
||||||||||||||||||||||||||||||||||||||
0.0 <= Value <= 360.0 |
Specifies the nominal angle, in degrees, relative to the input coordinate system specified using M_SEARCH_ANGLE_INPUT_UNITS. INFO |
||||||||||||||||||||||||||||||||||||||
M_SEARCH_ANGLE_DELTA_NEG + |
Inquires the negative angle range of the search. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 5.0. |
||||||||||||||||||||||||||||||||||||||
0.0 <= Value <= 180.0 |
Specifies a negative angular range, in degrees, relative to the nominal angle set by M_SEARCH_ANGLE. INFO |
||||||||||||||||||||||||||||||||||||||
M_SEARCH_ANGLE_DELTA_POS + |
Inquires the positive angle range of the search. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default value; the default value is 5.0. |
||||||||||||||||||||||||||||||||||||||
0.0 <= Value <= 180.0 |
Specifies a positive angular range, in degrees, relative to the nominal angle set by M_SEARCH_ANGLE. INFO |
||||||||||||||||||||||||||||||||||||||
M_SEARCH_ANGLE_INPUT_UNITS + |
Inquires the units with which to interpret the M_SEARCH_ANGLE inquire type. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_PIXEL. |
||||||||||||||||||||||||||||||||||||||
M_PIXEL |
Specifies to interpret the value in pixel units, with respect to the pixel coordinate system. |
||||||||||||||||||||||||||||||||||||||
M_WORLD |
Specifies to interpret the value in world units, with respect to the relative coordinate system. INFO |
||||||||||||||||||||||||||||||||||||||
M_SEARCH_ANGLE_STEP + |
Inquires the angle increment/decrement used when searching for a 1D code through an angular range. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_DISABLE. |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies that no explicit increment/decrement is used. INFO |
||||||||||||||||||||||||||||||||||||||
0.1 <= Value <= 180.0 |
Specifies the explicit angle increment/decrement, in degrees. |
||||||||||||||||||||||||||||||||||||||
M_STRING_SIZE_MAX + |
Inquires the maximum size (number of characters) of the string encoded in the code. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_ANY. |
||||||||||||||||||||||||||||||||||||||
M_ANY |
Specifies that there is no maximum string size. |
||||||||||||||||||||||||||||||||||||||
1 <= Value <= 65535 |
Specifies the maximum string size. INFO |
||||||||||||||||||||||||||||||||||||||
M_STRING_SIZE_MIN + |
Inquires the minimum size (number of characters) of the string encoded in the code. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_ANY. |
||||||||||||||||||||||||||||||||||||||
M_ANY |
Specifies that there is no minimum string size. |
||||||||||||||||||||||||||||||||||||||
1 <= Value <= 65535 |
Specifies the minimum string size. INFO |
||||||||||||||||||||||||||||||||||||||
M_SUB_TYPE + |
Inquires the particular codes in a family of codes for which to search. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_ANY. |
||||||||||||||||||||||||||||||||||||||
M_ANY |
Specifies to search for all of the code sub-types that can be specified for M_SUB_TYPE. INFO |
||||||||||||||||||||||||||||||||||||||
M_EAN8 |
Specifies that the EAN 8 code sub-type is enabled. INFO |
||||||||||||||||||||||||||||||||||||||
M_EAN13 |
Specifies that the EAN 13 code sub-type is enabled. INFO |
||||||||||||||||||||||||||||||||||||||
M_GS1_128 |
Specifies that the GS1-128 code sub-type is enabled. INFO |
||||||||||||||||||||||||||||||||||||||
M_GS1_DATABAR_EXPANDED |
Specifies that the GS1 Databar Expanded code sub-type is enabled. INFO |
||||||||||||||||||||||||||||||||||||||
M_GS1_DATABAR_EXPANDED_STACKED |
Specifies that the GS1 Databar Expanded Stacked code sub-type is enabled. INFO |
||||||||||||||||||||||||||||||||||||||
M_GS1_DATABAR_LIMITED |
Specifies that the GS1 Databar Limited code sub-type is enabled. INFO |
||||||||||||||||||||||||||||||||||||||
M_GS1_DATABAR_OMNI |
Specifies that the GS1 Databar omni code sub-type is enabled. INFO |
||||||||||||||||||||||||||||||||||||||
M_GS1_DATABAR_STACKED |
Specifies that the GS1 Databar Stacked code sub-type is enabled. INFO |
||||||||||||||||||||||||||||||||||||||
M_GS1_DATABAR_STACKED_OMNI |
Specifies that the GS1 Databar Stacked Omni code sub-type is enabled. INFO |
||||||||||||||||||||||||||||||||||||||
M_GS1_DATABAR_TRUNCATED |
Specifies that the GS1 Databar Truncated code sub-type is enabled. INFO |
||||||||||||||||||||||||||||||||||||||
M_UPC_A |
Specifies that the UPC-A code sub-type is enabled. INFO |
||||||||||||||||||||||||||||||||||||||
M_UPC_E |
Specifies that the UPC-E code sub-type is enabled. INFO |
||||||||||||||||||||||||||||||||||||||
M_USE_PRESEARCH + |
Inquires whether the localization operation is performed prior to read and grading operations. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_DISABLE. |
||||||||||||||||||||||||||||||||||||||
M_DISABLE |
Specifies that the operation is not performed. |
||||||||||||||||||||||||||||||||||||||
M_FINDER_PATTERN_BASE |
Specifies that the localization operation is only performed on the base pattern of the Data Matrix code (an "L" starting at the top-most left corner, and ending on the bottom-most right corner of the code). INFO |
||||||||||||||||||||||||||||||||||||||
M_STAT_BASE |
Specifies to localize the code within the image with the statistical characteristics of a 2D bar code (for example, local variance and the presence of a lot of edges). INFO |
For a code model, the InquireType parameter can be set to one of the following to inquire about control settings relating to read, grading, and write operations.
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.
For inquiring about a code model's
settings relating to McodeRead(), McodeGrade(), and McodeWrite()
operations
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_CELL_NUMBER_X + |
Inquires the number of cells to be used in the X-direction. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_ANY. |
||||||||||||||||||||||||||||||||||||||
M_ANY |
Specifies to search for a code with any number of cells, when performing an McodeRead() or McodeGrade() operation. INFO |
||||||||||||||||||||||||||||||||||||||
Value > 0 |
Specifies the number of cells. INFO |
||||||||||||||||||||||||||||||||||||||
M_CELL_NUMBER_Y + |
Inquires the number of cells to be used in the Y-direction. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_ANY. |
||||||||||||||||||||||||||||||||||||||
M_ANY |
Specifies to search for a code with any number of cells, when performing an McodeRead() or McodeGrade() operation. INFO |
||||||||||||||||||||||||||||||||||||||
Value > 0 |
Specifies the number of cells. INFO |
||||||||||||||||||||||||||||||||||||||
M_CELL_SIZE_INPUT_UNITS + |
Inquires the units with which to interpret the M_CELL_SIZE_MAX and M_CELL_SIZE_MIN inquire types. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_PIXEL. |
||||||||||||||||||||||||||||||||||||||
M_PIXEL |
Specifies to interpret the values in pixel units, with respect to the pixel coordinate system. |
||||||||||||||||||||||||||||||||||||||
M_WORLD |
Specifies to interpret the values in world units, with respect to the relative coordinate system. INFO |
||||||||||||||||||||||||||||||||||||||
M_CELL_SIZE_MAX + |
Inquires the maximum cell size. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies to select an appropriate size, automatically. |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the maximum cell size, relative to the input coordinate system specified using M_CELL_SIZE_INPUT_UNITS. INFO |
||||||||||||||||||||||||||||||||||||||
M_CELL_SIZE_MIN + |
Inquires the minimum cell size. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies the default cell size, in pixels. INFO |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the minimum cell size, relative to the input coordinate system specified using M_CELL_SIZE_INPUT_UNITS. INFO |
||||||||||||||||||||||||||||||||||||||
M_DATAMATRIX_SHAPE + |
Inquires the shape of the Data Matrix code. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_ANY. |
||||||||||||||||||||||||||||||||||||||
M_ANY |
Specifies that the Data Matrix code type can be any shape. |
||||||||||||||||||||||||||||||||||||||
M_RECTANGLE |
Specifies that the Data Matrix code has a rectangular shape. INFO |
||||||||||||||||||||||||||||||||||||||
M_SQUARE |
Specifies that the Data Matrix has a square shape. |
||||||||||||||||||||||||||||||||||||||
M_ENCODING + |
Inquires the type of encoding scheme. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies to use the default encoding scheme for the code type. INFO |
||||||||||||||||||||||||||||||||||||||
M_ANY |
Specifies any type of encoding scheme. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_ALPHA |
Specifies an encoding scheme that supports uppercase alphabetical characters, along with the space. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_ALPHANUM |
Specifies an encoding scheme that supports alphanumeric characters, as well as the space. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_ALPHANUM_PUNC |
Specifies a similar encoding scheme to M_ENC_ALPHANUM, except it also supports the following characters: (,), (-), (/) and (. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_ASCII |
Specifies an encoding scheme that supports ASCII characters. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_AUSTRALIA_MAIL_C |
Specifies an encoding scheme for a 4-state format used with the C encoding table by the Australian Mail service. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_AUSTRALIA_MAIL_N |
Specifies an encoding scheme for a 4-state format used with the N encoding table by the Australian Mail service. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_AUSTRALIA_MAIL_RAW |
Specifies an encoding scheme for a 4-state format used by the Australian Mail service. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_AZTEC_COMPACT |
Specifies an encoding scheme for a compact Aztec code. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_AZTEC_FULL_RANGE |
Specifies an encoding scheme for a full-range (not compact) Aztec code. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_AZTEC_RUNE |
Specifies an encoding scheme for an Aztec rune (the smallest version of an Aztec code). INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_EAN8 |
Specifies an encoding scheme for a composite code whose 1D portion uses an EAN-8 format and whose 2D portion uses a MicroPDF417 format. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_EAN8_ADDON |
Specifies an encoding scheme for a composite code whose 1D portion uses an EAN-8 format and whose 2D portion uses a MicroPDF417 format. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_EAN13 |
Specifies an encoding scheme for a composite code whose 1D portion uses an EAN-13 format and whose 2D portion uses a MicroPDF417 format. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_EAN13_ADDON |
Specifies an encoding scheme for an EAN-13 format with a supplemental 2 or 5 digit add-on. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_GS1_128_MICROPDF417 |
Specifies an encoding scheme for a composite code whose 1D portion uses a GS1 128 format and whose 2D portion uses a MicroPDF417 format. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_GS1_128_PDF417 |
Specifies an encoding scheme for a composite code whose 1D portion uses a GS1 128 format and whose 2D portion uses a PDF417 format. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_GS1_DATABAR_EXPANDED |
Specifies an encoding scheme that uses a GS1 Databar format. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_GS1_DATABAR_EXPANDED_STACKED |
Specifies an encoding scheme that uses a GS1 Databar Expanded Stacked format. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_GS1_DATABAR_LIMITED |
Specifies an encoding scheme that uses a GS1 Databar Limited format. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_GS1_DATABAR_OMNI |
Specifies an encoding scheme that uses a GS1 Databar format. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_GS1_DATABAR_STACKED |
Specifies an encoding scheme that uses a GS1 Databar Stacked format. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_GS1_DATABAR_STACKED_OMNI |
Specifies an encoding scheme that uses a GS1 Databar Stacked Omni format. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_GS1_DATABAR_TRUNCATED |
Specifies an encoding scheme that uses a GS1 Databar Truncated format. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_ISO8 |
Specifies a similar encoding scheme as M_ENC_ASCII, but supports the extended ASCII character set. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_KOREA_MAIL |
Specifies an encoding scheme for a 4-state format used by the Korean Mail service. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_MODE2 |
Specifies an encoding scheme that requires a Structured Carrier Message. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_MODE3 |
Specifies an encoding scheme that requires a Structured Carrier Message. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_MODE4 |
Specifies an encoding scheme that requires a Free Format Message. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_MODE5 |
Specifies an encoding scheme that requires a Free Format Message. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_MODE6 |
Specifies an encoding scheme that requires a Free Format Message. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_NUM |
Specifies an encoding scheme that only supports numbers. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_QRCODE_MODEL1 |
Specifies an encoding scheme that uses an older version of the QR code format. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_QRCODE_MODEL2 |
Specifies an encoding scheme that uses a newer version of the QR code format. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_STANDARD |
Specifies different types of encoding schemes, depending on what code type is used. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_UK_MAIL |
Specifies an encoding scheme for a 4-state format used by the UK Mail service. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_UPCA |
Specifies an encoding scheme for a composite code whose 1D portion uses an UPC-A format and whose 2D portion uses a MicroPDF417 format. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_UPCA_ADDON |
Specifies an encoding scheme for an UPC-A format with a supplemental 2 or 5 digit add-on. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_UPCE |
Specifies an encoding scheme for a composite code whose 1D portion uses an UPC-E format and whose 2D portion uses a MicroPDF417 format. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_UPCE_ADDON |
Specifies an encoding scheme for an UPC_E format with a supplemental 2 or 5 digit add-on. INFO |
||||||||||||||||||||||||||||||||||||||
M_ENC_US_MAIL |
Specifies an encoding scheme for a 4-state format used by the US Mail service. INFO |
||||||||||||||||||||||||||||||||||||||
5 <= Value <= 95 |
Specifies the minimum amount of the symbol that contains error correction information, as a percentage. INFO |
||||||||||||||||||||||||||||||||||||||
M_ERROR_CORRECTION + |
Inquires the type of error correction. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Specifies to use the default error correction scheme for the code type. INFO |
||||||||||||||||||||||||||||||||||||||
M_ANY |
Specifies that the error correction type for read and grading operations is detected automatically. INFO |
||||||||||||||||||||||||||||||||||||||
M_ECC_4STATE |
Specifies to use the Reed Solomon-based algorithm or a check digit type of error correction scheme, depending on the specification of the encoding. INFO |
||||||||||||||||||||||||||||||||||||||
M_ECC_200 |
Specifies to use a Reed Solomon-based algorithm as an error correction scheme. INFO |
||||||||||||||||||||||||||||||||||||||
M_ECC_CHECK_DIGIT |
Specifies to use an additional digit to check whether there is an error or not. INFO |
||||||||||||||||||||||||||||||||||||||
M_ECC_COMPOSITE |
Specifies to use the default error correction scheme for the 1D and 2D portions of the composite code. INFO |
||||||||||||||||||||||||||||||||||||||
M_ECC_H |
Specifies to use the highest-level error correction scheme. INFO |
||||||||||||||||||||||||||||||||||||||
M_ECC_L |
Specifies to use the lowest-level error correction scheme. INFO |
||||||||||||||||||||||||||||||||||||||
M_ECC_M |
Specifies to use a medium-low level error correction scheme. INFO |
||||||||||||||||||||||||||||||||||||||
M_ECC_n |
Specifies an error correction algorithm that uses convolution coding. INFO |
||||||||||||||||||||||||||||||||||||||
M_ECC_NONE |
Specifies no error correction. INFO |
||||||||||||||||||||||||||||||||||||||
M_ECC_Q |
Specifies to use a medium-high level error correction scheme. INFO |
||||||||||||||||||||||||||||||||||||||
M_ECC_REED_SOLOMON |
Specifies to use a Reed Solomon type of error correction scheme. INFO |
||||||||||||||||||||||||||||||||||||||
M_ECC_REED_SOLOMON_n |
Specifies to use a Reed Solomon type of error correction scheme. INFO |
||||||||||||||||||||||||||||||||||||||
5 <= Value <= 95 |
Specifies the minimum percentage of the symbol that contains error correction information. INFO |
||||||||||||||||||||||||||||||||||||||
M_FOREGROUND_VALUE + |
Inquires the foreground color of the code. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_FOREGROUND_BLACK. |
||||||||||||||||||||||||||||||||||||||
M_FOREGROUND_ANY |
Specifies the foreground color as black or white. INFO |
||||||||||||||||||||||||||||||||||||||
M_FOREGROUND_BLACK |
Specifies that the foreground color is black. |
||||||||||||||||||||||||||||||||||||||
M_FOREGROUND_WHITE |
Specifies that the foreground color is white. |
For a code model, the InquireType parameter can be set to one of the following to inquire about control settings relating only to write operations. The following inquire types are only available after calling McodeWrite() with ImageBufId set to M_NULL.
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.
For inquiring about a code model's
settings relating to McodeWrite() operations
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_WRITE_CELL_NUMBER_X + |
Inquires the number of cells in the X-direction required to encode the string passed to a write operation. (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the number of cells in the X-direction. |
||||||||||||||||||||||||||||||||||||||
M_WRITE_CELL_NUMBER_Y + |
Inquires the number of cells in the Y-direction required to encode the string passed to a write operation. (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the number of cells in the Y-direction. |
||||||||||||||||||||||||||||||||||||||
M_WRITE_SIZE_X + |
Inquires the minimum width required for the destination image of a write operation. (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the minimum width. |
||||||||||||||||||||||||||||||||||||||
M_WRITE_SIZE_Y + |
Inquires the minimum height required for the destination image of a write operation. (more details...) |
||||||||||||||||||||||||||||||||||||||
Value |
Specifies the minimum height. |
You can add the following value to the above-mentioned values to specify 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...) |
||||||||||||||||||||||||||||||||||||||
M_NULL |
Specifies that the inquire type is not supported. |
||||||||||||||||||||||||||||||||||||||
Value != 0 |
Specifies that the inquire type is supported. |
To inquire about code result buffer settings, set the InquireType parameter to one of the following values.
Unless otherwise specified, the following values require that you pass the UserVarPtr parameter the address of a MIL_DOUBLE.
For result buffers
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_RESULT_OUTPUT_UNITS + |
Inquires the units with which to interpret the results. 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 |
||||||||||||||||||||||||||||||||||||||
M_STRING_FORMAT + |
Inquires the format in which the string is returned after the read operation. SET (more details...) |
||||||||||||||||||||||||||||||||||||||
M_DEFAULT |
Same as M_AUTO_FORMAT. |
||||||||||||||||||||||||||||||||||||||
M_AUTO_FORMAT |
Specifies that the returned string is in the string format associated with the code type. |
||||||||||||||||||||||||||||||||||||||
M_GS1_HUMAN_READABLE |
Specifies that the returned string is in a format that is human-readable. INFO |
||||||||||||||||||||||||||||||||||||||
M_GS1_RAW_DATA |
Specifies that the returned string is in a raw data format. INFO |
||||||||||||||||||||||||||||||||||||||
M_JAPANESE |
Specifies that the returned string uses Japanese (Windows-932) encoding. INFO |
||||||||||||||||||||||||||||||||||||||
M_KOREAN |
Specifies that the returned string uses Korean (Windows-949) encoding. INFO |
||||||||||||||||||||||||||||||||||||||
M_LATIN |
Specifies that the returned string uses Latin (Windows-1252) encoding. INFO |
||||||||||||||||||||||||||||||||||||||
M_SIMPLIFIED_CHINESE |
Specifies that the returned string uses Simplified Chinese (Windows-936) encoding. INFO |
||||||||||||||||||||||||||||||||||||||
M_UPCE_COMPRESSED |
Specifies that the returned string is in the UPCE compressed string format. INFO |
To inquire about the system on which the code context or code result 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 code context or code result has been 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(). |
You can add one of the following values to the above-mentioned values to cast the requested information to a required data type.
For specifying the data
type
|
|||||||||||||||||||||||||||||||||||||||
InquireType |
Description
|
||||||||||||||||||||||||||||||||||||||
UserVarPtr - Possible values returned |
|||||||||||||||||||||||||||||||||||||||
M_TYPE_MIL_DOUBLE |
Casts the requested data to a MIL_DOUBLE. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_DOUBLE |
||||||||||||||||||||||||||||||||||||||
M_TYPE_MIL_ID |
Casts the requested data to a MIL_ID. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_ID |
||||||||||||||||||||||||||||||||||||||
M_TYPE_MIL_INT |
Casts the requested data to a MIL_INT. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_INT |
||||||||||||||||||||||||||||||||||||||
M_TYPE_MIL_INT32 |
Casts the requested data to a MIL_INT32. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_INT32 |
||||||||||||||||||||||||||||||||||||||
M_TYPE_MIL_INT64 |
Casts the requested data to a MIL_INT64. (more details...) |
||||||||||||||||||||||||||||||||||||||
UserVarPtr data type info |
Data
type: MIL_INT64 |
Header | Include mil.h. |
Library | Use mil.lib; milcode.lib. |
DLL | Requires mil.dll; milcode.dll. |