IDVerify

Note:
  • All returned values are from a referenced IDVerify structure, which is inserted in the spreadsheet when the VerifyIDCode function is created.
  • The ReadIDCode function is only available on In-Sight vision systems using In-Sight firmware 4.x.x, and is not available on In-Sight vision systems running In-Sight firmware 5.1.0 and later. For a complete list of models and supported firmware versions, see Firmware Versions.
  • Cognex recommends that the ReadIDMax function be used instead of the ReadIDCode function, which is a legacy function. The ReadIDMax function has enhanced performance capabilities.
  • When the VerifyIDCode function references a ReadIDMax function, the optional Index can reference an indexed string from the ReadIDMax function result table. For more information, see VerifyIDCode and ReadIDMax.
  • For the ReadIDCode function, the Algorithm parameter must be enabled in the referenced ReadIDCode function to support the following functions, and the functions are only available for Data Matrix, QR Code or Postal symbols (POSTNET, PLANET, UPU 4-State, Australia Post 4-State, Japan Post 4-State, USPS OneCode4-State). For more information, see ReadIDCode.

General Purpose Vision Data Access Functions

Function Description

GetGrade(IDVerify,[Index])

 

Returns the overall quality grade of the symbol based on the selected metrics.

Note: If more than one of the metric sets (ISO, IAQG9132 or Cognex) is enabled in the VerifyIDCode function, GetGrade will return the lowest grade of the enabled metrics. For more information, see VerifyIDCode.

GetRow(IDVerify,[Index])

Returns the row coordinate (in pixels) of the upper left-hand corner of a barcode or the column coordinate for 2D symbols at the indexed (0 to 3) finder pattern point. For more information, see Finder Pattern Points.

Note: The Verify parameter in the ReadIDCode function must be enabled. For more information, see ReadIDCode.

GetCol(IDVerify,[Index])

Returns the column coordinate (in pixels) of the upper left-hand corner of a barcode or the column coordinate for 2D symbols at the indexed (0 to 3) finder pattern point. For more information, see Finder Pattern Points.

Note: The Verify parameter in the ReadIDCode function must be enabled. For more information, see ReadIDCode.

Get2DModulation(IDVerify,[Index])

Returns the Modulation of the symbol as defined by the selected metric method. Either ISO 15415 or AIM-DPM metrics must be enabled in the VerifyIDCode function. For more information, see VerifyIDCode.

Note: Get2DModulation will return an #ERR for symbols that are not Data Matrix ECC 200 symbols.
  • Grade A = 4.0
  • Grade B = 3.0
  • Grade C = 2.0
  • Grade D = 1.0
  • Grade F = 0.0

GetNoReadString(IDVerify,[Index])

Returns diagnostic strings to provide information regarding ReadIDCode failures. Depending on the code type being verified, the grid size, polarity, resolution, ECC level, and in some cases code type, is also returned.

ClosedSee diagnostic information strings

 

Diagnostic Information Strings

Symbol successfully decoded.

Symbol was found but failed to decode.

No symbol found or decoded.

ReadIDCode operation timed out.

Sensor ran out of memory while trying to decode.

ReadIDCode unexpectedly failed.

Invalid ReadIDCode Cell reference in VerifyIDCode.

Invalid Image Cell reference in ReadIDCode.

No-Read diagnostics only supported for Data Matrix or QR Code when Algorithm checkbox is enabled.

Algorithm checkbox is not enabled in ReadIDCode property sheet.

GetNoReadStatus(IDVerify,[Index])

Returns diagnostic codes to provide information regarding ReadIDCode failures.

ClosedSee diagnostic codes and corresponding information strings

 

Data Matrix: All metrics are computed during the following situations.

Diagnostic Code Corresponding Error String

04030000

Symbol successfully decoded.

04030001

Symbol was found but failed to decode.

 

QR Code: All metrics, with the exception of ISO 15415 and IAQG-9132, are computed during the following situations.

Diagnostic Code Corresponding Error String

04030000

Symbol successfully decoded.

04030001

Symbol was found but failed to decode.

 

No metrics are available for either Data Matrix or QR Code during these situations.

Diagnostic Code Corresponding Error String

04030002

No symbol found or decoded.

04030003

ReadIDCode operation timed out.

04030004

Sensor ran out of memory while trying to decode.

04030005

