Grooper Help - Version 25.0
25.0.0017 2,127
  • Overview
  • Help Status

Detect Signature

Value Extractor Grooper.Extract

Detects a signature within a specified region of a document page by measuring the percentage of the area that is filled.

Remarks

The Detect Signature value extractor is used to determine whether a handwritten or ink signature is present within a defined region of a document page. It analyzes the image content in the configured region and calculates the fill percentage - the proportion of the area that contains ink or markings.

How It Works

  • The extractor measures the fill percentage within the specified region(s) on each page.
  • If the fill percentage meets or exceeds the configured threshold, the region is considered signed.
  • The result is returned as either the value configured in 'Value If Filled' or 'Value If Not Filled'.
  • Optional image cleanup can be performed using an IP Profile to improve detection accuracy.

Configuration Guidance

  • Use the 'Location' property to define the region(s) to analyze. This can be a fixed rectangle or dynamically determined based on document content.
  • Adjust the 'Fill Percentage' to control the sensitivity of signature detection. Lower values may detect lighter or partial signatures; higher values require more ink coverage.
  • Assign an IP Profile for image cleanup if the document contains noise, lines, or other artifacts that could interfere with detection. Avoid commands that alter image size or resolution.
  • Configure the 'Value If Filled' and 'Value If Not Filled' properties to specify the output values for signed and unsigned regions.

Usage Scenarios

  • Automating signature verification for onboarding forms, contracts, or consent documents.
  • Flagging missing signatures for review or exception handling.
  • Integrating with data models to capture signature status as a field value.

Diagnostics

When diagnostic mode is enabled, Detect Signature generates the following artifacts to assist with configuration and troubleshooting:

  • Log entries detailing the region coordinates, pixel area, pixel count, and calculated fill percentage.
  • Diagnostic images showing the analyzed region, with visual annotations highlighting the detection area.
  • If an IP Profile is used, additional diagnostic images of the cleaned-up region are provided.

These diagnostics help users tune the region definition, fill percentage threshold, and image cleanup settings for optimal signature detection.

Properties

NameTypeDescription

See Also

Used By

Notification