diff options
Diffstat (limited to 'python-pixelmatch.spec')
| -rw-r--r-- | python-pixelmatch.spec | 444 |
1 files changed, 444 insertions, 0 deletions
diff --git a/python-pixelmatch.spec b/python-pixelmatch.spec new file mode 100644 index 0000000..11c89f2 --- /dev/null +++ b/python-pixelmatch.spec @@ -0,0 +1,444 @@ +%global _empty_manifest_terminate_build 0 +Name: python-pixelmatch +Version: 0.3.0 +Release: 1 +Summary: A pixel-level image comparison library. +License: ISC +URL: https://github.com/whtsky/pixelmatch-py +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/1c/59/ebc53e64156db78c75c6d7f535e3f80f62c8a8e1545783770f06f528e187/pixelmatch-0.3.0.tar.gz +BuildArch: noarch + + +%description +# pixelmatch-py + +A fast pixel-level image comparison library, originally created to compare screenshots in tests. +Now with additional support of PIL.Image instances +Python port of https://github.com/mapbox/pixelmatch. + +Features accurate **anti-aliased pixels detection** +and **perceptual color difference metrics**. + +```python +from pixelmatch import pixelmatch + +num_diff_pixels = pixelmatch(img1, img2, 800, 600, diff, threshold=0.1) +``` + +Implements ideas from the following papers: + +- [Measuring perceived color difference using YIQ NTSC transmission color space in mobile applications](https://pdfs.semanticscholar.org/cb71/56034b6e427ddc9b5da1a4f5fcb10831c9fd.pdf) (2010, Yuriy Kotsarenko, Fernando Ramos) +- [Anti-aliased pixel and intensity slope detector](https://www.researchgate.net/publication/234126755_Anti-aliased_Pixel_and_Intensity_Slope_Detector) (2009, Vytautas Vyšniauskas) + +## Install + +```bash +python -m pip install pixelmatch +``` + +## Example usage + +### PIL.Image comparison + +```python +from PIL import Image + +from pixelmatch.contrib.PIL import pixelmatch + +img_a = Image.open("a.png") +img_b = Image.open("b.png") +img_diff = Image.new("RGBA", img_a.size) + +# note how there is no need to specify dimensions +mismatch = pixelmatch(img_a, img_b, img_diff, includeAA=True) + +img_diff.save("diff.png") +``` + +### Raw Image Data Comparison + +```python +from pixelmatch import pixelmatch + +width, height = 1920, 1080 +img_a = [R1, G1, B1, A1, R2, B2, G2, A2, ...] +img_b = [R1, G1, B1, A1, R2, B2, G2, A2, ...] + +data_diff = [0] * len(img_a) + +mismatch = pixelmatch(img_a, img_b, width, height, data_diff, includeAA=True) +``` + +## API + +### pixelmatch(img1, img2, width, height, output, threshold, includeAA, alpha, aa_color, diff_color, diff_mask, fail_fast) + +- `img1`, `img2` — RGBA Image data of the images to compare. **Note:** image dimensions must be equal. +- `width`, `height` — Width and height of the images. +- `output` — Image data to write the diff to, or `None` if don't need a diff image. Note that _all three images_ need to have the same dimensions. +- `threshold` — Matching threshold, ranges from `0` to `1`. Smaller values make the comparison more sensitive. `0.1` by default. +- `includeAA` — If `true`, disables detecting and ignoring anti-aliased pixels. `false` by default. +- `alpha` — Blending factor of unchanged pixels in the diff output. Ranges from `0` for pure white to `1` for original brightness. `0.1` by default. +- `aa_color` — The color of anti-aliased pixels in the diff output in `[R, G, B]` format. `[255, 255, 0]` by default. +- `diff_color` — The color of differing pixels in the diff output in `[R, G, B]` format. `[255, 0, 0]` by default. +- `diff_mask` — Draw the diff over a transparent background (a mask), rather than over the original image. Will not draw anti-aliased pixels (if detected). +- `fail_fast` - If true, will return after first different pixel. + +Compares two images, writes the output diff and returns the number of mismatched pixels. + +### contrib.PIL.pixelmatch + +Compares two images, writes the output diff and returns the number of mismatched pixels. Exact same API as `pixelmatch.pixelmatch` except for the important fact that it takes instances of PIL.Image for image parameters (`img1`, `img2`, and `output`) and the width/size need not be specified. + +## Example output + +| expected | actual | diff | +| ----------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | +|  |  |  | +|  |  |  | +|  |  |  | +|  |  |  | + +## Changelog + +### v0.3.0 + +- feat: add fail_fast option [#144](https://github.com/whtsky/pixelmatch-py/pull/144) +### v0.2.4 +- type: fix typing issues +- chore: test Python 3.10 + +### v0.2.3 + +- feat: make package comply with PEP-561 + +### v0.2.2 + +- typing: use `Sequence` instead of `List` for `RGBTuple` +- build: switch to `poetry_core` [#81](https://github.com/whtsky/pixelmatch-py/pull/81) + +### v0.2.1 + +- feat: add function to compare PIL.Image instances through contrib.PIL.pixelmatch [#42](https://github.com/whtsky/pixelmatch-py/pull/42) + +### v0.2.0 + +- BREAKING CHANGE: remove `options` parameter [#38](https://github.com/whtsky/pixelmatch-py/pull/38) +- docs: use absolute url for images in README + +### v0.1.1 + +- fix: fix bug in fast path [#18](https://github.com/whtsky/pixelmatch-py/pull/18) + +### v0.1.0 + +- Initial release + + + +%package -n python3-pixelmatch +Summary: A pixel-level image comparison library. +Provides: python-pixelmatch +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-pixelmatch +# pixelmatch-py + +A fast pixel-level image comparison library, originally created to compare screenshots in tests. +Now with additional support of PIL.Image instances +Python port of https://github.com/mapbox/pixelmatch. + +Features accurate **anti-aliased pixels detection** +and **perceptual color difference metrics**. + +```python +from pixelmatch import pixelmatch + +num_diff_pixels = pixelmatch(img1, img2, 800, 600, diff, threshold=0.1) +``` + +Implements ideas from the following papers: + +- [Measuring perceived color difference using YIQ NTSC transmission color space in mobile applications](https://pdfs.semanticscholar.org/cb71/56034b6e427ddc9b5da1a4f5fcb10831c9fd.pdf) (2010, Yuriy Kotsarenko, Fernando Ramos) +- [Anti-aliased pixel and intensity slope detector](https://www.researchgate.net/publication/234126755_Anti-aliased_Pixel_and_Intensity_Slope_Detector) (2009, Vytautas Vyšniauskas) + +## Install + +```bash +python -m pip install pixelmatch +``` + +## Example usage + +### PIL.Image comparison + +```python +from PIL import Image + +from pixelmatch.contrib.PIL import pixelmatch + +img_a = Image.open("a.png") +img_b = Image.open("b.png") +img_diff = Image.new("RGBA", img_a.size) + +# note how there is no need to specify dimensions +mismatch = pixelmatch(img_a, img_b, img_diff, includeAA=True) + +img_diff.save("diff.png") +``` + +### Raw Image Data Comparison + +```python +from pixelmatch import pixelmatch + +width, height = 1920, 1080 +img_a = [R1, G1, B1, A1, R2, B2, G2, A2, ...] +img_b = [R1, G1, B1, A1, R2, B2, G2, A2, ...] + +data_diff = [0] * len(img_a) + +mismatch = pixelmatch(img_a, img_b, width, height, data_diff, includeAA=True) +``` + +## API + +### pixelmatch(img1, img2, width, height, output, threshold, includeAA, alpha, aa_color, diff_color, diff_mask, fail_fast) + +- `img1`, `img2` — RGBA Image data of the images to compare. **Note:** image dimensions must be equal. +- `width`, `height` — Width and height of the images. +- `output` — Image data to write the diff to, or `None` if don't need a diff image. Note that _all three images_ need to have the same dimensions. +- `threshold` — Matching threshold, ranges from `0` to `1`. Smaller values make the comparison more sensitive. `0.1` by default. +- `includeAA` — If `true`, disables detecting and ignoring anti-aliased pixels. `false` by default. +- `alpha` — Blending factor of unchanged pixels in the diff output. Ranges from `0` for pure white to `1` for original brightness. `0.1` by default. +- `aa_color` — The color of anti-aliased pixels in the diff output in `[R, G, B]` format. `[255, 255, 0]` by default. +- `diff_color` — The color of differing pixels in the diff output in `[R, G, B]` format. `[255, 0, 0]` by default. +- `diff_mask` — Draw the diff over a transparent background (a mask), rather than over the original image. Will not draw anti-aliased pixels (if detected). +- `fail_fast` - If true, will return after first different pixel. + +Compares two images, writes the output diff and returns the number of mismatched pixels. + +### contrib.PIL.pixelmatch + +Compares two images, writes the output diff and returns the number of mismatched pixels. Exact same API as `pixelmatch.pixelmatch` except for the important fact that it takes instances of PIL.Image for image parameters (`img1`, `img2`, and `output`) and the width/size need not be specified. + +## Example output + +| expected | actual | diff | +| ----------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | +|  |  |  | +|  |  |  | +|  |  |  | +|  |  |  | + +## Changelog + +### v0.3.0 + +- feat: add fail_fast option [#144](https://github.com/whtsky/pixelmatch-py/pull/144) +### v0.2.4 +- type: fix typing issues +- chore: test Python 3.10 + +### v0.2.3 + +- feat: make package comply with PEP-561 + +### v0.2.2 + +- typing: use `Sequence` instead of `List` for `RGBTuple` +- build: switch to `poetry_core` [#81](https://github.com/whtsky/pixelmatch-py/pull/81) + +### v0.2.1 + +- feat: add function to compare PIL.Image instances through contrib.PIL.pixelmatch [#42](https://github.com/whtsky/pixelmatch-py/pull/42) + +### v0.2.0 + +- BREAKING CHANGE: remove `options` parameter [#38](https://github.com/whtsky/pixelmatch-py/pull/38) +- docs: use absolute url for images in README + +### v0.1.1 + +- fix: fix bug in fast path [#18](https://github.com/whtsky/pixelmatch-py/pull/18) + +### v0.1.0 + +- Initial release + + + +%package help +Summary: Development documents and examples for pixelmatch +Provides: python3-pixelmatch-doc +%description help +# pixelmatch-py + +A fast pixel-level image comparison library, originally created to compare screenshots in tests. +Now with additional support of PIL.Image instances +Python port of https://github.com/mapbox/pixelmatch. + +Features accurate **anti-aliased pixels detection** +and **perceptual color difference metrics**. + +```python +from pixelmatch import pixelmatch + +num_diff_pixels = pixelmatch(img1, img2, 800, 600, diff, threshold=0.1) +``` + +Implements ideas from the following papers: + +- [Measuring perceived color difference using YIQ NTSC transmission color space in mobile applications](https://pdfs.semanticscholar.org/cb71/56034b6e427ddc9b5da1a4f5fcb10831c9fd.pdf) (2010, Yuriy Kotsarenko, Fernando Ramos) +- [Anti-aliased pixel and intensity slope detector](https://www.researchgate.net/publication/234126755_Anti-aliased_Pixel_and_Intensity_Slope_Detector) (2009, Vytautas Vyšniauskas) + +## Install + +```bash +python -m pip install pixelmatch +``` + +## Example usage + +### PIL.Image comparison + +```python +from PIL import Image + +from pixelmatch.contrib.PIL import pixelmatch + +img_a = Image.open("a.png") +img_b = Image.open("b.png") +img_diff = Image.new("RGBA", img_a.size) + +# note how there is no need to specify dimensions +mismatch = pixelmatch(img_a, img_b, img_diff, includeAA=True) + +img_diff.save("diff.png") +``` + +### Raw Image Data Comparison + +```python +from pixelmatch import pixelmatch + +width, height = 1920, 1080 +img_a = [R1, G1, B1, A1, R2, B2, G2, A2, ...] +img_b = [R1, G1, B1, A1, R2, B2, G2, A2, ...] + +data_diff = [0] * len(img_a) + +mismatch = pixelmatch(img_a, img_b, width, height, data_diff, includeAA=True) +``` + +## API + +### pixelmatch(img1, img2, width, height, output, threshold, includeAA, alpha, aa_color, diff_color, diff_mask, fail_fast) + +- `img1`, `img2` — RGBA Image data of the images to compare. **Note:** image dimensions must be equal. +- `width`, `height` — Width and height of the images. +- `output` — Image data to write the diff to, or `None` if don't need a diff image. Note that _all three images_ need to have the same dimensions. +- `threshold` — Matching threshold, ranges from `0` to `1`. Smaller values make the comparison more sensitive. `0.1` by default. +- `includeAA` — If `true`, disables detecting and ignoring anti-aliased pixels. `false` by default. +- `alpha` — Blending factor of unchanged pixels in the diff output. Ranges from `0` for pure white to `1` for original brightness. `0.1` by default. +- `aa_color` — The color of anti-aliased pixels in the diff output in `[R, G, B]` format. `[255, 255, 0]` by default. +- `diff_color` — The color of differing pixels in the diff output in `[R, G, B]` format. `[255, 0, 0]` by default. +- `diff_mask` — Draw the diff over a transparent background (a mask), rather than over the original image. Will not draw anti-aliased pixels (if detected). +- `fail_fast` - If true, will return after first different pixel. + +Compares two images, writes the output diff and returns the number of mismatched pixels. + +### contrib.PIL.pixelmatch + +Compares two images, writes the output diff and returns the number of mismatched pixels. Exact same API as `pixelmatch.pixelmatch` except for the important fact that it takes instances of PIL.Image for image parameters (`img1`, `img2`, and `output`) and the width/size need not be specified. + +## Example output + +| expected | actual | diff | +| ----------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | +|  |  |  | +|  |  |  | +|  |  |  | +|  |  |  | + +## Changelog + +### v0.3.0 + +- feat: add fail_fast option [#144](https://github.com/whtsky/pixelmatch-py/pull/144) +### v0.2.4 +- type: fix typing issues +- chore: test Python 3.10 + +### v0.2.3 + +- feat: make package comply with PEP-561 + +### v0.2.2 + +- typing: use `Sequence` instead of `List` for `RGBTuple` +- build: switch to `poetry_core` [#81](https://github.com/whtsky/pixelmatch-py/pull/81) + +### v0.2.1 + +- feat: add function to compare PIL.Image instances through contrib.PIL.pixelmatch [#42](https://github.com/whtsky/pixelmatch-py/pull/42) + +### v0.2.0 + +- BREAKING CHANGE: remove `options` parameter [#38](https://github.com/whtsky/pixelmatch-py/pull/38) +- docs: use absolute url for images in README + +### v0.1.1 + +- fix: fix bug in fast path [#18](https://github.com/whtsky/pixelmatch-py/pull/18) + +### v0.1.0 + +- Initial release + + + +%prep +%autosetup -n pixelmatch-0.3.0 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-pixelmatch -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Tue Apr 11 2023 Python_Bot <Python_Bot@openeuler.org> - 0.3.0-1 +- Package Spec generated |