McodeGetResult

Retrieves the identifier of the code model that was used to read or grade the code. Note that this result is not valid when the results buffer is on a remote system. To find out which model was read on a remote system, use M_CODE_MODEL_INDEX instead.

Retrieves the index of the code model, that was used to read or grade the code. Note that the number of codes read can be obtained using McodeGetResult() with M_NUMBER. When dealing with successful grading operations, the number of codes graded is always 1.

Retrieves the code type of the code that was read.

Retrieves the data codewords from the graphical representation of the code. Note that each codeword is returned as a numerical value, rather than as one or more alpha-numeric characters. The returned data codewords could be used to validate the code, as with PDF417, or to allow interpretation of the data codewords using a character set other than the default set supported by MIL. For more information, refer to the Extended Channel Interpretation (ECI) protocol in ISO/IEC 15438:2006.

To retrieve the decoded characters from the code, use M_STRING.

This result type is available for composite codes and 2D code types, with the exception of Data Matrix code types that do not use M_ERROR_CORRECTION with M_ECC_200.

Retrieves the type of encoding.

Note that since some versions of the GS1 Databar code types only differ by the bar height (and not the structure), the same result is returned for these similar code types. GS1 Databar omni and GS1 Databar Truncated will return M_ENC_GS1_DATABAR_OMNI. GS1 Databar Stacked and GS1 Databar Stacked Omnidirectional will return M_ENC_GS1_DATABAR_STACKED.

It is possible to obtain a more accurate result to distinguish between these structurally similar code types, using McodeControl() with M_POSITION_ACCURACY set to M_HIGH.

Retrieves the type of error correction scheme for the code.

Retrieves the bottom-left position along the X-axis of a code read or graded, including the extended area.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the bottom-left position along the Y-axis of a code read or graded, including the extended area.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the bottom-right position along the X-axis of a code read or graded, including the extended area.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the bottom-right position along the Y-axis of a code read or graded, including the extended area.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves whether the quiet zone and the extended area were included when reading or grading the code.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

This result type is only available when M_EXTENDED_AREA_REFLECTANCE_CHECK is enabled.

Retrieves the top-left position along the X-axis of a code read or graded, including the extended area.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the top-left position along the Y-axis of a code read or graded, including the extended area.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the top-right position along the X-axis of a code read or graded, including the extended area.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the top-right position along the Y-axis of a code read or graded, including the extended area.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves whether the code follows the industry standard for a GS1 code.

This result type is available for Aztec, Data Matrix, Code 128, EAN-14, GS1-128, GS1-Databar, QR codes, and composite codes.

Retrieves the number of codes read for all code models in the code context, during the last read or grading operation. Note that multiple occurrences of the same model are counted separately.

Retrieves the number of codewords in the code; this includes data, overhead, and error correction codewords.

This result type is available for composite codes and 2D code types, with the exception of Data Matrix code types that do not use M_ERROR_CORRECTION with M_ECC_200.

Retrieves the number of data codewords in the code.

This result type is available for composite codes and 2D code types, with the exception of Data Matrix code types that do not use M_ERROR_CORRECTION with M_ECC_200.

Retrieves the number of erasures in the code. Erasures are missing or unreadable codewords at known positions.

This result type is available for composite codes and 2D code types, with the exception of Data Matrix code types that do not use M_ERROR_CORRECTION with M_ECC_200.

Retrieves the number of error correction codewords in the code. Error correction can be used to compensate for defects found during the decoding process.

This result type is available for composite codes and 2D code types, with the exception of Data Matrix code types that do not use M_ERROR_CORRECTION with M_ECC_200.

Retrieves the number of errors found in the code. Note that the number of errors does not include the number of erasures.

This result type is available for composite codes and 2D code types, with the exception of Data Matrix code types that do not use M_ERROR_CORRECTION with M_ECC_200.

Retrieves the bottom-left position along the X-axis of a code read or graded, including the quiet zone.

Retrieves the bottom-left position along the Y-axis of a code read or graded, including the quiet zone.

Retrieves the bottom-right position along the X-axis of a code read or graded, including the quiet zone.

Retrieves the bottom-right position along the Y-axis of a code read or graded, including the quiet zone.

Retrieves whether the quiet zone is included in the code.

Retrieves the top-left position along the X-axis of a code read or graded, including the quiet zone.

