Disable Image Comparison in PDF Documents Leave feedback

GroupDocs.Comparison for Python via .NET can skip image comparison when diffing PDFs — useful when only text changes matter and embedded graphics would otherwise add noise to the result.

from groupdocs.comparison import Comparer
from groupdocs.comparison.options import CompareOptions, ImagesInheritance

def disable_image_comparison_in_pdf():
    with Comparer("./source.pdf") as comparer:
        comparer.add("./target.pdf")
        options = CompareOptions()
        options.compare_images_pdf = False
        options.images_inheritance_mode = ImagesInheritance.TARGET
        comparer.compare("./result.pdf", options)

if __name__ == "__main__":
    disable_image_comparison_in_pdf()

Binary file (PDF, 279 KB)

Use case: speed up PDF comparisons and avoid noise from embedded graphics.

The result is as follows:

Disable image comparison when:

• You only care about text edits. Legal redlines, contract markup, and editorial review workflows usually treat embedded figures as visual context, not diff content.
• The PDFs differ only in cosmetic backgrounds. Scanned letterheads, watermarks, and stamps inflate the change count without surfacing meaningful differences.
• You need a faster comparison. Image diffing is the most expensive part of PDF comparison; skipping it can shave seconds off each comparison and is essential at high throughput.

Keep image comparison enabled when:

• The PDFs are image-heavy (scanned forms, technical drawings, presentations exported to PDF) — image diffs are the meaningful content.
• You need pixel-accurate change overlays combined with calculate_coordinates = True.

When image comparison is disabled, images_inheritance_mode controls which document’s images appear in the result PDF:

• Compare PDF documents — base PDF-comparison flow.
• Get changes coordinates — when you keep image compare on and want overlay coordinates.