ReadIDCode unexpectedly failed.

04030006

Invalid ReadIDCode Cell reference in VerifyIDCode.

04030007

Invalid Image Cell reference in ReadIDCode.

04030008

No-Read diagnostics only supported for Data Matrix or QR Code when Algorithm checkbox is enabled.

04030009

Algorithm checkbox is not enabled in ReadIDCode property sheet.

ISO 16022/18004 Vision Data Access Functions

Function Description

GetContrast(IDVerify,[Index])

If ISO 15415 is selected, returns the symbol contrast metric result, which is the percentage difference between the foreground and background grey levels.

  • Grade A (4.0): 0.70 ≤ x < 1.00
  • Grade B (3.0): 0.55 ≤ x < 0.70
  • Grade C (2.0): 0.40 ≤ x < 0.55
  • Grade D (1.0): 0.20 ≤ x < 0.40
  • Grade F (0.0): 0.00 ≤ x < 0.20

If AIM-DPM (Either Process control or Contract Compliance) is selected, returns the symbol contrast metric, which is computed as the difference between the light and dark distribution means as a percentage of the light distribution mean. The AIM-DPM standard requires that the image be acquired such that the light distribution is at 78 percent to within a ± 8% tolerance range.

  • Grade A (4.0): 0.30 ≤ x < 1.00
  • Grade B (3.0): 0.25 ≤ x < 0.30
  • Grade C (2.0): 0.20 ≤ x < 0.25
  • Grade D (1.0): 0.15 ≤ x < 0.20
  • Grade F (0.0): 0.00 ≤ x < 0.15

GetGrowth(IDVerify,[Index])

Returns the 2D symbol print growth metric result.

  • Grade A (4.0): -0.50 ≤ x ≤ 0.50
  • Grade B (3.0): -0.70 ≤ x < -0.50 or 0.50 < x ≤ 0.70
  • Grade C (2.0): -0.85 ≤ x < -0.70 or 0.70 < x ≤ 0.85
  • Grade D (1.0): -1.00 ≤ x < -0.85 or 0.85 < x ≤ 1.00
  • Grade F (0.0): x < -1.00 or x > 1.00

GetGrowthHorizontal(IDVerify,[Index])

Returns the print growth along the horizontal dimension of the 2D symbol.

  • Grade A (4.0): -0.50 ≤ x ≤ 0.50
  • Grade B (3.0): -0.70 ≤ x < -0.50 or 0.50 < x ≤ 0.70
  • Grade C (2.0): -0.85 ≤ x < -0.70 or 0.70 < x ≤ 0.85
  • Grade D (1.0): -1.00 ≤ x < -0.85 or 0.85 < x ≤ 1.00
  • Grade F (0.0): x < -1.00 or x > 1.00

GetGrowthVertical(IDVerify,[Index])

Returns the print growth along the vertical dimension of the 2D symbol.

  • Grade A (4.0): -0.50 ≤ x ≤ 0.50
  • Grade B (3.0): -0.70 ≤ x < -0.50 or 0.50 < x ≤ 0.70
  • Grade C (2.0): -0.85 ≤ x < -0.70 or 0.70 < x ≤ 0.85
  • Grade D (1.0): -1.00 ≤ x < -0.85 or 0.85 < x ≤ 1.00
  • Grade F (0.0): x < -1.00 or x > 1.00

GetNonUniformity(IDVerify,[Index])

Returns the 2D symbol axial non-uniformity metric result.

  • Grade A (4.0): 0.00 ≤ x ≤ 0.06
  • Grade B (3.0): 0.06 < x ≤ 0.08
  • Grade C (2.0): 0.08 < x ≤ 0.10
  • Grade D (1.0): 0.10 < x ≤ 0.12
  • Grade F (0.0): 0.12 < x ≤ 1.00

GetRefDecode(IDVerify,[Index])

Indicates whether the symbol was decoded successfully.

  • Grade A (4.0): 1
  • Grade B (3.0): N/A
  • Grade C (2.0): N/A
  • Grade D (1.0): N/A
  • Grade F (0.0): 0

GetUnusedEC(IDVerify,[Index])