Retrieves the top-left position along the Y-axis of a code read or graded, including the quiet zone.

Retrieves the top-right position along the X-axis of a code read or graded, including the quiet zone.

Retrieves the top-right position along the Y-axis of a code read or graded, including the quiet zone.

Retrieves the status of a read or grading operation.

It can be helpful to obtain the number of codes read using McodeGetResult() with M_NUMBER, along with inquiring about M_STATUS. For example, if you set a code context to read two code occurrences and only one was found, the status returned is M_STATUS_NOT_FOUND. Calling McodeGetResult() with M_NUMBER will return 1.

Note that when reading multiple code occurrences and more than one read operation fails, the least-common error is returned. For example, if you read two codes and one fails because the code was not found (M_STATUS_NOT_FOUND) and the other fails because the encoding type was unknown (M_STATUS_ENC_UNKNOWN), the latter is returned.

To retrieve the confidence score of a read operation, use M_SCORE. To retrieve the confidence score of a grading operation as a grade, use M_OVERALL_SYMBOL_GRADE.

Retrieves whether the timeout was reached. You can set the timeout limit using McodeControl() with M_TIMEOUT.

Retrieves the angle, in degrees, at which the code was read, relative to the output coordinate system specified using McodeControl() with M_RESULT_OUTPUT_UNITS.

An angle interpreted with respect to the pixel coordinate system is always measured counter-clockwise. For information on the angle's direction of rotation when interpreting the angle with respect to the relative coordinate system, see the Angle convention in MIL subsection of the Working with real-world units section of Chapter 25: Calibrating your camera setup.

For 1D code types, this value is dependent on McodeControl() with M_POSITION_ACCURACY.

Retrieves the X-coordinate of the bottom-left corner of the code that was read.

For 1D code types, this value is dependent on McodeControl() with M_POSITION_ACCURACY.

Retrieves the Y-coordinate of the bottom-left corner of the code that was read.

For 1D code types, this value is dependent on McodeControl() with M_POSITION_ACCURACY.

Retrieves the X-coordinate of the bottom-right corner of the code that was read.

For 1D code types, this value is dependent on McodeControl() with M_POSITION_ACCURACY.

Retrieves the Y-coordinate of the bottom-right corner of the code that was read.

For 1D code types, this value is dependent on McodeControl() with M_POSITION_ACCURACY.

Retrieves the number of cells in the X-direction.

Retrieves the number of cells in the Y-direction.

Retrieves the size of the cell in X (module size (Z)) of the code that was read.

Retrieves whether the code was reversed or not.

Retrieves the foreground color of the code that was read.

Retrieves the X-coordinate of the occurrence. For all types of codes, except the Data Matrix and composite code types, this result is the center of the code in the X-direction. For Data Matrix codes, this result is the center, in the X-direction, of the top-left cell. For composite codes, this result is the center, in the X-direction, of the 1D component of the code. Note that to retrieve the top-left and bottom-right coordinates, use M_BOTTOM... and M_TOP....

For 1D code types, this value is dependent on McodeControl() with M_POSITION_ACCURACY.

Retrieves the Y-coordinate of the occurrence. For all types of codes, except the Data Matrix and composite code types, this result is the center of the code in the Y-direction. For Data Matrix codes, this result is the center, in the Y-direction, of the top-left cell. For composite codes, this result is the center, in the Y-direction, of the 1D component of the code. Note that to retrieve the top-left and bottom-right coordinates, use M_BOTTOM... and M_TOP....

For 1D code types, this value is dependent on McodeControl() with M_POSITION_ACCURACY.

Retrieves the confidence score of a read operation. The code type determines how this value is calculated.

To retrieve the error status of the grading operation, use M_STATUS. To retrieve the confidence score of a grading operation as a grade, use M_OVERALL_SYMBOL_GRADE.

Retrieves the size of the code in the X-direction.

For composite code types, this result is the width of the 1D component of the code.

For 1D code types, this value is dependent on McodeControl() with M_POSITION_ACCURACY.

Retrieves the size of the code in the Y-direction.

For composite code types, this result is the height of the 1D component of the code.

For 1D code types, this value is dependent on McodeControl() with M_POSITION_ACCURACY.

Retrieves the decoded string.

