Click here to show toolbars of the Web Online Help System: show toolbars
 

Filters
Filter values by
Code Type
  • 1D code types
  • 2D code types
    • Cross-row code types (PDF)
    • Matrix code types (Aztec, Data Matrix, Maxi, QR)
  • Composite code types
Operation Type
  • Code grading operations
  • Code reading operations
  • Code writing operations
Object Type
  • Code context
  • Code model
  • Code result buffer
| Customize Help
| Save Settings

McodeInquire



Function Map
Synopsis
Inquire about a code context, code model, or code result setting.
Syntax
MIL_INT McodeInquire(
MIL_ID ContextOrResultCodeId, //in
MIL_INT64 InquireType, //in
void *UserVarPtr //out
)
Description

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).

Note that this function reference has not been updated for a MIL system added during a MIL update. Refer to the MIL system's release note to see if there is complementary information.
Parameters
This function is not supported on the selected boards.
Parameters
ContextOrResultCodeId

Specifies the identifier of the code context, code model, or code result buffer.

InquireType

Specifies the setting about which to inquire.

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

UserVarPtr
Accepts the address of one of the following (see the Parameter associations section for specifics on which is expected):
  • MIL_DOUBLE
  • MIL_ID
  • MIL_INT
  • MIL_INT32
  • MIL_INT64

Specifies the address in which to return the value of the inquired setting. Since the McodeInquire() function also returns the requested information, you can set this parameter to M_NULL.

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

To get the number of code models in a code context, select the following.

function map For inquiring about the number code models in a code context
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_NUMBER_OF_CODE_MODELS +

Inquires the number of code models in the code context.

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE
Click to summarize 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.

function map For inquiring about a code context's global settings relating to McodeRead() operations
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_TOTAL_NUMBER +

Inquires the total number of codes to be read in one image. This number is also limited by M_NUMBER. SET

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

Same as M_ALL.

Click to summarize 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).

Click to summarize Value >= 0

Specifies the maximum number of codes to read in the source image. INFO

You can add the following value to the above-mentioned values to determine the default value of an inquire type, regardless of the current value of the inquire type.

function map For inquiring about the default value of an inquire type
Click to summarizeCombination value Description
Click to summarize M_DEFAULT

Inquires the default value of the specified inquire type.

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.

function map For inquiring about a code context's global settings relating to McodeGrade() operations
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_ABSOLUTE_APERTURE_SIZE +

Inquires the absolute size (diameter) of the aperture.

This inquire type is available for all 1D, 2D cross-row, and composite code types. SET

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

Specifies the default value; the default value is 0.

Click to summarize Value >= 0

Specifies the absolute aperture size, relative to the input coordinate system specified using M_ABSOLUTE_APERTURE_SIZE_INPUT_UNITS.

Click to summarize M_ABSOLUTE_APERTURE_SIZE_INPUT_UNITS +

Inquires the units with which to interpret the M_ABSOLUTE_APERTURE_SIZE inquire type.

This inquire type is available for all 1D, 2D cross-row, and composite code types. SET

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

Same as M_PIXEL.

Click to summarize M_PIXEL

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

Click to summarize M_WORLD

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

Click to summarize M_APERTURE_MODE +

Inquires the mode to use to determine the aperture size.

This inquire type is available for all 1D, 2D cross-row, and composite code types. SET

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

Same as M_RELATIVE.

Click to summarize M_ABSOLUTE

Specifies to use the absolute aperture size, set using M_ABSOLUTE_APERTURE_SIZE.

Click to summarize M_DISABLE

Specifies to disable the aperture. INFO

Click to summarize 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).

Click to summarize 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). The specifications of a code's quiet zone are dependent upon the code type. SET

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

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies to disable the additional reflectance check.

Click to summarize M_ENABLE

Specifies to enable the additional reflectance check. INFO

Click to summarize M_GRADING_STANDARD +

Inquires the standard used when performing a grading operation. SET

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

Specifies the ISO/IEC TR 29158:2011 specification. INFO

Click to summarize M_ISO_GRADING

Specifies the ISO standard.

Click to summarize M_INSPECTION_BAND_RATIO +

Inquires the height of the inspection band as a percentage of the average bar height.

This inquire type is only available for 1D code types and 2D cross-row code types. SET

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

Specifies the default percentage. INFO

Click to summarize 0.0 < Value < 100.0

Specifies the percentage of the average bar height used as the height of the inspection band.

Click to summarize M_MAXIMUM_CALIBRATED_REFLECTANCE +

Inquires the maximum possible grayscale value in the target image. SET

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

Specifies the default value; the default value is 255.

Click to summarize 0 <= Value <= 255

Specifies the maximum calibrated reflectance. INFO

Click to summarize 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). This value is usually equivalent to the mean light value of the reference code used during the reflectance calibration phase.

This inquire type is only available for Data Matrix, QR code, and Micro QR code types. SET SET

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

Specifies the default value. INFO

Click to summarize 0 <= Value <= 255

Specifies the mean intensity. INFO

Click to summarize M_MINIMUM_CALIBRATED_REFLECTANCE +

Inquires the minimum possible grayscale value in the target image. SET

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

Specifies the default value; the default value is 0.

Click to summarize 0 <= Value <= 255

Specifies the minimum calibrated reflectance. INFO

Click to summarize 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.

This inquire type is only available for 1D code types and 2D cross-row code types. SET

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

Specifies the default value. INFO

Click to summarize M_ALL

Specifies to use all possible scanlines inside the inspection band.

Click to summarize Value > 0

Specifies the number of scanlines to inspect. INFO

Click to summarize M_PIXEL_SIZE_IN_MM +