Returns the unused error correction metric result for a 2D symbol, as a percentage.

  • Grade A (4.0): 0.62 ≤ x ≤  1.00
  • Grade B (3.0): 0.50 ≤ x < 0.62
  • Grade C (2.0): 0.37 ≤ x < 0.50
  • Grade D (1.0): 0.25 ≤ x < 0.37
  • Grade F (0.0): 0.00 ≤ x < 0.25

ISO 15415/AIM-DPM Vision Data Access Functions

Function Description

Get2DModulation(IDVerify,[Index])

Returns the Modulation of the symbol as defined by the selected metric method. Either ISO 15415 or AIM-DPM metrics must be enabled in the VerifyIDCode function. For more information, see VerifyIDCode.

Note: Get2DModulation will return an #ERR for symbols that are not Data Matrix ECC 200 symbols.
  • Grade A = 4.0
  • Grade B = 3.0
  • Grade C = 2.0
  • Grade D = 1.0
  • Grade F = 0.0

GetContrast(IDVerify,[Index])

If ISO 15415 is selected, returns the symbol contrast metric result, which is the percentage difference between the foreground and background grey levels.

  • Grade A (4.0): 0.70 ≤ x < 1.00
  • Grade B (3.0): 0.55 ≤ x < 0.70
  • Grade C (2.0): 0.40 ≤ x < 0.55
  • Grade D (1.0): 0.20 ≤ x < 0.40
  • Grade F (0.0): 0.00 ≤ x < 0.20

If AIM-DPM (Either Process control or Contract Compliance) is selected, returns the symbol contrast metric, which is computed as the difference between the light and dark distribution means as a percentage of the light distribution mean. The AIM-DPM standard requires that the image be acquired such that the light distribution is at 78 percent to within a ± 8% tolerance range.

  • Grade A (4.0): 0.30 ≤ x < 1.00
  • Grade B (3.0): 0.25 ≤ x < 0.30
  • Grade C (2.0): 0.20 ≤ x < 0.25
  • Grade D (1.0): 0.15 ≤ x < 0.20
  • Grade F (0.0): 0.00 ≤ x < 0.15

GetExtremeReflectance(IDVerify,[Index])

Returns the ISO 15415 Extreme Reflectance for the symbol. The ISO 15415 metrics must be enabled in the VerifyIDCode function. This metric is not part of the AIM-DPM standard, and will return #ERR if AIM-DPM is selected.

Extreme Reflectance is a yes/no value indicating if the substrate surrounding the symbol contains reflectance extremes that can interfere with reading.

Extreme reflectance recomputes the modulation and fixed pattern damage grades with thresholds based on an extended region beyond the standard quiet zone. Only attempt extreme reflectance computation if the modulation, decode, and fixed pattern damage grades are 1 or greater.

The function returns #ERR if IDVerify cannot determine extreme reflectance.

  • Grade A (4.0): 1
  • Grade B (3.0): N/A
  • Grade C (2.0): N/A
  • Grade D (1.0): N/A
  • Grade F (0.0): 0

GetFixedPatternDamage(IDVerify,[Index])

Returns the Fixed Pattern Damage metric of the symbol. Either ISO 15415 or AIM-DPM metrics must be enabled in the VerifyIDCode function. Fixed pattern damage is measured differently between ISO 15415 and AIM-DPM. For more information, see VerifyIDCode.

  • Grade A = 4.0
  • Grade B = 3.0
  • Grade C = 2.0
  • Grade D = 1.0
  • Grade F = 0.0

GetGridNonUniformity(IDVerify,[Index])

Returns the Grid Non-uniformity of the symbol. Either ISO 15415 or AIM-DPM metrics must be enabled in the VerifyIDCode function. For more information, see VerifyIDCode.

  • Grade A (4.0): x ≤ 0.38
  • Grade B (3.0): 0.38 < x ≤ 0.50
  • Grade C (2.0): 0.50 < x ≤ 0.63
  • Grade D (1.0): 0.63 < x ≤ 0.75
  • Grade F (0.0): x > 0.75

GetGrowth(IDVerify,[Index])

Returns the 2D symbol print growth metric result. The horizontal and vertical print growths are calculated independently and the lower score is returned. Both 15415 and AIM-DPM classify print growth as a process control metric; they do not define any grade mapping and do not use it for computing the symbol grade.