If the string is decoded from a composite code model, the string is returned in the following format: 1D string|2D string, where | is used as the separator.

Retrieves the length of the decoded string.

Retrieves the threshold mode used to internally binarize the source image of a read operation.

Retrieves the threshold value used to internally binarize the source image of a read operation.

Retrieves the X-coordinate of the top-left corner of the code that was read.

For 1D code types, this value is dependent on McodeControl() with M_POSITION_ACCURACY.

Retrieves the Y-coordinate of the top-left corner of the code that was read.

For 1D code types, this value is dependent on McodeControl() with M_POSITION_ACCURACY.

Retrieves the X-coordinate of the top-right corner of the code that was read.

For 1D code types, this value is dependent on McodeControl() with M_POSITION_ACCURACY.

Retrieves the Y-coordinate of the top-right corner of the code that was read.

For 1D code types, this value is dependent on McodeControl() with M_POSITION_ACCURACY.

Retrieves the total length of all decoded strings. This is equal to the sum of the individual decoded string lengths (including the terminating null character ("\0") of each string).

Retrieves the aperture size used.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves whether an asterisk is appended to the overall symbol grade. Typically, an asterisk is appended to the overall symbol grade when the region outside the extended area has a symbol contrast (reflectance) that might interfere with the read operation (for example, the region is too bright or too dark).

This result type is available for 2D matrix code types, except Maxicode.

This result type requires that the specified code be graded using proper code verification techniques. For more information, refer to the ISO/IEC 15415 specification.

Retrieves the axial non-uniformity of the code. The axial non-uniformity is calculated using the following formula:

Where X_avg is the average cell size in the X-dimension and Y_avg is the average measurement cell size in the Y-dimension.

When dealing with results that are derived from other results, retrieve the results for the associated results first. For example, before retrieving M_SCAN_DEFECTS, retrieve M_SCAN_ERN_MAXIMUM and M_SCAN_SYMBOL_CONTRAST. This assists in narrowing down where your code (or potentially the configuration of your code context) is lacking.

This result type is available for 2D matrix code types.

Retrieves the axial nonuniformity of the code, as a grade.

This result type is available for 2D matrix code types.

Retrieves the cell contrast value (CC). The cell contrast is calculated as the difference between the average intensity of lighter cells minus the average intensity of darker cells, divided by the average intensity of lighter cells.

This result type is only available if McodeControl() with M_GRADING_STANDARD is set to M_AIMDPM_GRADING before McodeGrade() is called.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the cell contrast, as a grade.

This result type is only available if McodeControl() with M_GRADING_STANDARD is set to M_AIMDPM_GRADING before McodeGrade() is called.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the modulation of the code, as a grade calculated using the ISO/IEC TR 29158:2011 standard. Modulation is a measure of the uniformity of reflectance in the dark and light areas of the code.

This result type is the AIMDPM version of M_MODULATION_GRADE.

This result type is only available if McodeControl() with M_GRADING_STANDARD is set to M_AIMDPM_GRADING before McodeGrade() is called.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the measure of the print quality of each codeword relative to the decoding algorithm. Note that this excludes any start/stop patterns.

To retrieve the decodability of the start/stop patterns of your code, use M_SCAN_DECODABILITY.

When dealing with results that are derived from other results, retrieve the results for the associated results first. For example, before retrieving M_SCAN_DEFECTS, retrieve M_SCAN_ERN_MAXIMUM and M_SCAN_SYMBOL_CONTRAST. This assists in narrowing down where your code (or potentially the configuration of your code context) is lacking.

This result type is used in the grade overlay procedure for measuring codeword print quality, as described in the ISO 15415 specification.

This result type is available for 2D cross-row and composite code types.

Retrieves the decodability of each codeword in the code, as a grade.

To retrieve the decodability of the start/stop patterns of your code as a grade, use M_SCAN_DECODABILITY_GRADE.

This result type is used in the grade overlay procedure for measuring codeword print quality, as described in the ISO 15415 specification.

This result type is available for 2D cross-row and composite code types.

Retrieves and ranks the deviations in the expected signal that denotes a codeword in your code. The larger the result, the greater the defect in the codeword and the less likely that the codeword can be decoded without error.

To retrieve the defects for your code as a single grade use M_DEFECTS_GRADE. To retrieve the defects of the start/stop patterns use M_SCAN_DEFECTS.