Inquires the scale between a pixel and its physical measurement, in millimeters per pixel units.

This inquire type is only available for all 1D, 2D cross-row, and composite code types. SET

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

Same as M_UNKNOWN.

Click to summarize M_UNKNOWN

Specifies that the scale between a pixel and its physical measurement is not known, in mm per pixel units.

Click to summarize Value > 0

Specifies the scale between a pixel and its physical measurement, in mm per pixel units.

Click to summarize M_REFLECTANCE_CALIBRATION +

Inquires the expected reflectance value of the codes to inspect during the target verification phase (Rcal). This value is usually equivalent to the reflectance value of the reference code used during the reflectance calibration phase.

This inquire type is only available for Data Matrix, QR code, and Micro QR code types. SET SET

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

Specifies the default value. INFO

Click to summarize 0 <= Value <= 255

Specifies the reflectance value. INFO

Click to summarize M_RELATIVE_APERTURE_FACTOR +

Inquires the relative aperture factor.

This inquire type is only available for 1D, 2D matrix, 2D cross-row, and composite code types. SET

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

Same as M_AUTO.

Click to summarize 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

Click to summarize 0 <= Value <= 2

Specifies the aperture factor.

Click to summarize M_SYSTEM_RESPONSE_CALIBRATION +

Inquires the System Response value associated with the reference code (SRcal).

This inquire type is only available for 1D, Data Matrix, QR code, and Micro QR code types. SET

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

Specifies the default value. INFO

Click to summarize Value > 0.0

Specifies the System Response value for the reference code.

Click to summarize M_SYSTEM_RESPONSE_TARGET +

Inquires the System Response value associated with the target code (SRtarget).

This inquire type is only available for Data Matrix, QR code, and Micro QR code types. SET

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

Specifies the default value. INFO

Click to summarize 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.

function map For inquiring about a code context's global settings relating to McodeRead() and McodeGrade() operations
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_INITIALIZATION_MODE +

Inquires the initialization mode for the code context. SET

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

Same as M_TYPICAL_RECOGNITION.

Click to summarize M_IMPROVED_RECOGNITION

Specifies a code context that might provide a more robust read or grade operation. INFO

Click to summarize M_TYPICAL_RECOGNITION

Specifies a code context that might provide a quicker read or grade operation.

Click to summarize M_MINIMUM_CONTRAST +

Inquires the minimum possible contrast between the foreground and background in the target image.

This inquire type is only available for 1D codes (excluding Planet and Postnet) when using the M_ADAPTIVE threshold mode. SET

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

Specifies the default value; the default value is 50.

Click to summarize 1 <= Value <= 255

Specifies the minimum contrast. INFO

Click to summarize M_SCANLINE_HEIGHT +

Inquires the scanline height (or thickness).

This inquire type is only available for 1D code types, Micro PDF417, and composite code types. SET

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

Specifies that the scanline height is based on the value of M_SPEED.

Click to summarize Value

Specifies the scanline height, relative to the input coordinate system specified using M_SCANLINE_INPUT_UNITS. INFO

Click to summarize M_SCANLINE_INPUT_UNITS +

Inquires the units with which to interpret the M_SCANLINE_STEP and M_SCANLINE_HEIGHT inquire types.

This inquire type is only available for 1D code types, Micro PDF417, and composite code types. SET

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

Same as M_PIXEL.

Click to summarize M_PIXEL

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

Click to summarize M_WORLD

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

Click to summarize M_SCANLINE_STEP +

Inquires the scanline step (or interval).

This inquire type is only available for 1D code types, Micro PDF417, and composite code types. SET

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

Specifies that the scanline step is based on the value of M_SPEED. INFO

Click to summarize Value

Specifies the scanline step, relative to the input coordinate system specified using M_SCANLINE_INPUT_UNITS. INFO

Click to summarize M_SEARCH_ANGLE_MODE +

Inquires whether the search angular range algorithm for the code context is enabled. SET

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

Same as M_ENABLE.

Click to summarize M_DISABLE

Specifies that the search angular range algorithm is not used.

Click to summarize M_ENABLE

Specifies that the search angular range algorithm is used.

Click to summarize M_SPEED +

Inquires the search speed. SET

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

Specifies the default value. INFO

Click to summarize M_HIGH

Specifies a high search speed.

Click to summarize M_LOW

Specifies a low search speed.

Click to summarize M_MEDIUM

Specifies a medium search speed.

Click to summarize M_VERY_HIGH

Specifies a very high search speed.

Click to summarize M_VERY_LOW

Specifies a very low search speed.

Click to summarize M_THRESHOLD_MODE +

Inquires the threshold mode used to internally binarize the source image. SET

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

Specifies the default value. INFO

Click to summarize M_ADAPTIVE

Specifies to use a fast dynamic local threshold. INFO

Click to summarize M_GLOBAL_SEGMENTATION

Specifies to use a global threshold value. INFO

Click to summarize 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

Click to summarize M_THRESHOLD_VALUE +

Inquires the threshold value used to internally binarize the source image, depending on the threshold mode. SET

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

Same as M_AUTO_COMPUTE.

Click to summarize M_AUTO_COMPUTE

Specifies the threshold value automatically.

Click to summarize 0 <= Value <= 255

Specifies the threshold value. INFO

Click to summarize M_TIMEOUT +

Inquires the maximum decoding time for a read or grading operation, in msec. SET

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

Specifies the default value; the default value is 2000 msec.

Click to summarize M_DISABLE

Specifies that there is no maximum decoding time.

Click to summarize Value >= 0

Specifies the maximum decoding time, in msec.

