PatternMatch_PageType

Member of namespace

PatternMatch

Syntax

bool PatternMatch_PageType (StrParam)

Parameters

One or more Page Types defined in the Document Hierarchy

Returns

False if the rule containing this action was not applied to a Page object of the Document Hierarchy; if the parameter is invalid; if a match does not occur; or if fingerprints do not yet exist. Otherwise, True.

Level

Page level only.

Details

PatternMatch_PageType identifies a page's type and fingerprint using geometric pattern matching. The locations of unique patterns are configured as Anchor Fields for each fingerprint in the Document Hierarchy. One or more Anchor fields can be used to match geometric shapes on a fingerprint to the current image. If one or more Anchor fields on the current page match a fingerprint, at or above the configured confidence level, the page is identified with that fingerprint. The action does not require all defined anchors to match - the first match is used. The action loads all Anchor field patterns from fingerprints with the specified page types, then searches on the current image for each of the patterns in the associated zones. The search area for each zone is increased by the dimensions specified in the page METRIC variable. If METRIC is not specified, the default is 500 pixels horizontal and vertical. When this action finds a match, it sets the matching Fingerprint ID and Page Type. It will also create page-level fields and update the Anchor fields with Anchor-specific pattern offset values in a field-level Image_Offset variable. The offset can be used subsequent to matching a fingerprint. The pat_RegisterZones action can be used to align the zones in the fingerprint to the current image, providing more accurately positioned text in each field.

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

Example

PatternMatch_PageType(HCFA 1500)

This action looks for a match among the inventory of fingerprints that have a page type of "HCFA 1500".