When dealing with results that are derived from other results, retrieve the results for the associated results first. For example, before retrieving M_SCAN_DEFECTS, retrieve M_SCAN_ERN_MAXIMUM and M_SCAN_SYMBOL_CONTRAST. This assists in narrowing down where your code (or potentially the configuration of your code context) is lacking.

This result type is used in the grade overlay procedure for measuring codeword print quality, as described in the ISO 15415 specification.

This result type is available for 2D cross-row and composite code types.

Retrieves the codeword defects, as a grade for each codeword.

To retrieve the defects for your code as a single grade use M_DEFECTS_GRADE. To retrieve the defects of the start/stop patterns use M_SCAN_DEFECTS_GRADE.

This result type is used in the grade overlay procedure for measuring codeword print quality, as described in the ISO 15415 specification.

This result type is available for 2D cross-row and composite code types.

Retrieves the modulation (MOD) of each codeword. Modulation is a measure of the uniformity of reflectance in the dark and light areas of the code. For 2D cross-row and composite code types, modulation is calculated as the ratio of the minimum edge contrast (EC _min) to symbol contrast (M_SYMBOL_CONTRAST) within the code.

To retrieve the modulation of the start/stop patterns of 2D cross-row and composite code types, use M_SCAN_MODULATION.

When dealing with results that are derived from other results, retrieve the results for the associated results first. For example, before retrieving M_SCAN_DEFECTS, retrieve M_SCAN_ERN_MAXIMUM and M_SCAN_SYMBOL_CONTRAST. This assists in narrowing down where your code (or potentially the configuration of your code context) is lacking.

This result type is used in the grade overlay procedure for measuring codeword print quality, as described in the ISO 15415 specification.

This result type is available for Data Matrix, QR code, Micro QR, 2D cross-row, and composite code types.

Retrieves the modulation (MOD) of each codeword, as a grade.

To retrieve the modulation of your code as a single grade, use M_MODULATION_GRADE. To retrieve the modulation of the start/stop patterns of 2D cross-row and composite code types, as a grade, use M_SCAN_MODULATION_GRADE.

This result type is used in the grade overlay procedure for measuring codeword print quality, as described in the ISO 15415 specification.

This result type is available for Data Matrix, QR code, Micro QR, 2D cross-row, and composite code types.

Retrieves the reflectance margin of each codeword.

Retrieves the reflectance margin for each codeword, as a grade.

To retrieve the modulation of your code as a single grade, use M_REFLECTANCE_MARGIN_GRADE.

Retrieves the codeword yield result. The codeword yield result determines how well your code can be read at an angle relative to the horizontal and vertical axis of code. When all other results are good, a poor codeword yield result can indicate a problem along the Y-axis of your code. For more information, refer to the ISO/IEC 15415 specification.

When dealing with results that are derived from other results, retrieve the results for the associated results first. For example, before retrieving M_SCAN_DEFECTS, retrieve M_SCAN_ERN_MAXIMUM and M_SCAN_SYMBOL_CONTRAST. This assists in narrowing down where your code (or potentially the configuration of your code context) is lacking.

This result type is available for 2D cross-row and composite code types.

Retrieves the codeword yield, as a single grade for the code.

This result type is available for 2D cross-row and composite code types.

Retrieves the contrast uniformity of the code. The contrast uniformity is the minimum (MOD) value for the code.

Retrieves the contrast uniformity, as a grade.

Retrieves the measure of the print quality of the code relative to the decoding algorithm, as a grade.

To determine the decodability for each codeword in the code, use M_CODEWORD_DECODABILITY. To retrieve the decodability of the start/stop patterns of your code as a grade, use M_SCAN_DECODABILITY_GRADE.

This result type is available for 2D cross-row and composite code types.

Retrieves the code decodability, as a grade.

This result type is available for 2D matrix code types.

Retrieves the measure of defects in the code, as a grade.

To retrieve the measure of defects for each codeword as a grade, use M_CODEWORD_DEFECTS_GRADE. To retrieve the measure of defects in the start/stop patterns as a grade, use M_SCAN_DEFECTS_GRADE.

This result type is available for 2D cross-row and composite code types.

Retrieves the actual spacing between dots present in the code.