To get the code type of a code model, select the following.

function map For inquiring about a code model's code type
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_CODE_TYPE +

Inquires the code type of the specified model. SET

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

Specifies a 4-state code type.

Click to summarize M_AZTEC

Specifies an Aztec code type. INFO

Click to summarize M_BC412

Specifies a BC412 code type.

Click to summarize M_CODABAR

Specifies a Codabar code type.

Click to summarize M_CODE39

Specifies a Code 39 code type.

Click to summarize M_CODE93

Specifies a Code 93 code type.

Click to summarize M_CODE128

Specifies a Code 128 code type.

Click to summarize M_COMPOSITECODE

Specifies a composite code type. INFO

Click to summarize M_DATAMATRIX

Specifies a Data Matrix code type. INFO

Click to summarize M_EAN8

Specifies an EAN 8 code type.

Click to summarize M_EAN13

Specifies an EAN 13 code type.

Click to summarize M_EAN14

Specifies an EAN 14 code type.

Click to summarize M_GS1_128

Specifies a GS1-128 code type.

Click to summarize M_GS1_DATABAR

Specifies a GS1 Databar code type.

Click to summarize M_INDUSTRIAL25

Specifies an Industrial 2 of 5 (standard 2 of 5) code type.

Click to summarize M_INTERLEAVED25

Specifies an Interleaved 25 (ITF-14) code type. INFO

Click to summarize M_MAXICODE

Specifies a Maxicode code type. INFO

Click to summarize M_MICROPDF417

Specifies a MicroPDF417 code type. INFO

Click to summarize M_MICROQRCODE

Specifies a Micro QR code type. INFO

Click to summarize M_PDF417

Specifies a PDF417 code type. INFO

Click to summarize M_PHARMACODE

Specifies a Pharmacode code type.

Click to summarize M_PLANET

Specifies a Planet code type.

Click to summarize M_POSTNET

Specifies a Postnet code type.

Click to summarize M_QRCODE

Specifies a QR code type. INFO

Click to summarize M_TRUNCATED_PDF417

Specifies a Truncated PDF417 code type. INFO

Click to summarize M_UPC_A

Specifies a UPC-A code type.

Click to summarize 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.

function map For inquiring about a code model's settings relating to McodeRead() operations
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_CHECK_QUIET_ZONE +

Inquires whether the presence of the quiet zone is necessary for a successful read operation of this code type.

Note that the specifications of a code's quiet zone are dependent upon the code type. SET

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

Same as M_ENABLE.

Click to summarize M_DISABLE

Specifies that a quiet zone is not necessary. INFO

Click to summarize M_ENABLE

Specifies that a quiet zone is necessary.

Click to summarize M_ECC_CORRECTED_NUMBER +

Inquires whether or not a more robust read operation will be performed.

This inquire type is only available for PDF417 and Truncated PDF417 code types. SET

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

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies not to perform a more robust read operation.

Click to summarize M_ENABLE

Specifies to perform a more robust read operation.

Click to summarize M_NUMBER +

Inquires the maximum number of codes to be read for the specified code model. This number is also limited by M_TOTAL_NUMBER.

Only 1D code types (excluding GS1 Databar, 4-state, Planet, and Postnet code types) and the 2D Data Matrix code type support searching for multiple occurrences. SET

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

Specifies the default value; the default value is 1.

Click to summarize M_ALL

Specifies that all code model occurrences are read up to the maximum number limited by M_TOTAL_NUMBER.

Click to summarize Value >= 0

Specifies the maximum number of codes to read for the specified code model. INFO

Click to summarize M_POSITION_ACCURACY +

Inquires the positional accuracy of the read operation. SET

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

Same as M_LOW.

Click to summarize M_HIGH

Specifies to report the positional results of code read operations with high accuracy.

Click to summarize 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.

function map For inquiring about a code model's settings relating to McodeRead() and McodeGrade() operations
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_BEARER_BAR +

Inquires whether bearer bars surround the codes to read. SET

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

Same as M_ABSENT.

Click to summarize M_ABSENT

Specifies that no bearer bars are above and below the code.

Click to summarize M_PRESENT

Specifies that there are bearer bars above and below the code.

Click to summarize M_CELL_NUMBER_X_MAX +

Inquires the maximum number of cells for which to search in the X-direction.

This inquire type is only available for Data Matrix code types. SET

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

Same as M_ANY.

Click to summarize M_ANY

Specifies to search for codes with any number of cells.

Click to summarize Value > 0

Specifies the maximum number of cells for which to search. INFO

Click to summarize M_CELL_NUMBER_X_MIN +

Inquires the minimum number of cells for which to search in the X-direction.

This inquire type is only available for Data Matrix code types. SET

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

Same as M_ANY.

Click to summarize M_ANY

Specifies to search for codes with any number of cells.

Click to summarize Value > 0

Specifies the minimum number of cells for which to search. INFO

Click to summarize M_CELL_NUMBER_Y_MAX +

Inquires the maximum number of cells for which to search in the Y-direction.

This inquire type is only available for Data Matrix code types. SET

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

Same as M_ANY.

Click to summarize M_ANY

Specifies to search for codes with any number of cells.

Click to summarize Value > 0

Specifies the maximum number of cells for which to search. INFO

Click to summarize M_CELL_NUMBER_Y_MIN +

Inquires the minimum number of cells for which to search in the Y-direction.

This inquire type is only available for Data Matrix code types. SET

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

Same as M_ANY.

Click to summarize M_ANY

Specifies to search for codes with any number of cells.

Click to summarize Value > 0

Specifies the minimum number of cells for which to search. INFO