Note:
  • Print growth is measured and reported differently from that of 16022/18004 standards.  Both ISO-15415 and AIM-DPM measure print growth as average deviation of the measured cell size from the nominal as a percentage of the nominal.  Negative values represent print loss.
  • Print growth is measured independently along the horizontal and vertical dimensions of the symbol as returned by the GetGrowthHorizontal and GetGrowthVertical functions. GetGrowth returns the average of horizontal and vertical print growth values.

GetGrowthHorizontal(IDVerify,[Index])

Returns the print growth along the horizontal dimension of the 2D symbol.

  • Grade A (4.0): -0.50 ≤ x ≤ 0.50
  • Grade B (3.0): -0.70 ≤ x < -0.50 or 0.50 < x ≤ 0.70
  • Grade C (2.0): -0.85 ≤ x < -0.70 or 0.70 < x ≤ 0.85
  • Grade D (1.0): -1.00 ≤ x < -0.85 or 0.85 < x ≤ 1.00
  • Grade F (0.0): x < -1.00 or x > 1.00

GetGrowthVertical(IDVerify,[Index])

Returns the print growth along the vertical dimension of the 2D symbol.

  • Grade A (4.0): -0.50 ≤ x ≤ 0.50
  • Grade B (3.0): -0.70 ≤ x < -0.50 or 0.50 < x ≤ 0.70
  • Grade C (2.0): -0.85 ≤ x < -0.70 or 0.70 < x ≤ 0.85
  • Grade D (1.0): -1.00 ≤ x < -0.85 or 0.85 < x ≤ 1.00
  • Grade F (0.0): x < -1.00 or x > 1.00

GetNonUniformity(IDVerify,[Index])

Returns the 2D symbol axial non-uniformity metric result.

  • Grade A (4.0): 0.00 ≤ x ≤ 0.06
  • Grade B (3.0): 0.06 < x ≤ 0.08
  • Grade C (2.0): 0.08 < x ≤ 0.10
  • Grade D (1.0): 0.10 < x ≤ 0.12
  • Grade F (0.0): 0.12 < x ≤ 1.00

GetRefDecode(IDVerify,[Index])

Indicates whether the symbol was decoded successfully.

  • Grade A (4.0): 1
  • Grade B (3.0): N/A
  • Grade C (2.0): N/A
  • Grade D (1.0): N/A
  • Grade F (0.0): 0

GetUnusedEC(IDVerify,[Index])

Returns the unused error correction metric result for a 2D symbol, as a percentage.

  • Grade A (4.0): 0.62 ≤ x ≤  1.00
  • Grade B (3.0): 0.50 ≤ x < 0.62
  • Grade C (2.0): 0.37 ≤ x < 0.50
  • Grade D (1.0): 0.25 ≤ x < 0.37
  • Grade F (0.0): 0.00 ≤ x < 0.25

Cognex Supplemental Vision Data Access Functions

Function Description

GetBkgdUniformity(IDVerify,[Index])

Returns the grayscale background uniformity of a 2D symbol (including the quiet zone). A symbol with a uniform gray level for the quiet zone and the modules that represent binary data bit 0 is considered to be of good quality.

  • Grade A (4.0): 0.9 ≤ x ≤ 1.0
  • Grade B (3.0): 0.8 ≤ x < 0.9
  • Grade C (2.0): 0.7 ≤ x < 0.8
  • Grade D (1.0): 0.6 ≤ x < 0.7
  • Grade F (0.0): 0.0 ≤ x < 0.6

GetCellSeparability(IDVerify,[Index])

Returns the measurement of the bi-modal characteristics of the modules that represent binary data bit 1 or 0. The gray levels of the modules are extracted from the sampling grid defined in the AIM reference decode algorithm.

  • Grade A (4.0): 0.75 ≤ x ≤ 1.00
  • Grade B (3.0): 0.60 ≤ x < 0.75
  • Grade C (2.0): 0.50 ≤ x < 0.60
  • Grade D (1.0): 0.40 ≤ x < 0.50
  • Grade F (0.0): 0.00 ≤ x < 0.40

GetFinderConfCon(IDVerify,[Index])

