MatchPattern

Member of namespace

PatternMatch

Syntax

bool MatchPattern ()

Parameters

None.

Returns

False, if any of the follow conditions occur.

• The Anchor position that is returned is not Numeric.
• No image is found.
• The accuracy of the match is below the set Confidence Value.
• An Anchor match does not occur.

Otherwise, True.

Level

Field level.

Details

Searches on the current image in a zone that is associated with the current field for a match to the pattern specified for this field in a fingerprint. The zoned area from the original fingerprint is matched against a larger zone in the current image. The search area is controlled by the METRIC variable. METRIC=200,100 means search from 200 pixels to the left and right, and 100 pixels above and below the expected location. If METRIC is not specified, the default is 500 pixels horizontal and vertical.

The fingerprint is determined by the current image's Fingerprint ID, or the Global Fingerprint ID if the current image is not identified.

MatchPattern can be called on any field and if matched, an offset variable is saved for that field. If called before ReadZones, then ReadZones uses the offset for that field when its position is set. Other fields are unaffected.

If the field is matched to the fingerprint with a confidence equal to or greater than the required confidence, the position of the field is set to the found location. If the field is not matched, the function returns false. If not found and the field's Required variable is non-zero, the field status is set to 1 (Error or Validation failed).

This action operates on black and white images, grayscale or color images cause the action to fail. The fingerprint image must have the same resolution (DPI) as the current page image. The geometric shape that is contained in the Anchor field must be bold and well-defined with clear edges, with crisp, black and white markings that product a distinct shape. The shape must be thick and compact, not composed of long thin lines. To avoid false positive matches, the shape must not match other shapes or black areas that might exist nearby within the same image.

Example

MatchPattern()