The expected dot spacing is set using McodeControl() with M_DOT_SPACING.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the modulation of each codeword found in the code's extended area beyond the quiet zone.

This result type requires that the specified code be graded using proper code verification techniques. For more information, refer to the ISO/IEC 15415 specification.

Retrieves the modulation grade of each codeword found in the code's extended area beyond the quiet zone.

This result type requires that the specified code be graded using proper code verification techniques. For more information, refer to the ISO/IEC 15415 specification.

Retrieves the grade of the A1 segment of the specified QR code or Micro QR code, in the extended area beyond the quiet zone.

Retrieves the grade of the A2 segment of the specified QR code or Micro QR code, in the extended area beyond the quiet zone.

Retrieves the grade of the A3 segment of the specified QR code or Micro QR code, in the extended area beyond the quiet zone.

Retrieves the average grade of the specified Data Matrix code, in the extended area beyond the quiet zone.

Retrieves the grade of the B1 segment of the specified QR code or Micro QR code, in the extended area beyond the quiet zone.

Retrieves the grade of the B2 segment of the specified QR code or Micro QR code, in the extended area beyond the quiet zone.

Retrieves the grade of the C segment of the specified QR code, in the extended area beyond the quiet zone.

Retrieves the grade of the clock pattern and adjacent solid area segments of the specified Data Matrix code, in the extended area beyond the quiet zone.

Retrieves the grade of the specified QR code or Micro QR code, in the extended area beyond the quiet zone.

Retrieves the grade of the L1 segment of the specified Data Matrix code, in the extended area beyond the quiet zone.

Retrieves the grade of the L2 segment of the specified Data Matrix code, in the extended area beyond the quiet zone.

Retrieves the grade of the QZL1 segment of the specified Data Matrix code, in the extended area beyond the quiet zone.

Retrieves the grade of the QZL2 segment of the specified Data Matrix code, in the extended area beyond the quiet zone.

Retrieves the grade of the modulation in the extended area beyond the quiet zone. Modulation is a measure of the uniformity of reflectance of the extended area beyond the quiet zone.

Retrieves the greatest reflectance within the extended area (that is, 20 times beyond the quiet zone) in any 2D code, except Maxicode.

This result type requires that the specified code be graded using proper code verification techniques. For more information, refer to the ISO/IEC 15415 specification.

Retrieves the lowest reflectance within the extended area (that is, 20 times beyond the quiet zone) in any 2D code, except Maxicode.

This result type requires that the specified code be graded using proper code verification techniques. For more information, refer to the ISO/IEC 15415 specification.

Retrieves the measure of the symbol contrast in the extended area (that is, 20 times beyond the quiet zone).

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the modulation grade of the symbol contrast in the extended area (that is, 20 times beyond the quiet zone).

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the fixed pattern damage in the A1 segment of the specified QR code or Micro QR code, as a grade. The fixed pattern damage (FPD) is a measure of the amount of damage present in the finder pattern, clock pattern, and quiet zone of the code. For a QR code, the alignment pattern is also analyzed.

Retrieves the fixed pattern damage in the A2 segment of the specified QR code as a grade. The fixed pattern damage (FPD) is a measure of the amount of damage present in the finder pattern, clock pattern, and quiet zone of the code.

Retrieves the fixed pattern damage in the A3 segment of the specified QR code, as a grade. The fixed pattern damage (FPD) is a measure of the amount of damage present in the finder pattern, clock pattern, and quiet zone of the code.

Retrieves the average grade of the fixed pattern damage (FDP) of the specified Data Matrix code.

Retrieves the fixed pattern damage in the B1 segment of the specified QR code or Micro QR code, as a grade. The fixed pattern damage (FPD) is a measure of the amount of damage present in the finder pattern, clock pattern, and quiet zone of the code. For a QR code, the alignment pattern is also analyzed.

Retrieves the fixed pattern damage in the B1 segment of the specified QR code or Micro QR code, as a grade. The fixed pattern damage (FPD) is a measure of the amount of damage present in the finder pattern, clock pattern, and quiet zone of the code. For a QR code, the alignment pattern is also analyzed.

Retrieves the fixed pattern damage in the C segment of the specified QR code, as a grade. The fixed pattern damage (FPD) is a measure of the amount of damage present in the finder pattern, clock pattern, and quiet zone of the code.