Returns the value of the extent to which the finder pattern (including timing pattern) of a symbol conforms to the AIM symbology specification. In particular, it measures how well adjacent modules of the same color form solid lines and modules of different color have the same size. A low value of this metric corresponds to low likelihood of the symbol location step of the AIM reference decode algorithm being successful. This function also measures the ratio of the number of modules in the finder pattern (including timing pattern) that represent expected binary data bit 0 or 1.

  • Grade A (4.0): 1.0
  • Grade B (3.0): 0.9 ≤ x < 1.0
  • Grade C (2.0): 0.8 ≤ x < 0.9
  • Grade D (1.0): 0.7 ≤ x < 0.8
  • Grade F (0.0): 0.0 ≤ x < 0.7

GetFinderConfDot(IDVerify,[Index])

Returns the value of how well a dot-peened symbol's finder pattern conforms to the AIM specification.

  • Grade A (4.0): 1.0
  • Grade B (3.0): 0.9 ≤ x < 1.0
  • Grade C (2.0): 0.8 ≤ x < 0.9
  • Grade D (1.0): 0.7 ≤ x < 0.8
  • Grade F (0.0): 0.0 ≤ x < 0.7

GetImageSharpness(IDVerify,[Index])

Returns the value of the sharpness of the edges in the image by comparing the edge magnitude obtained from a 3x3 Sobel edge detector to the image contrast. An image with high sharpness value is considered to be well-focused and of good quality.

  • Grade A (4.0): 0.5 ≤ x ≤ 1.0
  • Grade B (3.0): 0.4 ≤ x < 0.5
  • Grade C (2.0): 0.3 ≤ x < 0.4
  • Grade D (1.0): 0.2 ≤ x < 0.3
  • Grade F (0.0): 0.0 ≤ x < 0.2

GetSymSeparability(IDVerify,[Index])

Indicates whether the symbol is a distinct feature in the entire image. A symbol that can be well segmented from the background by a global threshold midway between the minimum and maximum gray level in the image is considered to be of good quality.

  • Grade A (4.0): 1
  • Grade B (3.0): N/A
  • Grade C (2.0): N/A
  • Grade D (1.0): N/A
  • Grade F (0.0): 0

IAQG/AS-9132 Vision Data Access Functions

Function Description

GetIAQGOverallGrade(IDVerify,[Index])

Returns the overall symbol grade as per IAQG 9132 specification using the minimum successfully extracted grades for GetPercDotOSFailGrade, GetPercDotPositionFailGrade, and GetDistortionAngleGrade.

GetDistortionAngle(IDVerify,[Index])

Returns the deviation, in degrees, from perpendicular of the symbols X and Y-axes.

  • Grade A (4.0): x ≤ 7.0
  • Grade B (3.0): N/A
  • Grade C (2.0): N/A
  • Grade D (1.0): N/A
  • Grade F (0.0): x > 7.0

GetDistortionAngleGrade(IDVerify,[Index])

Returns the IAQG 9132 grade for angle of distortion.

  • Grade A (4.0): x ≤ 7.0
  • Grade B (3.0): N/A
  • Grade C (2.0): N/A
  • Grade D (1.0): N/A
  • Grade F (0.0): x > 7.0

GetDotCenter(IDVerify,[Index])

Returns the percentage indicating how well the centers of the cells in the symbol fit their expected positions.

Note: This function is only applicable when verifying dot-peened Data Matrix symbols.
  • Grade A (4.0): 0.0 ≤ x ≤ 10.0
  • Grade B (3.0): 10.0 ≤ x < 20.0
  • Grade C (2.0): N/A
  • Grade D (1.0): N/A
  • Grade F (0.0): 20.0 ≤ x < 100.0

GetDotDiameter(IDVerify,[Index])

Returns the average of the cell diameters as a percentage of the expected cell diameter.

Note: This function is only applicable when verifying dot-peened Data Matrix symbols.
  • Grade A (4.0): 60.0 < x < 105.0
  • Grade B (3.0): N/A
  • Grade C (2.0): N/A
  • Grade D (1.0): N/A
  • Grade F (0.0): 0.0 ≤ x ≤ 60.0 and 105.0 ≤ x ≤ 150.0

GetDotOvality(IDVerify,[Index])

Returns the average difference in cell widths and heights as a percentage of the expected cell size.

Note: This function is only applicable when verifying dot-peened Data Matrix symbols.
  • Grade A (4.0): 0.0 ≤ x < 20.0
  • Grade B (3.0): N/A
  • Grade C (2.0): N/A
  • Grade D (1.0): N/A
  • Grade F (0.0): 20.0 ≤ x < 100.0

GetPercDotOSFail(IDVerify,[Index])

Returns the percentage of ON cells in the symbol that are outside either dot size or ovality range.

GetPercDotOSFailGrade(IDVerify,[Index])

Returns the IAQG 9132 grade for percentage of ON cells that are outside dot size or ovality range. If the value is above 2%, this metric is a Fail (0) grade, otherwise it is a Pass (4).

GetPercDotPositionFail(IDVerify,[Index])

Returns the percentage of ON cells in the symbol that exceed position tolerance range.

GetPercDotPositionFailGrade(IDVerify,[Index])

Returns the IAQG 9132 grade for percentage of ON cells that exceed position tolerance range.

  • Grade A (4.0): 1
  • Grade B (3.0): N/A
  • Grade C (2.0): N/A
  • Grade D (1.0): N/A
  • Grade F (0.0):  0

GetSDevDotCenter(IDVerify,[Index])

Returns the standard deviation of dot position shift errors.

Note: This function is only applicable when verifying dot-peened Data Matrix symbols.
  • Grade A (4.0): 0.0 ≤ x < 20.0
  • Grade B (3.0): N/A
  • Grade C (2.0): N/A
  • Grade D (1.0): N/A
  • Grade F (0.0): 20.0 ≤ x < 100.0

GetSDevDotDiameter(IDVerify,[Index])

Returns the standard deviation of all the cell diameters.

Note: This function is only applicable when verifying dot-peened Data Matrix symbols.
  • Grade A (4.0): 0.0 ≤ x < 20.0
  • Grade B (3.0): N/A
  • Grade C (2.0): N/A
  • Grade D (1.0): N/A
  • Grade F (0.0): 20.0 ≤ x < 100.0

GetSDevDotOvality(IDVerify,[Index])

Returns the standard deviation between cell widths and heights.

Note: This function is only applicable when verifying dot-peened Data Matrix symbols.
  • Grade A (4.0): 0.0 ≤ x < 20.0
  • Grade B (3.0): N/A
  • Grade C (2.0): N/A
  • Grade D (1.0): N/A
  • Grade F (0.0): 20.0 ≤ x < 100.0

Postal Code Vision Data Access Functions

Function Description

GetBarPitch(IDVerify,[Index])

Returns the average pitch of the bars in the Postal barcode.

GetBarSkew(IDVerify,[Index])

Returns the average skew of the bars in the Postal barcode.

GetBarSpace(IDVerify,[Index])

Returns the average space between bars in the Postal barcode.

GetBarVoid(IDVerify,[Index])

Returns the average void spacing (area without ink) of the bars in the Postal barcode.

GetBarHeight(IDVerify,[Index])

Returns the average height of the specified type of bars in the Postal barcode (Index Input Values: 0 = short/timing, 1 = ascender, 2 = descender, 3 = tall/full).

GetBarWidth(IDVerify,[Index])

Returns the average width of the bars in the Postal barcode.

GetBaselineShift(IDVerify,[Index])

Returns the average shift of the bars from the baseline in the Postal barcode.

GetBGReflectance(IDVerify,[Index])

Returns the average background reflectance.

GetClearanceBottom(IDVerify,[Index])

Returns the clearance (quiet zone) to the bottom of the code.

Note: Only valid if symbol was successfully decoded.

GetClearanceLeft(IDVerify,[Index])

Returns the clearance (quiet zone) to the left of the code.

Note: Only valid if symbol was successfully decoded.

GetClearanceRight(IDVerify,[Index])

Returns the clearance (quiet zone) to the right of the code.

Note: Only valid if symbol was successfully decoded.

GetClearanceTop(IDVerify,[Index])

Returns the clearance (quiet zone) to the top of the code.

Note: Only valid if symbol was successfully decoded.

GetContrast(IDVerify,[Index])

Returns the symbol contrast metric result, which is the percentage difference between the foreground and background grey levels.

GetMaxBarHeight(IDVerify,[Index])

Returns the maximum height of the specified type of bars in the Postal barcode (Index Input Values: 0 = short/timing, 1 = ascender, 2 = descender, 3 = tall/full).

GetMaxBarPitch(IDVerify,[Index])

Returns the maximum pitch of the bars in the Postal barcode.

GetMaxBarSkew(IDVerify,[Index])

Returns the maximum skew of the bars in the Postal barcode.

