Skip to content

Feat: Add ignore-areas#95

Open
damblatt wants to merge 3 commits into
vslavik:masterfrom
damblatt:feat/add-ignore-area
Open

Feat: Add ignore-areas#95
damblatt wants to merge 3 commits into
vslavik:masterfrom
damblatt:feat/add-ignore-area

Conversation

@damblatt

Copy link
Copy Markdown

Added an --ignore-area feature that allows users to define one or more rectangular regions to be excluded from PDF comparisons. Multiple rectangles can be specified as a ;-separated list (e.g. --ignore-area="10,10,50,100;20,20,50,100).

This is useful for documents that contain dynamic content such as serial numbers, timestamps, or unique identifiers reoccurring on every page at the same position. In my use case, each generated document contained one or more unique codes (data matrix codes) at fixed positions on the page, causing otherwise identical PDFs to be reported as different.

Pixels within an ignored area are excluded from the pixel-diff count and don't trigger the page-differs flag, but are still rendered using the original (unmodified) page content rather than the diff color overlay. In the output diff PDF, ignored areas are additionally marked with a dashed gray outline so it's clear they were excluded intentionally rather than simply matching.

damblatt added 3 commits June 24, 2026 11:09
Ignored area is defined by passing position (from the upper left corner), width and length of the rectangle.
separated by semicolon
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant