Color Stamp Detection

The 'Color Distance' property sets the threshold for distinguishing color pixels from gray or near-gray pixels. Pixels with a color distance (Euclidean distance from the grayscale line in RGB space) greater than this value are considered color and included in stamp detection.

• Increase to detect only bold, saturated color stamps.
• Decrease to include faint or pastel stamps, but may increase false positives from noise.

Tuning Guidance:

• Review the "Color Only" diagnostic image to see which pixels are included.
• Adjust to balance between missing faint stamps and detecting unwanted marks.

The 'Dilation Factor' property controls how much the binary image is expanded before blob analysis. Dilation can "weld" small specks to nearby blobs, reducing noise and improving aspect ratio filtering.

• Increase to merge more specks, making detection more robust to noise.
• Decrease to preserve fine details, but may increase false positives from specks.

Tuning Guidance:

• Review the "Blob Candidates" diagnostic image to see the effect of dilation.
• Adjust to ensure stamps are detected as single blobs and not fragmented.

The 'Region of Interest' property allows you to restrict stamp detection to a specific area of the page. This is useful when stamps are always placed in a known location (e.g., top right corner).

• Set to a rectangle covering the expected stamp area.
• Leave empty to search the entire image.

Tuning Guidance:

• Use the zone editor to define the ROI visually.
• Review diagnostic overlays to confirm the ROI is correct.

The 'Flag If Multiple' property controls whether the page is flagged as an exception if multiple stamps are found. This is useful for quality control, ensuring that only one stamp is present per page.

• Enable to flag pages with multiple stamps for review or exception handling.
• Disable to allow multiple stamps without flagging.

Tuning Guidance:

• Review log messages to see when pages are flagged.
• Use in workflows where only one stamp per page is expected.

The 'Stamp Name' property specifies the name recorded for detected stamps. This name is used in separation events and downstream logic to identify the type of stamp detected.

• Set to a descriptive name matching your workflow (e.g., LeadPage, Separator).

Tuning Guidance:

• Ensure the name matches the configuration in your Shape Detected separation event.
• Use unique names for different stamp types if needed.

The 'Remove Stamp' property controls whether detected stamps are erased from the image after detection. This is useful for cleaning up images before downstream processing or export.

• Enable to remove stamps after detection.
• Disable to preserve stamps in the output image.

Tuning Guidance:

• Stamp removal will not occur if multiple stamps are detected.
• Review the "Dropout Mask" and "Output Image" diagnostics to see the effect of removal.

The 'Stamp Removal Edge Factor' property sets the number of pixels to expand the removal mask around the detected stamp, ensuring thorough erasure of edge color pixels.

• Increase to remove more of the area around the stamp, useful for thick or fuzzy stamps.
• Decrease to minimize impact on nearby features.

Tuning Guidance:

• Review the "Dropout Mask" and "Output Image" diagnostics to see the effect of this setting.
• Adjust to balance thorough removal with preservation of nearby content.

The 'Width Range' property defines the minimum and maximum width (in display units) for blobs to be considered as potential stamps. Blobs outside this range are excluded.

• Set to match the expected width of stamps on your documents.
• Use in combination with 'Height Range' and 'Maximum Aspect Ratio' for precise filtering.

Tuning Guidance:

• Review the "Blob Candidates" and "Final Blobs" diagnostic images to see which blobs are included or excluded.
• Adjust to avoid detecting marks that are too small or too large to be stamps.

The 'Height Range' property defines the minimum and maximum height (in display units) for blobs to be considered as potential stamps. Blobs outside this range are excluded.

• Set to match the expected height of stamps on your documents.
• Use in combination with 'Width Range' and 'Maximum Aspect Ratio' for precise filtering.

Tuning Guidance:

• Review the "Blob Candidates" and "Final Blobs" diagnostic images to see which blobs are included or excluded.
• Adjust to avoid detecting marks that are too small or too large to be stamps.

The 'Maximum Aspect Ratio' property sets the highest allowed ratio of width to height (or vice versa) for blobs. Blobs with an aspect ratio above this value are excluded, helping to filter out elongated marks or lines.

• Lower values require blobs to be more square-like.
• Higher values allow detection of elongated stamps.

Tuning Guidance:

• Review the "Blob Candidates" and "Final Blobs" diagnostic images to see which blobs are excluded.
• Adjust to match the typical shape of stamps used in your process.

The 'Command Type Name' property shows the user-friendly name of the IP Command as it appears in the Grooper UI. This helps users identify which command is being configured or executed, especially when working with IP Profiles containing multiple commands.

This property is read-only and is automatically set based on the command's type.

The 'Supported Pixel Formats' property lists the image pixel formats that the IP Command can process. If an image does not match one of these formats, the command will be skipped for that image.

• By default, all pixel formats are supported unless a derived command restricts this list.
• Example formats include Pixel8bppGrayscale, Pixel24bppBgr, and Pixel1bppIndexed.

Use this property to verify compatibility when building IP Profiles or troubleshooting why a command did not execute.