Note: This function is only available on In-Sight vision systems running In-Sight firmware 4.x.x, and is not available on In-Sight vision systems running In-Sight firmware 5.1.0 and later. For a complete list of models and supported firmware versions, see Firmware Versions.

GetMaxBarSpace(IDVerify,[Index])

Returns the maximum space between bars in the Postal barcode.

Note: This function is only available on In-Sight vision systems running In-Sight firmware 4.x.x, and is not available on In-Sight vision systems running In-Sight firmware 5.1.0 and later. For a complete list of models and supported firmware versions, see Firmware Versions.

GetMaxBarVoid(IDVerify,[Index])

Returns the maximum void spacing (area without ink) of the bars in the Postal barcode.

GetMaxBarWidth(IDVerify,[Index])

Returns the maximum width of the bars in the Postal barcode in the Postal barcode.

Note: This function is only available on In-Sight vision systems running In-Sight firmware 4.x.x, and is not available on In-Sight vision systems running In-Sight firmware 5.1.0 and later. For a complete list of models and supported firmware versions, see Firmware Versions.

GetMaxBaselineShift(IDVerify,[Index])

Returns the maximum shift of the bars from the baseline in the Postal barcode.

GetMaxBGReflectance(IDVerify,[Index])

Returns the maximum background reflectance.

GetMaxContrast(IDVerify,[Index])

Returns the maximum contrast between foreground and background (in grey levels).

Note: This function is only available on In-Sight vision systems running In-Sight firmware 4.x.x, and is not available on In-Sight vision systems running In-Sight firmware 5.1.0 and later. For a complete list of models and supported firmware versions, see Firmware Versions.

GetMaxOverInkSize(IDVerify,[Index])

Returns the maximum over-ink size of the bars in the Postal barcode.

GetMinBarHeight(IDVerify,[Index])

Returns the minimum height of the specified type of bars in the Postal barcode (Index Input Values: 0 = short/timing, 1 = ascender, 2 = descender, 3 = tall/full).

GetMinBarPitch(IDVerify,[Index])

Returns the minimum pitch of the bars in the Postal barcode.

GetMinBarSpace(IDVerify,[Index])

Returns the minimum space between bars in the Postal barcode.

Note: This function is only available on In-Sight vision systems running In-Sight firmware 4.x.x, and is not available on In-Sight vision systems running In-Sight firmware 5.1.0 and later. For a complete list of models and supported firmware versions, see Firmware Versions.

GetMinBarVoid(IDVerify,[Index])

Returns the minimum void spacing (area without ink) of the bars in the Postal barcode.

GetMinBarWidth(IDVerify,[Index])

Returns the minimum width of the bars in the Postal barcode.

Note: This function is only available on In-Sight vision systems running In-Sight firmware 4.x.x, and is not available on In-Sight vision systems running In-Sight firmware 5.1.0 and later. For a complete list of models and supported firmware versions, see Firmware Versions.

GetMinBarSkew(IDVerify,[Index])

Returns the minimum skew of the bars in the Postal barcode.

Note: This function is only available on In-Sight vision systems running In-Sight firmware 4.x.x, and is not available on In-Sight vision systems running In-Sight firmware 5.1.0 and later. For a complete list of models and supported firmware versions, see Firmware Versions.

GetMinBaselineShift(IDVerify,[Index])

Returns the minimum shift of the bars from the baseline.

GetMinBGReflectance(IDVerify,[Index])

Returns the minimum background reflectance.

GetMinContrast(IDVerify,[Index])

Returns the minimum contrast between foreground and background (in grey levels.)

Note: This function is only available on In-Sight vision systems running In-Sight firmware 4.x.x, and is not available on In-Sight vision systems running In-Sight firmware 5.1.0 and later. For a complete list of models and supported firmware versions, see Firmware Versions.

GetMinOverInkSize(IDVerify,[Index])

Returns the minimum over-ink size of the bars.

GetNBars(IDVerify,[Index])

Returns the number of bars found in a Postal barcode.

Note: This function is only available on In-Sight vision systems running In-Sight firmware 4.x.x, and is not available on In-Sight vision systems running In-Sight firmware 5.1.0 and later. For a complete list of models and supported firmware versions, see Firmware Versions.

GetOneBarBaselineShift(IDVerify, [Index])

