跳转到主要内容

将两个图像并排显示以进行视觉比较

项目描述

imgdiff

一个命令行工具,可以将两张图片合并成一张更大的图片,并打开由Python Imaging Library提供的GUI窗口或外部图像查看器。

您可以使用它与版本控制工具一起使用,例如。

bzr diff *.png --using=imgdiff

bzr diff *.png --using='imgdiff --eog -H'

安装

pip install imgdiff 或从PyPI 下载它

用法

运行 imgdiff --help 以查看此帮助消息

Usage: imgdiff [options] image1 image2

Compare two images side-by-side

Options:
  -h, --help            show this help message and exit
  -o OUTFILE            write the combined image to a file
  --viewer=COMMAND      use an external image viewer (default: builtin)
  --eog                 use Eye of Gnome (same as --viewer eog)
  --grace=SECONDS       seconds to wait before removing temporary file when
                        using an external viewer (default: 1.0)
  -H, --highlight       highlight differences (EXPERIMENTAL)
  -S, --smart-highlight
                        highlight differences in a smarter way (EXPERIMENTAL)
  --opacity=OPACITY     minimum opacity for highlighting (default 64)
  --timeout=TIMEOUT     skip highlighting if it takes too long (default: 10
                        seconds)
  --auto                pick orientation automatically (default)
  --lr, --left-right    force orientation to left-and-right
  --tb, --top-bottom    force orientation to top-and-bottom
  --bgcolor=RGB         background color (default: fff)
  --sepcolor=RGB        separator line color (default: ccc)
  --spacing=N           spacing between images (default: 3 pixels)
  --border=N            border around images (default: 0 pixels)

输出示例

第一个示例

imgdiff set1/42.png set3/
example #1

这里图片又宽又短,所以imgdiff决定将它们上下排列。

相同的示例,已启用高亮显示

imgdiff set1/42.png set3/ -H
example #2

您可以看到它并不奏效,尽管它可以在更简单的情况下产生很好的结果

imgdiff set1/42.png set2/ -H
example #3

支持和开发

源代码可以在以下Git仓库中找到: https://github.com/mgedmin/imgdiff

要检出,请使用 git clone https://github.com/mgedmin/imgdiff

https://github.com/mgedmin/imgdiff/issues 上报告错误。

变更

1.7.1 (2019-04-23)

  • 声明Python 3.6和3.7支持(无需代码更改)。

  • 删除Python 3.3和3.4支持。

1.7.0 (2016-09-17)

  • 明确说明--opacity选项的帮助消息。

  • 添加Python 3.5支持。

  • 停止对Python 2.6和3.2的支持。

1.6.0 (2014-12-01)

  • 添加对Python 3的支持。

  • 使–timeout选项真正生效。

  • 删除–selftest选项。添加一个具有100%覆盖率的真实测试套件(实际上意义不大,因为这些是烟雾测试,不会检查结果的正确性。)

1.5.0 (2013-08-11)

  • 如果stderr不是终端,则抑制进度输出。

  • 可以通过按^C键来终止–highligh/–smart-highlight逻辑。

  • 如果–highlight/–smart-highlight逻辑运行超过10秒,则终止(可以通过–timeout修改超时时间;使用0来关闭)。

1.4.1 (2013-08-09)

  • 依赖Pillow而不是PIL。

  • 迁移到GitHub。

1.4.0 (2010-12-19)

  • 接受目录名称:imgdiff dir1/img.png dir2/

  • 如果图像具有不同的宽度和高度,则相对于彼此居中图像。

  • 自动方向(–auto)使用黄金比例(1:1.618)作为其目标高度:宽度,而不是1:1的正方形。

  • 新的实验选项:–highlight (-H) 和 –smart-highlight (-S)。这些突出显示不同的区域,并淡出相似的区域。或者至少它们会尝试。

  • 新的选项用于调整输出:–bgcolor、–sepcolor、–spacing、–border、–opacity。

  • 新选项:–eog是–viewer eog的别名,但更短。猜猜我在使用哪个桌面环境。;-)

  • 一个微小的“测试套件”,可以通过imgdiff –selftest运行。

  • 通过docstrings改进源代码文档。

1.3.0 (2010-12-18)

  • 首次公开发布。支持选项:-o、–viewer、–grace、–auto、–lr、–tb、–help。

由以下机构支持

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误记录 StatusPage StatusPage 状态页面