Click to summarize M_CHECK_FINDER_PATTERN +

Inquires whether or not the check for false Data Matrix codes is enabled.

This inquire type is only available for Data Matrix code types. SET

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

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that the Code module will not check for false Data Matrix code types.

Click to summarize M_ENABLE

Specifies that the Code module will check for false Data Matrix code types.

Click to summarize M_CODE_FLIP +

Inquires whether the code should be flipped or read in the opposite direction to be read properly. SET

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

Specifies the default value. INFO

Click to summarize M_ANY

Allows MIL to decide whether the code needs to be flipped or read in the opposite direction to be read properly.

Click to summarize M_FLIP

Specifies that the code needs to be flipped or read in the opposite direction to be read properly. INFO

Click to summarize M_NO_FLIP

Specifies that the code does not need to be flipped or read in the opposite direction. INFO

Click to summarize M_DISTORTION +

Inquires the distortion compensation algorithm needed to read the code properly.

This inquire type is only available for Data Matrix and QR code types. SET

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

Specifies the default value. INFO

Click to summarize M_NONE

Specifies not to use distortion compensation.

Click to summarize 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

Click to summarize M_UNEVEN_GRID_STEP

Specifies to use an algorithm that reads or grades M_AZTEC, M_DATAMATRIX, or M_QRCODE types that have different column widths or row heights and/or slight perspective distortion.

Click to summarize M_DOT_SPACING_INPUT_UNITS +

Inquires the units with which to interpret the M_DOT_SPACING_MAX and M_DOT_SPACING_MIN inquire types.

This inquire type is only available for Aztec, Data Matrix, and QR code types. SET

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

Same as M_PIXEL.

Click to summarize M_PIXEL

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

Click to summarize M_WORLD

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

Click to summarize M_DOT_SPACING_MAX +

Inquires the maximum distance between 2 dots in a matrix code composed of dots.

This inquire type is only available for Aztec, Data Matrix, and QR code types. SET

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

Specifies the default value. INFO

Click to summarize -256 <= Value <= 256

Specifies the distance, relative to the input coordinate system specified using M_DOT_SPACING_INPUT_UNITS. INFO

Click to summarize M_DOT_SPACING_MIN +

Inquires the minimum distance between 2 dots in a matrix code composed of dots.

This inquire type is only available for Aztec, Data Matrix, and QR code types. SET

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

Specifies the default value. INFO

Click to summarize -256 <= Value <= 256

Specifies the distance, relative to the input coordinate system specified using M_DOT_SPACING_INPUT_UNITS. INFO

Click to summarize M_FINDER_PATTERN_EXHAUSTIVE_SEARCH +

Inquires whether an exhaustive search is to be used.

This inquire type is only available for Data Matrix code types. SET

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

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies to not perform an exhaustive search.

Click to summarize M_ENABLE

Specifies to perform an exhaustive search.

Click to summarize 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.

This inquire type is only available for Data Matrix code types. SET

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

Same as M_PIXEL.

Click to summarize M_PIXEL

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

Click to summarize M_WORLD

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

Click to summarize M_FINDER_PATTERN_MAX_GAP +

Inquires the maximum tolerable gap in the finder pattern of a Data Matrix code.

This inquire type is only available for Data Matrix code types. SET

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

Same as M_AUTO.

Click to summarize 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.

Click to summarize Value

Specifies the maximum gap allowed, in input units specified using M_FINDER_PATTERN_INPUT_UNITS.

Click to summarize M_FINDER_PATTERN_MINIMUM_LENGTH +

Inquires the shortest acceptable length of either "arm" of the finder pattern of a Data Matrix code.

This inquire type is only available for Data Matrix code types. SET

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

Same as M_AUTO.

Click to summarize M_AUTO

Specifies that the minimum acceptable finder pattern "arm" length is 6 times the minimum cell size specified using M_CELL_SIZE_MIN.

Click to summarize Value

The minimum acceptable finder pattern "arm" length, in input units specified using M_FINDER_PATTERN_INPUT_UNITS.

Click to summarize M_SEARCH_ANGLE +

Inquires the nominal search angle. SET

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

Specifies the default value; the default value is 0.0 degrees.

Click to summarize M_ACCORDING_TO_REGION

Specifies that the nominal angle is set to the angle of the target image's ROI (MbufSetRegion()); Recall that for McodeGrade() and McodeRead(), the ROI must be rectangular. INFO

Click to summarize 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

Click to summarize M_SEARCH_ANGLE_DELTA_NEG +

Inquires the negative angle range of the search. SET

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

Specifies the default value. INFO

Click to summarize 0.0 <= Value <= 180.0

Specifies a negative angular range, in degrees, relative to the nominal angle set by M_SEARCH_ANGLE. INFO

Click to summarize M_SEARCH_ANGLE_DELTA_POS +

Inquires the positive angle range of the search. SET

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

Specifies the default value. INFO

Click to summarize 0.0 <= Value <= 180.0

Specifies a positive angular range, in degrees, relative to the nominal angle set by M_SEARCH_ANGLE. INFO

Click to summarize M_SEARCH_ANGLE_INPUT_UNITS +

Inquires the units with which to interpret the M_SEARCH_ANGLE inquire type. SET

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

Same as M_PIXEL.

Click to summarize M_PIXEL

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

Click to summarize M_WORLD

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

Click to summarize M_SEARCH_ANGLE_STEP +

Inquires the angle increment/decrement used when searching for a 1D code through an angular range. SET

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

Same as M_DISABLE.

Click to summarize M_DISABLE

Specifies that no explicit increment/decrement is used. INFO

