VerifyIDCode
Used to extract metrics associated with code readability and mark quality from symbols that are initially read by either a ReadIDMax function or ReadIDCode function. For more information, see ReadIDMax and ReadIDCode.
- 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.
- The referenced ReadIDMax function must have the Verify parameter enabled.
- The referenced ReadIDCode function must have the Algorithm parameter enabled.
- 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.
VerifyIDCode Inputs
Syntax: VerifyIDCode(IDCode,Metrics,IAQG 9132 Metrics,Cognex Metrics,Min Cell Size,Aperture Percentage,Timeout,Show)
Parameter | Description | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
This argument must reference a spreadsheet cell that contains either a valid IDMax data structure returned by a ReadIDMax function, or a IDCode data structure returned by a ReadIDCode function. Note: 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.
|
|||||||||||||||
Specifies whether ISO verification metrics are used. Note: When verifying
QR Codes, only ISO 16022:2000 Enhanced and ISO 16022:2000 Traditional
are supported.
|
|||||||||||||||
Specifies whether the IAQG AS9132, revision A Data Matrix (2D) Coding Quality Requirements for Parts Marking verification metrics are used (including Dot Ovality) to verify Data Matrix symbols. For more information on IAQG, click here. Note: IAQG 9132 Metrics
are not supported for verifying QR Codes.
|
|||||||||||||||
Specifies whether the Cognex supplemental verification metrics are used.
|
|||||||||||||||
Specifies the minimum expected cell size (0 to 255; default = 0). Also called a module, a cell is a single square, which can be either black or white. For example, a 10 x 10 symbol is made up of 100 black and white cells. One cell is equal to one bit of data. A value of 0 will use the current symbol's cell size Note: ISO 15415:2004
must be the selected ISO Metric
to enable this parameter.
|
|||||||||||||||
Specifies the percentage (0 to 100; default = 80) to compute the synthetic aperture size from minimum cell value. This value is used in assessment of verification metrics. Note: ISO 15415 must
be the selected ISO Metric to
enable this parameter.
|
|||||||||||||||
Specifies the amount of time, in milliseconds (0 to 30000), that the function will attempt to verify the ID symbol before execution is halted and an #ERR is returned. |
|||||||||||||||
Specifies the display mode for the VerifyIDCode graphical overlay on the image, when verifying Data Matrix and QR Code symbols.
|
VerifyIDCode Outputs
Returns |
An IDVerify data structure containing verification metrics of the symbol, or #ERR if any of the input parameters are invalid. |
Results |
When the function is initially inserted into a cell, the grade of the verified symbol will appear in the adjacent cell. If the symbol cannot be verified, then #ERR will be inserted. |
VerifyIDCode Vision Data Access Functions
When the VerifyIDCode function is initially created, IDVerify Vision Data Access functions are automatically inserted into the spreadsheet, depending on the verification metrics that are selected. For more information, see IDVerify.