Returns the baseline shift of the indexed bar in the Postal barcode.

GetOneBarBGReflectance(IDVerify, [Index])

Returns the background reflectance of the indexed bar in the Postal barcode.

GetOneBarCol(IDVerify, [Index])

Returns the column number of the indexed bar in the Postal barcode. For 2-State codes (e.g., POSTNET and PLANET), the bar location is the center of the bottom edge of the bar. For 4-State codes (e.g., UPU 4-State, USPS OneCode 4-State, Japan Post 4-State, Australia Post 4-State), this is the center of the T-element of the bar.

GetOneBarContrast(IDVerify, [Index])

Returns the contrast of the indexed bar in the Postal barcode.

GetOneBarHeight(IDVerify, [Index])

Returns the height of the indexed bar in the Postal barcode.

GetOneBarOverInkSize(IDVerify, [Index])

Returns the over-ink size of the indexed bar in the Postal barcode.

GetOneBarPitch(IDVerify, [Index])

Returns the pitch of the indexed bar in the Postal barcode.

GetOneBarRow(IDVerify, [Index])

Returns the row number of the indexed bar in the Postal barcode. For 2-State codes (e.g., POSTNET and PLANET), the bar location is the center of the bottom edge of the bar. For 4-State codes (e.g., UPU 4-State, USPS OneCode 4-State, Japan Post 4-State, Australia Post 4-State), this is the center of the T-element of the bar.

GetOneBarSkew(IDVerify, [Index])

Returns the skew of the indexed bar in the Postal barcode.

GetOneBarSpace(IDVerify, [Index])

Returns the space of the indexed bar in the Postal barcode.

GetOneBarType(IDVerify, [Index])

Returns the type of the indexed bar in the Postal barcode (Output Values: 0 = short/timing, 1 = ascender, 2 = descender, 3 = tall/full).

Note: The Index value for the parameter references the individual bar in the Postal barcode, and the output value indicates the individual bar type.

GetOneBarVoid(IDVerify, [Index])

Returns the void spacing of the indexed bar in the Postal barcode.

GetOneBarWidth(IDVerify, [Index])

Returns the width of the indexed bar in the Postal barcode.

GetOverInkSize(IDVerify,[Index])

Returns the average over-ink size of the bars in the Postal barcode.

GetSDevBarHeight(IDVerify,[Index])

Returns the standard deviation of the height of the specified type of bars in the Postal barcode (Index Input Values: 0 = short/timing, 1 = ascender, 2 = descender, 3 = tall/full).

GetSDevBarPitch(IDVerify,[Index])

Returns the standard deviation of the pitch of the bars in the Postal barcode.

GetSDevBarSkew(IDVerify,[Index])

Returns the standard deviation of the skew of the bars in the Postal barcode.

Note: This function is only available on In-Sight vision systems running In-Sight firmware 4.x.x, and is not available on In-Sight vision systems running In-Sight firmware 5.1.0 and later. For a complete list of models and supported firmware versions, see Firmware Versions.

GetSDevBarSpace(IDVerify,[Index])

Returns the standard deviation of the space width between bars in the Postal barcode.

Note: This function is only available on In-Sight vision systems running In-Sight firmware 4.x.x, and is not available on In-Sight vision systems running In-Sight firmware 5.1.0 and later. For a complete list of models and supported firmware versions, see Firmware Versions.

GetSDevBarVoid(IDVerify,[Index])

Returns the standard deviation of the void spacing (area without ink) of the bars in the Postal barcode.

GetSDevBarWidth(IDVerify,[Index])

Returns the standard deviation of the width of the bars  in the Postal barcode.

Note: This function is only available on In-Sight vision systems running In-Sight firmware 4.x.x, and is not available on In-Sight vision systems running In-Sight firmware 5.1.0 and later. For a complete list of models and supported firmware versions, see Firmware Versions.

GetSDevBaselineShift(IDVerify,[Index])

Returns the standard deviation of the shift of the bars from the baseline.

GetSDevBGReflectance(IDVerify,[Index])

Returns the standard deviation of the background reflectance.

GetSDevOverInkSize(IDVerify,[Index])

Returns the standard deviation of the over-ink size of the bars.

GetVerifyDecoded(IDVerify,[Index])

Returns whether symbol was successfully decoded (Output Values: 0 = unsuccessful, 1 = successful).