Click to summarize 0.1 <= Value <= 180.0

Specifies the explicit angle increment/decrement, in degrees.

Click to summarize M_STRING_SIZE_MAX +

Inquires the maximum size (number of characters) of the string encoded in the code. SET

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

Same as M_ANY.

Click to summarize M_ANY

Specifies that there is no maximum string size.

Click to summarize 0 <= Value <= 65535

Specifies the maximum string size. INFO

Click to summarize M_STRING_SIZE_MIN +

Inquires the minimum size (number of characters) of the string encoded in the code. SET

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

Same as M_ANY.

Click to summarize M_ANY

Specifies that there is no minimum string size.

Click to summarize 0 <= Value <= 65535

Specifies the minimum string size. INFO

Click to summarize M_SUB_TYPE +

Inquires the particular codes in a family of codes for which to search. SET

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

Same as M_ANY.

Click to summarize M_ANY

Specifies to search for all of the code sub-types that can be specified for M_SUB_TYPE. INFO

Click to summarize M_EAN8

Specifies that the EAN 8 code sub-type is enabled. INFO

Click to summarize M_EAN13

Specifies that the EAN 13 code sub-type is enabled. INFO

Click to summarize M_GS1_128

Specifies that the GS1-128 code sub-type is enabled. INFO

Click to summarize M_GS1_DATABAR_EXPANDED

Specifies that the GS1 Databar Expanded code sub-type is enabled. INFO

Click to summarize M_GS1_DATABAR_EXPANDED_STACKED

Specifies that the GS1 Databar Expanded Stacked code sub-type is enabled. INFO

Click to summarize M_GS1_DATABAR_LIMITED

Specifies that the GS1 Databar Limited code sub-type is enabled. INFO

Click to summarize M_GS1_DATABAR_OMNI

Specifies that the GS1 Databar omni code sub-type is enabled. INFO

Click to summarize M_GS1_DATABAR_STACKED

Specifies that the GS1 Databar Stacked code sub-type is enabled. INFO

Click to summarize M_GS1_DATABAR_STACKED_OMNI

Specifies that the GS1 Databar Stacked Omni code sub-type is enabled. INFO

Click to summarize M_GS1_DATABAR_TRUNCATED

Specifies that the GS1 Databar Truncated code sub-type is enabled. INFO

Click to summarize M_UPC_A

Specifies that the UPC-A code sub-type is enabled. INFO

Click to summarize M_UPC_E

Specifies that the UPC-E code sub-type is enabled. INFO

Click to summarize M_USE_PRESEARCH +

Inquires whether the localization operation is performed prior to read and grading operations.

This inquire type is only available for 2D code types. SET

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

Specifies the default value. INFO

Click to summarize M_DISABLE

Specifies that the operation is not performed.

Click to summarize 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

Click to summarize 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.

function map For inquiring about a code model's settings relating to McodeRead(), McodeGrade(), and McodeWrite() operations
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_CELL_NUMBER_X +

Inquires the number of cells to be used in the X-direction.

This inquire type is only available for 2D code types. SET

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

Same as M_ANY.

Click to summarize M_ANY

Specifies to search for a code with any number of cells, when performing an McodeRead() or McodeGrade() operation. INFO

Click to summarize Value > 0

Specifies the number of cells. INFO

Click to summarize M_CELL_NUMBER_Y +

Inquires the number of cells to be used in the Y-direction.

This inquire type is only available for 2D code types. SET

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

Same as M_ANY.

Click to summarize M_ANY

Specifies to search for a code with any number of cells, when performing an McodeRead() or McodeGrade() operation. INFO

Click to summarize Value > 0

Specifies the number of cells. INFO

Click to summarize 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

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

Same as M_PIXEL.

Click to summarize M_PIXEL

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

Click to summarize M_WORLD

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

Click to summarize M_CELL_SIZE_MAX +

Inquires the maximum cell size. SET

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

Specifies to select an appropriate size, automatically.

Click to summarize Value

Specifies the maximum cell size, relative to the input coordinate system specified using M_CELL_SIZE_INPUT_UNITS. INFO

Click to summarize M_CELL_SIZE_MIN +

Inquires the minimum cell size. SET

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

Specifies the default cell size, in pixels. INFO

Click to summarize Value

Specifies the minimum cell size, relative to the input coordinate system specified using M_CELL_SIZE_INPUT_UNITS. INFO

Click to summarize M_DATAMATRIX_SHAPE +

Inquires the shape of the Data Matrix code. SET

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

Same as M_ANY.

Click to summarize M_ANY

Specifies that the Data Matrix code type can be any shape.

Click to summarize M_RECTANGLE

Specifies that the Data Matrix code has a rectangular shape. INFO

Click to summarize M_SQUARE

Specifies that the Data Matrix has a square shape.

Click to summarize M_ENCODING +

Inquires the type of encoding scheme. SET

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

Specifies to use the default encoding scheme for the code type. INFO

Click to summarize M_ANY

Specifies any type of encoding scheme. INFO

Click to summarize M_ENC_ALPHA

Specifies an encoding scheme that supports uppercase alphabetical characters, along with the space. INFO

Click to summarize M_ENC_ALPHANUM

Specifies an encoding scheme that supports alphanumeric characters, as well as the space. INFO

Click to summarize M_ENC_ALPHANUM_PUNC