Retrieves the grade of the clock pattern and adjacent solid area segments of the specified Data Matrix code.

Retrieves the fixed pattern damage, as a grade. The fixed pattern damage (FPD) is a measure of the amount of damage present in the finder pattern, clock pattern, and quiet zone of the code. For a QR code, the alignment pattern is also analyzed.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the grade of the L1 segment of a Data Matrix code, in the extended area (that is, 20 times beyond the quiet zone).

Retrieves the grade of the L2 segment of a Data Matrix code, in the extended area beyond the quiet zone.

Retrieves the grade of the QZL1 segment of a Data Matrix code, in the quiet zone, along the left quadrant.

Retrieves the grade of the QZL2 segment of a Data Matrix code, in the extended area beyond the quiet zone.

Retrieves the readability of the format information in segment 1 of the code, as a grade. The format information is an embedded pattern that contains information about the characteristics of the code that are essential for further decoding.

This result type is available for QR code and Micro QR code types.

Retrieves the readabilityof the format information in segment 2 of the code, as a grade. The format information is an embedded pattern that contains information about the characteristics of the code that are essential for further decoding.

This result type is available for QR code and Micro QR code types.

Retrieves the readability of the format information, as a grade. The format information is an embedded pattern that contains information about the characteristics of the code that are essential for further decoding.

This result type is available for QR code and Micro QR code types.

Retrieves the grid nonuniformity value. Grid nonuniformity is calculated as the amount of deviation of the code's actual grid of an ideal grid.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the grid nonuniformity, as a grade.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the mean intensity of the centers of the white elements of the reference code (MLcal).

This result is determined during the reflectance calibration phase of the ISO/IEC TR 29158:2011 standard. To start the target verification phase, you must retrieve this result and load it into the code context of the target code. Use McodeControl() with M_MEAN_LIGHT_CALIBRATION to load this result into the target code context; alternatively, you can call McodeControl() with M_AIMDPM_CALIBRATION_RESULTS.

This result type is available for all 1D, Data Matrix, QR code, and Micro QR code types.

Retrieves the mean intensity of the centers of the white elements of the code to grade (MLtarget).

This result is determined during the target verification phase of the ISO/IEC TR 29158:2011 standard.

This result type is only available if McodeControl() with M_GRADING_STANDARD is set to M_AIMDPM_GRADING before McodeGrade() is called.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the amount of reflectance in the white elements of the code to grade.

To retrieve the lowest reflectance (Rmin) or the highest reflectance (Rmax), use M_R_MIN or M_R_MAX, respectively.

This result type is only available if McodeControl() with M_GRADING_STANDARD is set to M_AIMDPM_GRADING before McodeGrade() is called.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the minimum reflectance, as a grade.

This result type is available for Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the modulation of the code, as a grade calculated using the ISO standard. Modulation is a measure of the uniformity of reflectance in the dark and light areas of the code. For more information, refer to the ISO/IEC 15415 specification.

To retrieve the modulation of each codeword as a grade, use M_CODEWORD_MODULATION_GRADE. To retrieve the modulation of the start/stop patterns of 2D cross-row and composite code types, as a grade, use M_SCAN_MODULATION_GRADE. To retrieve the modulation of a code calculated using the ISO/IEC TR 29158:2011 standard, use M_CELL_MODULATION_GRADE.

This result type is available for 2D cross-row and composite code types.

Retrieves the number of rows graded in the code.

For GS1 Databar code types, the number of rows is the number of stacks in the code. For cross-row code types, the number of rows is the number of rows graded in the start/stop pattern grading.

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

Retrieves the total number of scan reflectance profiles analyzed in the code. This is the sum of the number of scans per row, for every row within the code. The number of scans determines the number of results within an array for all the M_SCAN... values described in this function.

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

Retrieves the number of scan reflectance profiles per row. The number of scans determines the number of results within an array for all the M_SCAN... values described in this function.

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

Retrieves the overall symbol grade. The code type determines the calculation used to obtain the grade.