Specifies a similar encoding scheme to M_ENC_ALPHANUM, except it also supports the following characters: (,), (-), (/) and (. INFO

Click to summarize M_ENC_ASCII

Specifies an encoding scheme that supports ASCII characters. INFO

Click to summarize 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

Click to summarize 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

Click to summarize M_ENC_AUSTRALIA_MAIL_RAW

Specifies an encoding scheme for a 4-state format used by the Australian Mail service. INFO

Click to summarize M_ENC_AZTEC_COMPACT

Specifies an encoding scheme for a compact Aztec code. INFO

Click to summarize M_ENC_AZTEC_FULL_RANGE

Specifies an encoding scheme for a full-range (not compact) Aztec code. INFO

Click to summarize M_ENC_AZTEC_RUNE

Specifies an encoding scheme for an Aztec rune (the smallest version of an Aztec code). INFO

Click to summarize 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

Click to summarize 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

Click to summarize 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

Click to summarize M_ENC_EAN13_ADDON

Specifies an encoding scheme for an EAN-13 format with a supplemental 2 or 5 digit add-on. INFO

Click to summarize 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

Click to summarize 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

Click to summarize M_ENC_GS1_DATABAR_EXPANDED

Specifies an encoding scheme that uses a GS1 Databar format. INFO

Click to summarize M_ENC_GS1_DATABAR_EXPANDED_STACKED

Specifies an encoding scheme that uses a GS1 Databar Expanded Stacked format. INFO

Click to summarize M_ENC_GS1_DATABAR_LIMITED

Specifies an encoding scheme that uses a GS1 Databar Limited format. INFO

Click to summarize M_ENC_GS1_DATABAR_OMNI

Specifies an encoding scheme that uses a GS1 Databar format. INFO

Click to summarize M_ENC_GS1_DATABAR_STACKED

Specifies an encoding scheme that uses a GS1 Databar Stacked format. INFO

Click to summarize M_ENC_GS1_DATABAR_STACKED_OMNI

Specifies an encoding scheme that uses a GS1 Databar Stacked Omni format. INFO

Click to summarize M_ENC_GS1_DATABAR_TRUNCATED

Specifies an encoding scheme that uses a GS1 Databar Truncated format. INFO

Click to summarize M_ENC_ISO8

Specifies a similar encoding scheme as M_ENC_ASCII, but supports the extended ASCII character set. INFO

Click to summarize M_ENC_KOREA_MAIL

Specifies an encoding scheme for a 4-state format used by the Korean Mail service. INFO

Click to summarize M_ENC_MODE2

Specifies an encoding scheme that requires a Structured Carrier Message. INFO

Click to summarize M_ENC_MODE3

Specifies an encoding scheme that requires a Structured Carrier Message. INFO

Click to summarize M_ENC_MODE4

Specifies an encoding scheme that requires a Free Format Message. INFO

Click to summarize M_ENC_MODE5

Specifies an encoding scheme that requires a Free Format Message. INFO

Click to summarize M_ENC_MODE6

Specifies an encoding scheme that requires a Free Format Message. INFO

Click to summarize M_ENC_NUM

Specifies an encoding scheme that only supports numbers. INFO

Click to summarize M_ENC_QRCODE_MODEL1

Specifies an encoding scheme that uses an older version of the QR code format. INFO

Click to summarize M_ENC_QRCODE_MODEL2

Specifies an encoding scheme that uses a newer version of the QR code format. INFO

Click to summarize M_ENC_STANDARD

Specifies different types of encoding schemes, depending on what code type is used. INFO

Click to summarize M_ENC_UK_MAIL

Specifies an encoding scheme for a 4-state format used by the UK Mail service. INFO

Click to summarize 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

Click to summarize M_ENC_UPCA_ADDON

Specifies an encoding scheme for an UPC-A format with a supplemental 2 or 5 digit add-on. INFO

Click to summarize 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

Click to summarize M_ENC_UPCE_ADDON

Specifies an encoding scheme for an UPC_E format with a supplemental 2 or 5 digit add-on. INFO

Click to summarize M_ENC_US_MAIL

Specifies an encoding scheme for a 4-state format used by the US Mail service. INFO

Click to summarize 5 <= Value <= 95

Specifies the minimum amount of the symbol that contains error correction information, as a percentage. INFO

Click to summarize M_ERROR_CORRECTION +

Inquires the type of error correction. SET

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

Specifies to use the default error correction scheme for the code type. INFO

Click to summarize M_ANY

Specifies that the error correction type for read and grading operations is detected automatically. INFO

Click to summarize 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

Click to summarize M_ECC_200

Specifies to use a Reed Solomon-based algorithm as an error correction scheme. INFO

Click to summarize M_ECC_CHECK_DIGIT

Specifies to use an additional digit to check whether there is an error or not. INFO

Click to summarize M_ECC_COMPOSITE

Specifies to use the default error correction scheme for the 1D and 2D portions of the composite code. INFO

Click to summarize M_ECC_H

Specifies to use the highest-level error correction scheme. INFO

Click to summarize M_ECC_L

Specifies to use the lowest-level error correction scheme. INFO

Click to summarize M_ECC_M

Specifies to use a medium-low level error correction scheme. INFO

Click to summarize M_ECC_n

Specifies an error correction algorithm that uses convolution coding. INFO

Click to summarize M_ECC_NONE

Specifies no error correction. INFO

Click to summarize M_ECC_Q

Specifies to use a medium-high level error correction scheme. INFO

Click to summarize M_ECC_REED_SOLOMON

Specifies to use a Reed Solomon type of error correction scheme. INFO

Click to summarize M_ECC_REED_SOLOMON_n

Specifies to use a Reed Solomon type of error correction scheme. INFO

Click to summarize 5 <= Value <= 95

Specifies the minimum percentage of the symbol that contains error correction information. INFO

Click to summarize M_FOREGROUND_VALUE +

Inquires the foreground color of the code. SET

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

Specifies the default value. INFO

Click to summarize M_FOREGROUND_ANY

Specifies the foreground color as black or white. INFO

Click to summarize M_FOREGROUND_BLACK

Specifies that the foreground color is black.

Click to summarize M_FOREGROUND_WHITE

Specifies that the foreground color is white.

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

function map For inquiring whether an inquire type is supported
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_SUPPORTED

Inquires whether the specified inquire type is supported.

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

Specifies that the inquire type is not supported.

Click to summarize Value != 0

Specifies that the inquire type is supported.

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.

function map For inquiring about a code model's settings relating to McodeWrite() operations
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_WRITE_CELL_NUMBER_X +

Inquires the number of cells in the X-direction required to encode the string passed to a write operation.

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

Specifies the number of cells in the X-direction.

Click to summarize M_WRITE_CELL_NUMBER_Y +

Inquires the number of cells in the Y-direction required to encode the string passed to a write operation.

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

Specifies the number of cells in the Y-direction.

Click to summarize M_WRITE_SIZE_X +

Inquires the minimum width required for the destination image of a write operation.

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

Specifies the minimum width.

Click to summarize M_WRITE_SIZE_Y +

Inquires the minimum height required for the destination image of a write operation.

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

Specifies the minimum height.

To inquire about code result buffer settings, set the InquireType parameter to one of the following values.

function map For result buffers
Click to summarize
InquireType
Description
UserVarPtr
- Possible values returned
Click to summarize M_RESULT_OUTPUT_UNITS +

Inquires the units with which to interpret the results. SET

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

Same as M_ACCORDING_TO_CALIBRATION.

Click to summarize M_ACCORDING_TO_CALIBRATION

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

Click to summarize M_PIXEL

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

Click to summarize M_WORLD

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

Click to summarize M_STRING_FORMAT +

Inquires the format in which the string is returned after the read operation. SET

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

Same as M_AUTO_FORMAT.

Click to summarize M_AUTO_FORMAT

Specifies that the returned string is in the string format associated with the code type.

Click to summarize M_GS1_HUMAN_READABLE

Specifies that the returned string is in a format that is human-readable. INFO

Click to summarize M_GS1_RAW_DATA

Specifies that the returned string is in a raw data format. INFO

Click to summarize M_JAPANESE

Specifies that the returned string uses Japanese (Windows-932) encoding. INFO

Click to summarize M_KOREAN

Specifies that the returned string uses Korean (Windows-949) encoding. INFO

Click to summarize M_LATIN

Specifies that the returned string uses Latin (Windows-1252) encoding. INFO

Click to summarize M_SIMPLIFIED_CHINESE

Specifies that the returned string uses Simplified Chinese (Windows-936) encoding. INFO

Click to summarize M_UPCE_COMPRESSED

Specifies that the returned string is in the UPCE compressed string format. INFO

Click to summarize M_UTF8

Specifies that the returned string is in the UTF-8 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.

function map For inquiring about the system
Click to summarizeInquireType Description
UserVarPtr
- Possible values returned
Click to summarize M_OWNER_SYSTEM +

Inquires the identifier of the system on which the code context or code result has been allocated. SET SET

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_DOUBLE (more details...)
Click to summarize M_DEFAULT_HOST

Specifies the default Host system of the current MIL application.

Click to summarize MIL system identifier

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

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

function map For specifying the data type
Click to summarizeInquireType Description
UserVarPtr
- Possible values returned
Click to summarize M_TYPE_MIL_DOUBLE

Casts the requested data to a MIL_DOUBLE.

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

Casts the requested data to a MIL_ID.

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

Casts the requested data to a MIL_INT.

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

Casts the requested data to a MIL_INT32.

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

Casts the requested data to a MIL_INT64.

(summarize)
Expand data type infoCollapse data type info UserVarPtr extra info
Data type info: Data type: address of a MIL_INT64
Return value
The returned value is the requested information, cast to a MIL_INT. If the requested information does not fit into a MIL_INT, this function will return M_NULL or truncate the information.
Compilation information
Header Include mil.h.
Library Use mil.lib; milcode.lib.
DLL Requires mil.dll; milcode.dll.
NUMBER OF CODE MODELS TOTAL NUMBER DEFAULT ALL DEFAULT ABSOLUTE APERTURE SIZE DEFAULT ABSOLUTE APERTURE SIZE INPUT UNITS DEFAULT PIXEL WORLD APERTURE MODE DEFAULT ABSOLUTE DISABLE RELATIVE EXTENDED AREA REFLECTANCE CHECK DEFAULT DISABLE ENABLE GRADING STANDARD AIMDPM GRADING ISO GRADING INSPECTION BAND RATIO DEFAULT MAXIMUM CALIBRATED REFLECTANCE DEFAULT MEAN LIGHT CALIBRATION DEFAULT MINIMUM CALIBRATED REFLECTANCE DEFAULT NUMBER OF SCANLINES DEFAULT ALL PIXEL SIZE IN MM DEFAULT UNKNOWN REFLECTANCE CALIBRATION DEFAULT RELATIVE APERTURE FACTOR DEFAULT AUTO SYSTEM RESPONSE CALIBRATION DEFAULT SYSTEM RESPONSE TARGET DEFAULT INITIALIZATION MODE DEFAULT IMPROVED RECOGNITION TYPICAL RECOGNITION MINIMUM CONTRAST DEFAULT SCANLINE HEIGHT DEFAULT SCANLINE INPUT UNITS DEFAULT PIXEL WORLD SCANLINE STEP DEFAULT SEARCH ANGLE MODE DEFAULT DISABLE ENABLE SPEED DEFAULT HIGH LOW MEDIUM VERY HIGH VERY LOW THRESHOLD MODE DEFAULT ADAPTIVE GLOBAL SEGMENTATION GLOBAL WITH LOCAL RESEGMENTATION THRESHOLD VALUE DEFAULT AUTO COMPUTE TIMEOUT DEFAULT DISABLE CODE TYPE 4 STATE AZTEC BC412 CODABAR CODE39 CODE93 CODE128 COMPOSITECODE DATAMATRIX EAN8 EAN13 EAN14 GS1 128 GS1 DATABAR INDUSTRIAL25 INTERLEAVED25 MAXICODE MICROPDF417 MICROQRCODE PDF417 PHARMACODE PLANET POSTNET QRCODE TRUNCATED PDF417 UPC A UPC E CHECK QUIET ZONE DEFAULT DISABLE ENABLE ECC CORRECTED NUMBER DEFAULT DISABLE ENABLE NUMBER DEFAULT ALL POSITION ACCURACY DEFAULT HIGH LOW BEARER BAR DEFAULT ABSENT PRESENT CELL NUMBER X MAX DEFAULT ANY CELL NUMBER X MIN DEFAULT ANY CELL NUMBER Y MAX DEFAULT ANY CELL NUMBER Y MIN DEFAULT ANY CHECK FINDER PATTERN DEFAULT DISABLE ENABLE CODE FLIP DEFAULT ANY FLIP NO FLIP DISTORTION DEFAULT NONE PERSPECTIVE UNEVEN GRID STEP UNEVEN GRID STEP DOT SPACING INPUT UNITS DEFAULT PIXEL WORLD DOT SPACING MAX DEFAULT DOT SPACING MIN DEFAULT FINDER PATTERN EXHAUSTIVE SEARCH DEFAULT DISABLE ENABLE FINDER PATTERN INPUT UNITS DEFAULT PIXEL WORLD FINDER PATTERN MAX GAP DEFAULT AUTO FINDER PATTERN MINIMUM LENGTH DEFAULT AUTO SEARCH ANGLE DEFAULT ACCORDING TO REGION SEARCH ANGLE DELTA NEG DEFAULT SEARCH ANGLE DELTA POS DEFAULT SEARCH ANGLE INPUT UNITS DEFAULT PIXEL WORLD SEARCH ANGLE STEP DEFAULT DISABLE STRING SIZE MAX DEFAULT ANY STRING SIZE MIN DEFAULT ANY SUB TYPE DEFAULT ANY EAN8 EAN13 GS1 128 GS1 DATABAR EXPANDED GS1 DATABAR EXPANDED STACKED GS1 DATABAR LIMITED GS1 DATABAR OMNI GS1 DATABAR STACKED GS1 DATABAR STACKED OMNI GS1 DATABAR TRUNCATED UPC A UPC E USE PRESEARCH DEFAULT DISABLE FINDER PATTERN BASE STAT BASE CELL NUMBER X DEFAULT ANY CELL NUMBER Y DEFAULT ANY CELL SIZE INPUT UNITS DEFAULT PIXEL WORLD CELL SIZE MAX DEFAULT CELL SIZE MIN DEFAULT DATAMATRIX SHAPE DEFAULT ANY RECTANGLE SQUARE ENCODING DEFAULT ANY ENC ALPHA ENC ALPHANUM ENC ALPHANUM PUNC ENC ASCII ENC AUSTRALIA MAIL C ENC AUSTRALIA MAIL N ENC AUSTRALIA MAIL RAW ENC AZTEC COMPACT ENC AZTEC FULL RANGE ENC AZTEC RUNE ENC EAN8 ENC EAN8 ADDON ENC EAN13 ENC EAN13 ADDON ENC GS1 128 MICROPDF417 ENC GS1 128 PDF417 ENC GS1 DATABAR EXPANDED ENC GS1 DATABAR EXPANDED STACKED ENC GS1 DATABAR LIMITED ENC GS1 DATABAR OMNI ENC GS1 DATABAR STACKED ENC GS1 DATABAR STACKED OMNI ENC GS1 DATABAR TRUNCATED ENC ISO8 ENC KOREA MAIL ENC MODE2 ENC MODE3 ENC MODE4 ENC MODE5 ENC MODE6 ENC NUM ENC QRCODE MODEL1 ENC QRCODE MODEL2 ENC STANDARD ENC UK MAIL ENC UPCA ENC UPCA ADDON ENC UPCE ENC UPCE ADDON ENC US MAIL ERROR CORRECTION DEFAULT ANY ECC 4STATE ECC 200 ECC CHECK DIGIT ECC COMPOSITE ECC H ECC L ECC M ECC n ECC NONE ECC Q ECC REED SOLOMON ECC REED SOLOMON n FOREGROUND VALUE DEFAULT FOREGROUND ANY FOREGROUND BLACK FOREGROUND WHITE SUPPORTED NULL WRITE CELL NUMBER X WRITE CELL NUMBER Y WRITE SIZE X WRITE SIZE Y RESULT OUTPUT UNITS DEFAULT ACCORDING TO CALIBRATION PIXEL WORLD STRING FORMAT DEFAULT AUTO FORMAT GS1 HUMAN READABLE GS1 RAW DATA JAPANESE KOREAN LATIN SIMPLIFIED CHINESE UPCE COMPRESSED UTF8 OWNER SYSTEM DEFAULT HOST TYPE MIL DOUBLE TYPE MIL ID TYPE MIL INT TYPE MIL INT32 TYPE MIL INT64 M_ECC_n M_ECC_REED_SOLOMON_n