For 1D code types, the overall symbol grade is the average grade of the scan reflectance profile (using M_SCAN_REFLECTANCE_PROFILE_GRADE.

For composite code types, the overall symbol grade is the worst grade overall, obtained when analyzing either the 1D or the 2D portions.

For 2D code types, the overall symbol grade is the worst of all the returned grades.

For cross-row codes, the overall symbol grade is the worst of all possible grades (with the exception of M_SCAN...GRADE).

To retrieve the overall symbol grade for each row in the code, use M_ROW_OVERALL_GRADE.

Retrieves the print growth value. The print growth is a value determining whether the graphical features of the code have either grown or shrunk, relative to theoretical model sufficiently to hinder readability.

When dealing with results that are derived from other results, retrieve the results for the associated results first. For example, before retrieving M_SCAN_DEFECTS, retrieve M_SCAN_ERN_MAXIMUM and M_SCAN_SYMBOL_CONTRAST. This assists in narrowing down where your code (or potentially the configuration of your code context) is lacking.

This result type is available for 2D matrix code types.

Retrieves the print growth value, as a grade.

This result type is available for 2D matrix code types.

Retrieves the highest reflectance (Rmax) of a 2D Matrix code type, except Maxicode.

This result type requires that the specified code be graded using proper code verification techniques. For more information, refer to the ISO/IEC 15415 specification.

Retrieves the lowest reflectance (Rmin) of a 2D Matrix code type, except Maxicode.

To retrieve the amount of reflectance in the white elements of the code to grade, use M_MINIMUM_REFLECTANCE.

This result type requires that the specified code be graded using proper code verification techniques. For more information, refer to the ISO/IEC 15415 specification.

Retrieves the recommended aperture size for the grading operation, following the ISO 15415 specification for 2D matrix codes and the ISO 15416 specification for all other available codes.

Note that, for 1D, 2D cross-row, and composite code types, this value depends on McodeControl() with M_PIXEL_SIZE_IN_MM. If M_PIXEL_SIZE_IN_MM is not set (or is set to M_UNKNOWN), the value returned is (0.5 x cell size).

If the M_PIXEL_SIZE_IN_MM is set to a value, the recommended aperture size is computed using the ISO 15416 specification.

For 2D matrix code types, the value returned is (0.8 x cell size), regardless of the value of M_PIXEL_SIZE_IN_MM.

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

Retrieves the maximum reflectance value derived during the reflectance calibration phase (Rcal).

This result is determined during the reflectance calibration phase of the ISO/IEC TR 29158:2011 standard. To start the target verification phase, you must retrieve this result and load it into the code context of the target code. Use McodeControl() with M_REFLECTANCE_CALIBRATION to load this result into the target code context; alternatively, you can call McodeControl() with M_AIMDPM_CALIBRATION_RESULTS.

This result type is available for 1D, Aztec, Data Matrix, QR code, and Micro QR code types.

Retrieves the assessment of the codeword print quality, based on the reflectance margin, as a grade.

Retrieves the overall grade for each row in the code.

To retrieve the average of all the row overall grades, use M_OVERALL_SYMBOL_GRADE.

For 1D code types, the overall row grade is the overall grade for the entire code.

For 2D code types, the overall row grade is the overall grade per stack of the code.

For cross-row code types, the overall row grade is the worst grade of the row.

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

Retrieves the decodability result of the scan reflectance profile.

To retrieve the decodability for each codeword, use M_CODEWORD_DECODABILITY. To retrieve the decodability for your code as a grade, use M_DECODABILITY_GRADE.

Note that certain code types have additional decodability measures that are taken into account when computing the decodability result. See the ISO 15417 (Code 128) and ISO 15420 (EAN and UPC code types) specifications.

When dealing with results that are derived from other results, retrieve the results for the associated results first. For example, before retrieving M_SCAN_DEFECTS, retrieve M_SCAN_ERN_MAXIMUM and M_SCAN_SYMBOL_CONTRAST. This assists in narrowing down where your code (or potentially the configuration of your code context) is lacking.

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

Retrieves the decodability result of the scan reflectance profile, as a grade.

To retrieve the decodability for each codeword as a grade, use M_CODEWORD_DECODABILITY_GRADE. To retrieve the decodability for your cross-row code as a grade, use M_DECODABILITY_GRADE.

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

Retrieves whether the decoding algorithm succeeded or failed, as a grade.

To retrieve the error status of the grading operation, use M_STATUS. To retrieve the confidence score of a read operation, use M_SCORE.

Note that M_SCAN_EDGE_DETERMINATION_GRADE is used in calculating this value.

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