- 
- 
- 
@@ -98,7 +92,7 @@ This library provides extensive file format support, an efficient internal repre
The core image library is designed for fast access to data stored in a few basic pixel formats. It should provide a solid foundation for a general image processing tool.
-## More Information
+## More information
- [Documentation](https://pillow.readthedocs.io/)
- [Installation](https://pillow.readthedocs.io/en/latest/installation/basic-installation.html)
@@ -107,9 +101,9 @@ The core image library is designed for fast access to data stored in a few basic
- [Issues](https://github.com/python-pillow/Pillow/issues)
- [Pull requests](https://github.com/python-pillow/Pillow/pulls)
- [Release notes](https://pillow.readthedocs.io/en/stable/releasenotes/index.html)
-- [Changelog](https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst)
+- [Changelog](https://github.com/python-pillow/Pillow/releases)
- [Pre-fork](https://github.com/python-pillow/Pillow/blob/main/CHANGES.rst#pre-fork)
-## Report a Vulnerability
+## Report a vulnerability
To report a security vulnerability, please follow the procedure described in the [Tidelift security policy](https://tidelift.com/docs/security).
diff --git a/RELEASING.md b/RELEASING.md
index 9e6ec5dd4c1..3c6188c8261 100644
--- a/RELEASING.md
+++ b/RELEASING.md
@@ -1,46 +1,25 @@
-# Release Checklist
+# Release checklist
See https://pillow.readthedocs.io/en/stable/releasenotes/versioning.html for
information about how the version numbers line up with releases.
-## Main Release
+## Main release
Released quarterly on January 2nd, April 1st, July 1st and October 15th.
-* [ ] Open a release ticket e.g. https://github.com/python-pillow/Pillow/issues/3154
-* [ ] Develop and prepare release in `main` branch.
-* [ ] Check [GitHub Actions](https://github.com/python-pillow/Pillow/actions) and [AppVeyor](https://ci.appveyor.com/project/python-pillow/Pillow) to confirm passing tests in `main` branch.
-* [ ] Check that all the wheel builds pass the tests in the [GitHub Actions "Wheels" workflow](https://github.com/python-pillow/Pillow/actions/workflows/wheels.yml) jobs by manually triggering them.
-* [ ] In compliance with [PEP 440](https://peps.python.org/pep-0440/), update version identifier in `src/PIL/_version.py`
-* [ ] Update `CHANGES.rst`.
-* [ ] Run pre-release check via `make release-test` in a freshly cloned repo.
-* [ ] Create branch and tag for release e.g.:
- ```bash
- git branch 5.2.x
- git tag 5.2.0
- git push --tags
- ```
-* [ ] Check the [GitHub Actions "Wheels" workflow](https://github.com/python-pillow/Pillow/actions/workflows/wheels.yml)
- has passed, including the "Upload release to PyPI" job. This will have been triggered
- by the new tag.
-* [ ] Publish the [release on GitHub](https://github.com/python-pillow/Pillow/releases).
-* [ ] In compliance with [PEP 440](https://peps.python.org/pep-0440/),
- increment and append `.dev0` to version identifier in `src/PIL/_version.py` and then:
- ```bash
- git push --all
- ```
-## Point Release
+* [ ] Create a new issue and select the "Maintainers only: Release" template.
+
+## Point release
Released as needed for security, installation or critical bug fixes.
* [ ] Make necessary changes in `main` branch.
-* [ ] Update `CHANGES.rst`.
* [ ] Check out release branch e.g.:
```bash
git checkout -t remotes/origin/5.2.x
```
* [ ] Cherry pick individual commits from `main` branch to release branch e.g. `5.2.x`, then `git push`.
-* [ ] Check [GitHub Actions](https://github.com/python-pillow/Pillow/actions) and [AppVeyor](https://ci.appveyor.com/project/python-pillow/Pillow) to confirm passing tests in release branch e.g. `5.2.x`.
+* [ ] Check [GitHub Actions](https://github.com/python-pillow/Pillow/actions) to confirm passing tests in release branch e.g. `5.2.x`.
* [ ] In compliance with [PEP 440](https://peps.python.org/pep-0440/), update version identifier in `src/PIL/_version.py`
* [ ] Run pre-release check via `make release-test`.
* [ ] Create tag for release e.g.:
@@ -60,7 +39,7 @@ Released as needed for security, installation or critical bug fixes.
git push
```
-## Embargoed Release
+## Embargoed release
Released as needed privately to individual vendors for critical security-related bug fixes.
@@ -84,7 +63,7 @@ Released as needed privately to individual vendors for critical security-related
git push origin 2.5.x
```
-## Publicize Release
+## Publicize release
* [ ] Announce release availability via [Mastodon](https://fosstodon.org/@pillow) e.g. https://fosstodon.org/@pillow/110639450470725321
@@ -92,7 +71,7 @@ Released as needed privately to individual vendors for critical security-related
* [ ] Make sure the [default version for Read the Docs](https://pillow.readthedocs.io/en/stable/) is up-to-date with the release changes
-## Docker Images
+## Docker images
* [ ] Update Pillow in the Docker Images repository
```bash
diff --git a/Tests/README.rst b/Tests/README.rst
index 2d014e5a46e..a955ec4fa56 100644
--- a/Tests/README.rst
+++ b/Tests/README.rst
@@ -1,4 +1,4 @@
-Pillow Tests
+Pillow tests
============
Test scripts are named ``test_xxx.py``. Helper classes and functions can be found in ``helper.py``.
diff --git a/Tests/bench_cffi_access.py b/Tests/bench_cffi_access.py
deleted file mode 100644
index c7d105836aa..00000000000
--- a/Tests/bench_cffi_access.py
+++ /dev/null
@@ -1,54 +0,0 @@
-from __future__ import annotations
-
-import time
-
-from PIL import PyAccess
-
-from .helper import hopper
-
-# Not running this test by default. No DOS against CI.
-
-
-def iterate_get(size, access) -> None:
- (w, h) = size
- for x in range(w):
- for y in range(h):
- access[(x, y)]
-
-
-def iterate_set(size, access) -> None:
- (w, h) = size
- for x in range(w):
- for y in range(h):
- access[(x, y)] = (x % 256, y % 256, 0)
-
-
-def timer(func, label, *args) -> None:
- iterations = 5000
- starttime = time.time()
- for x in range(iterations):
- func(*args)
- if time.time() - starttime > 10:
- break
- endtime = time.time()
- print(
- f"{label}: completed {x + 1} iterations in {endtime - starttime:.4f}s, "
- f"{(endtime - starttime) / (x + 1.0):.6f}s per iteration"
- )
-
-
-def test_direct() -> None:
- im = hopper()
- im.load()
- # im = Image.new("RGB", (2000, 2000), (1, 3, 2))
- caccess = im.im.pixel_access(False)
- access = PyAccess.new(im, False)
-
- assert access is not None
- assert caccess[(0, 0)] == access[(0, 0)]
-
- print(f"Size: {im.width}x{im.height}")
- timer(iterate_get, "PyAccess - get", im.size, access)
- timer(iterate_set, "PyAccess - set", im.size, access)
- timer(iterate_get, "C-api - get", im.size, caccess)
- timer(iterate_set, "C-api - set", im.size, caccess)
diff --git a/Tests/check_wheel.py b/Tests/check_wheel.py
deleted file mode 100644
index 4b91984f58a..00000000000
--- a/Tests/check_wheel.py
+++ /dev/null
@@ -1,43 +0,0 @@
-from __future__ import annotations
-
-import sys
-
-from PIL import features
-
-
-def test_wheel_modules() -> None:
- expected_modules = {"pil", "tkinter", "freetype2", "littlecms2", "webp"}
-
- # tkinter is not available in cibuildwheel installed CPython on Windows
- try:
- import tkinter
-
- assert tkinter
- except ImportError:
- expected_modules.remove("tkinter")
-
- assert set(features.get_supported_modules()) == expected_modules
-
-
-def test_wheel_codecs() -> None:
- expected_codecs = {"jpg", "jpg_2000", "zlib", "libtiff"}
-
- assert set(features.get_supported_codecs()) == expected_codecs
-
-
-def test_wheel_features() -> None:
- expected_features = {
- "webp_anim",
- "webp_mux",
- "transp_webp",
- "raqm",
- "fribidi",
- "harfbuzz",
- "libjpeg_turbo",
- "xcb",
- }
-
- if sys.platform == "win32":
- expected_features.remove("xcb")
-
- assert set(features.get_supported_features()) == expected_features
diff --git a/Tests/createfontdatachunk.py b/Tests/createfontdatachunk.py
old mode 100755
new mode 100644
index 41c76f87eac..0a3fdb809ed
--- a/Tests/createfontdatachunk.py
+++ b/Tests/createfontdatachunk.py
@@ -1,4 +1,3 @@
-#!/usr/bin/env python3
from __future__ import annotations
import base64
diff --git a/Tests/fonts/AdobeVFPrototypeDuplicates.ttf b/Tests/fonts/AdobeVFPrototypeDuplicates.ttf
new file mode 100644
index 00000000000..acf0bc156c8
Binary files /dev/null and b/Tests/fonts/AdobeVFPrototypeDuplicates.ttf differ
diff --git a/Tests/fonts/LICENSE.txt b/Tests/fonts/LICENSE.txt
index 3c8a23197e9..94989af9035 100644
--- a/Tests/fonts/LICENSE.txt
+++ b/Tests/fonts/LICENSE.txt
@@ -2,7 +2,7 @@
NotoNastaliqUrdu-Regular.ttf and NotoSansSymbols-Regular.ttf, from https://github.com/googlei18n/noto-fonts
NotoSans-Regular.ttf, from https://www.google.com/get/noto/
NotoSansJP-Thin.otf, from https://www.google.com/get/noto/help/cjk/
-AdobeVFPrototype.ttf, from https://github.com/adobe-fonts/adobe-variable-font-prototype
+AdobeVFPrototype.ttf, from https://github.com/adobe-fonts/adobe-variable-font-prototype. AdobeVFPrototypeDuplicates.ttf is a modified version of this
TINY5x3GX.ttf, from http://velvetyne.fr/fonts/tiny
ArefRuqaa-Regular.ttf, from https://github.com/google/fonts/tree/master/ofl/arefruqaa
ter-x20b.pcf, from http://terminus-font.sourceforge.net/
diff --git a/Tests/fonts/fuzz_font-5203009437302784 b/Tests/fonts/fuzz_font-5203009437302784
index 0465e48c204..fb401fea225 100644
--- a/Tests/fonts/fuzz_font-5203009437302784
+++ b/Tests/fonts/fuzz_font-5203009437302784
@@ -1,10 +1,10 @@
STARTFONT
FONT
SIZE 10
-FONTBOUNDINGBOX
-CHARS
+FONTBOUNDINGBOX 1 1 0 0
+CHARS 1
STARTCHAR
-ENCODING
+ENCODING 65
BBX 2 5
ENDCHAR
ENDFONT
diff --git a/Tests/helper.py b/Tests/helper.py
index 605a214d400..d77b4b807ec 100644
--- a/Tests/helper.py
+++ b/Tests/helper.py
@@ -9,17 +9,21 @@
import shutil
import subprocess
import sys
-import sysconfig
import tempfile
from functools import lru_cache
from io import BytesIO
-from typing import Any, Callable, Sequence
import pytest
from packaging.version import parse as parse_version
from PIL import Image, ImageFile, ImageMath, features
+TYPE_CHECKING = False
+if TYPE_CHECKING:
+ from collections.abc import Callable, Sequence
+ from pathlib import Path
+ from typing import Any
+
logger = logging.getLogger(__name__)
uploader = None
@@ -51,17 +55,15 @@ def convert_to_comparable(
if a.mode == "P":
new_a = Image.new("L", a.size)
new_b = Image.new("L", b.size)
- new_a.putdata(a.getdata())
- new_b.putdata(b.getdata())
+ new_a.putdata(a.get_flattened_data())
+ new_b.putdata(b.get_flattened_data())
elif a.mode == "I;16":
new_a = a.convert("I")
new_b = b.convert("I")
return new_a, new_b
-def assert_deep_equal(
- a: Sequence[Any], b: Sequence[Any], msg: str | None = None
-) -> None:
+def assert_deep_equal(a: Any, b: Any, msg: str | None = None) -> None:
try:
assert len(a) == len(b), msg or f"got length {len(a)}, expected {len(b)}"
except Exception:
@@ -97,12 +99,14 @@ def assert_image_equal(a: Image.Image, b: Image.Image, msg: str | None = None) -
def assert_image_equal_tofile(
- a: Image.Image, filename: str, msg: str | None = None, mode: str | None = None
+ a: Image.Image,
+ filename: str | Path,
+ msg: str | None = None,
+ mode: str | None = None,
) -> None:
- with Image.open(filename) as img:
- if mode:
- img = img.convert(mode)
- assert_image_equal(a, img, msg)
+ with Image.open(filename) as im:
+ converted_im = im.convert(mode) if mode else im
+ assert_image_equal(a, converted_im, msg)
def assert_image_similar(
@@ -138,21 +142,14 @@ def assert_image_similar(
def assert_image_similar_tofile(
a: Image.Image,
- filename: str,
+ filename: str | Path,
epsilon: float,
msg: str | None = None,
- mode: str | None = None,
) -> None:
with Image.open(filename) as img:
- if mode:
- img = img.convert(mode)
assert_image_similar(a, img, epsilon, msg)
-def assert_all_same(items: Sequence[Any], msg: str | None = None) -> None:
- assert items.count(items[0]) == len(items), msg
-
-
def assert_not_all_same(items: Sequence[Any], msg: str | None = None) -> None:
assert items.count(items[0]) != len(items), msg
@@ -166,11 +163,25 @@ def assert_tuple_approx_equal(
pytest.fail(msg + ": " + repr(actuals) + " != " + repr(targets))
+def timeout_unless_slower_valgrind(timeout: float) -> pytest.MarkDecorator:
+ if "PILLOW_VALGRIND_TEST" in os.environ:
+ return pytest.mark.pil_noop_mark()
+ return pytest.mark.timeout(timeout)
+
+
def skip_unless_feature(feature: str) -> pytest.MarkDecorator:
reason = f"{feature} not available"
return pytest.mark.skipif(not features.check(feature), reason=reason)
+def has_feature_version(feature: str, required: str) -> bool:
+ version = features.version(feature)
+ assert version is not None
+ version_required = parse_version(required)
+ version_available = parse_version(version)
+ return version_available >= version_required
+
+
def skip_unless_feature_version(
feature: str, required: str, reason: str | None = None
) -> pytest.MarkDecorator:
@@ -270,17 +281,13 @@ def _cached_hopper(mode: str) -> Image.Image:
im = hopper("L")
else:
im = hopper()
- if mode.startswith("BGR;"):
- with pytest.warns(DeprecationWarning):
- im = im.convert(mode)
- else:
- try:
- im = im.convert(mode)
- except ImportError:
- if mode == "LAB":
- im = Image.open("Tests/images/hopper.Lab.tif")
- else:
- raise
+ try:
+ im = im.convert(mode)
+ except ImportError:
+ if mode == "LAB":
+ im = Image.open("Tests/images/hopper.Lab.tif")
+ else:
+ raise
return im
@@ -294,16 +301,6 @@ def djpeg_available() -> bool:
return False
-def cjpeg_available() -> bool:
- if shutil.which("cjpeg"):
- try:
- subprocess.check_call(["cjpeg", "-version"])
- return True
- except subprocess.CalledProcessError: # pragma: no cover
- return False
- return False
-
-
def netpbm_available() -> bool:
return bool(shutil.which("ppmquant") and shutil.which("ppmtogif"))
@@ -328,16 +325,7 @@ def magick_command() -> list[str] | None:
return None
-def on_appveyor() -> bool:
- return "APPVEYOR" in os.environ
-
-
-def on_github_actions() -> bool:
- return "GITHUB_ACTIONS" in os.environ
-
-
def on_ci() -> bool:
- # GitHub Actions and AppVeyor have "CI"
return "CI" in os.environ
@@ -359,10 +347,6 @@ def is_pypy() -> bool:
return hasattr(sys, "pypy_translation_info")
-def is_mingw() -> bool:
- return sysconfig.get_platform() == "mingw"
-
-
class CachedProperty:
def __init__(self, func: Callable[[Any], Any]) -> None:
self.func = func
diff --git a/Tests/images/avif/exif.avif b/Tests/images/avif/exif.avif
new file mode 100644
index 00000000000..07964487f3c
Binary files /dev/null and b/Tests/images/avif/exif.avif differ
diff --git a/Tests/images/avif/hopper-missing-pixi.avif b/Tests/images/avif/hopper-missing-pixi.avif
new file mode 100644
index 00000000000..c793ade1c21
Binary files /dev/null and b/Tests/images/avif/hopper-missing-pixi.avif differ
diff --git a/Tests/images/avif/hopper.avif b/Tests/images/avif/hopper.avif
new file mode 100644
index 00000000000..87e4394f059
Binary files /dev/null and b/Tests/images/avif/hopper.avif differ
diff --git a/Tests/images/avif/hopper.heif b/Tests/images/avif/hopper.heif
new file mode 100644
index 00000000000..f6dbd1b4775
Binary files /dev/null and b/Tests/images/avif/hopper.heif differ
diff --git a/Tests/images/avif/hopper_avif_write.png b/Tests/images/avif/hopper_avif_write.png
new file mode 100644
index 00000000000..a47a0562bbc
Binary files /dev/null and b/Tests/images/avif/hopper_avif_write.png differ
diff --git a/Tests/images/avif/icc_profile.avif b/Tests/images/avif/icc_profile.avif
new file mode 100644
index 00000000000..658cfec176e
Binary files /dev/null and b/Tests/images/avif/icc_profile.avif differ
diff --git a/Tests/images/avif/icc_profile_none.avif b/Tests/images/avif/icc_profile_none.avif
new file mode 100644
index 00000000000..c73e70a3a52
Binary files /dev/null and b/Tests/images/avif/icc_profile_none.avif differ
diff --git a/Tests/images/avif/rot0mir0.avif b/Tests/images/avif/rot0mir0.avif
new file mode 100644
index 00000000000..f5720309365
Binary files /dev/null and b/Tests/images/avif/rot0mir0.avif differ
diff --git a/Tests/images/avif/rot0mir1.avif b/Tests/images/avif/rot0mir1.avif
new file mode 100644
index 00000000000..8a9fb5e5431
Binary files /dev/null and b/Tests/images/avif/rot0mir1.avif differ
diff --git a/Tests/images/avif/rot1mir0.avif b/Tests/images/avif/rot1mir0.avif
new file mode 100644
index 00000000000..0c7c7620fd4
Binary files /dev/null and b/Tests/images/avif/rot1mir0.avif differ
diff --git a/Tests/images/avif/rot1mir1.avif b/Tests/images/avif/rot1mir1.avif
new file mode 100644
index 00000000000..0181b088cec
Binary files /dev/null and b/Tests/images/avif/rot1mir1.avif differ
diff --git a/Tests/images/avif/rot2mir0.avif b/Tests/images/avif/rot2mir0.avif
new file mode 100644
index 00000000000..ddaa02f3f89
Binary files /dev/null and b/Tests/images/avif/rot2mir0.avif differ
diff --git a/Tests/images/avif/rot2mir1.avif b/Tests/images/avif/rot2mir1.avif
new file mode 100644
index 00000000000..63326b86caa
Binary files /dev/null and b/Tests/images/avif/rot2mir1.avif differ
diff --git a/Tests/images/avif/rot3mir0.avif b/Tests/images/avif/rot3mir0.avif
new file mode 100644
index 00000000000..ed5dbe3d0bb
Binary files /dev/null and b/Tests/images/avif/rot3mir0.avif differ
diff --git a/Tests/images/avif/rot3mir1.avif b/Tests/images/avif/rot3mir1.avif
new file mode 100644
index 00000000000..ccd8861d5ae
Binary files /dev/null and b/Tests/images/avif/rot3mir1.avif differ
diff --git a/Tests/images/avif/star.avifs b/Tests/images/avif/star.avifs
new file mode 100644
index 00000000000..f2753395f8c
Binary files /dev/null and b/Tests/images/avif/star.avifs differ
diff --git a/Tests/images/avif/star.gif b/Tests/images/avif/star.gif
new file mode 100644
index 00000000000..52076cafdd8
Binary files /dev/null and b/Tests/images/avif/star.gif differ
diff --git a/Tests/images/avif/star.png b/Tests/images/avif/star.png
new file mode 100644
index 00000000000..468dcde005d
Binary files /dev/null and b/Tests/images/avif/star.png differ
diff --git a/Tests/images/avif/transparency.avif b/Tests/images/avif/transparency.avif
new file mode 100644
index 00000000000..f808357fc7c
Binary files /dev/null and b/Tests/images/avif/transparency.avif differ
diff --git a/Tests/images/avif/xmp_tags_orientation.avif b/Tests/images/avif/xmp_tags_orientation.avif
new file mode 100644
index 00000000000..41faa60501b
Binary files /dev/null and b/Tests/images/avif/xmp_tags_orientation.avif differ
diff --git a/Tests/images/bmp/html/bkgd.png b/Tests/images/bmp/html/bkgd.png
deleted file mode 100644
index d66ca9d6526..00000000000
Binary files a/Tests/images/bmp/html/bkgd.png and /dev/null differ
diff --git a/Tests/images/bmp/html/bmpsuite.html b/Tests/images/bmp/html/bmpsuite.html
deleted file mode 100644
index b8e327ed927..00000000000
--- a/Tests/images/bmp/html/bmpsuite.html
+++ /dev/null
@@ -1,578 +0,0 @@
-
-
-
-
-
-For BMP Suite -version 2.3
- -This document describes the images in BMP Suite, and shows what -I allege to be the correct way to interpret them. PNG and JPEG images are -used for reference. -
- -It also shows how your web browser displays the BMP images, -but that’s not its main purpose. -BMP is poor image format to use on web pages, so a web browser’s -level of support for it is arguably not important.
- -| File | -Ver. | -Correct display | -In your browser | -Notes | -
|---|---|---|---|---|
| g/pal1.bmp | -3 | - |
-  |
- 1 bit/pixel paletted image, in which black is the first color in - the palette. | -
| g/pal1wb.bmp | -3 | - |
-  |
- 1 bit/pixel paletted image, in which white is the first color in - the palette. | -
| g/pal1bg.bmp | -3 | - |
-  |
- 1 bit/pixel paletted image, with colors other than black and white. | -
| q/pal1p1.bmp | -3 | - |
-  |
- 1 bit/pixel paletted image, with only one color in the palette. - The documentation says that 1-bpp images have a palette size of 2 - (not “up to 2”), but it would be silly for a viewer not to - support a size of 1. | -
| q/pal2.bmp | -3 | - |
-  |
- A paletted image with 2 bits/pixel. Usually only 1, 4, - and 8 are allowed, but 2 is legal on Windows CE. | -
| g/pal4.bmp | -3 | - |
-  |
- Paletted image with 12 palette colors, and 4 bits/pixel. | -
| g/pal4rle.bmp | -3 | - |
-  |
- 4-bit image that uses RLE compression. | -
| q/pal4rletrns.bmp | -3 | - - or  - or  |
-  |
- An RLE-compressed image that used “delta” - codes to skip over some pixels, leaving them undefined. Some viewers - make undefined pixels transparent, others make them black, and - others assign them palette color 0 (purple, in this case). | -
| g/pal8.bmp | -3 | - |
-  |
- Our standard paletted image, with 252 palette colors, and 8 - bits/pixel. | -
| g/pal8-0.bmp | -3 | - |
-  |
- Every field that can be set to 0 is set to 0: pixels/meter=0; - colors used=0 (meaning the default 256); size-of-image=0. | -
| g/pal8rle.bmp | -3 | - |
-  |
- 8-bit image that uses RLE compression. | -
| q/pal8rletrns.bmp | -3 | - - or  - or  |
-  |
- 8-bit version of q/pal4rletrns.bmp. | -
| g/pal8w126.bmp | -3 | - |
-  |
- Images with different widths and heights. - In BMP format, rows are padded to a multiple of four bytes, so we - test all four possibilities. | -
| g/pal8w125.bmp | -3 | - |
-  |
- |
| g/pal8w124.bmp | -3 | - |
-  |
- |
| g/pal8topdown.bmp | -3 | - |
-  |
- BMP images are normally stored from the bottom up, but - there is a way to store them from the top down. | -
| q/pal8offs.bmp | -3 | - |
-  |
- A file with some unused bytes between the palette and the - image. This is probably valid, but I’m not 100% sure. | -
| q/pal8oversizepal.bmp | -3 | - |
-  |
- An 8-bit image with 300 palette colors. This may be invalid, - because the documentation could - be interpreted to imply that 8-bit images aren’t allowed - to have more than 256 colors. | -
| g/pal8nonsquare.bmp | -3 | -
-  - or - 
- |
-  |
- An image with non-square pixels: the X pixels/meter is twice - the Y pixels/meter. Image editors can be expected to - leave the image “squashed”; image viewers should - consider stretching it to its correct proportions. | -
| g/pal8os2.bmp | -OS/2v1 | - |
-  |
- An OS/2-style bitmap. | -
| q/pal8os2sp.bmp | -OS/2v1 | - |
-  |
- An OS/2v1 with a less-than-full-sized palette. - Probably not valid, but such files have been seen in the wild. | -
| q/pal8os2v2.bmp | -OS/2v2 | - |
-  |
- My attempt to make an OS/2v2 bitmap. | -
| q/pal8os2v2-16.bmp | -OS/2v2 | - |
-  |
- An OS/2v2 bitmap whose header has only 16 bytes, instead of the full 64. | -
| g/pal8v4.bmp | -4 | - |
-  |
- A v4 bitmap. I’m not sure that the gamma and chromaticity values in - this file are sensible, because I can’t find any detailed documentation - of them. | -
| g/pal8v5.bmp | -5 | - |
-  |
- A v5 bitmap. Version 5 has additional colorspace options over v4, so it - is easier to create, and ought to be more portable. | -
| g/rgb16.bmp | -3 | - |
-  |
- A 16-bit image with the default color format: 5 bits each for red, - green, and blue, and 1 unused bit. - The whitest colors should (I assume) be displayed as pure white: - (255,255,255), not - (248,248,248). | -
| g/rgb16-565.bmp | -3 | - |
-  |
- A 16-bit image with a BITFIELDS segment indicating 5 red, 6 green, - and 5 blue bits. This is a standard 16-bit format, even supported by - old versions of Windows that don’t support any other non-default 16-bit - formats. - The whitest colors should be displayed as pure white: - (255,255,255), not - (248,252,248). | -
| g/rgb16-565pal.bmp | -3 | - |
-  |
- A 16-bit image with both a BITFIELDS segment and a palette. | -
| q/rgb16-231.bmp | -3 | - |
-  |
- An unusual and silly 16-bit image, with 2 red bits, 3 green bits, and 1 - blue bit. Most viewers do support this image, but the colors may be darkened - with a yellow-green shadow. That’s because they’re doing simple - bit-shifting (possibly including one round of bit replication), instead of - proper scaling. | -
| q/rgba16-4444.bmp | -5 | - |
-  |
- A 16-bit image with an alpha channel. There are 4 bits for each color - channel, and 4 bits for the alpha channel. - It’s not clear if this is valid, but I can’t find anything that - suggests it isn’t. - | -
| g/rgb24.bmp | -3 | - |
-  |
- A perfectly ordinary 24-bit (truecolor) image. | -
| g/rgb24pal.bmp | -3 | - |
-  |
- A 24-bit image, with a palette containing 256 colors. There is little if - any reason for a truecolor image to contain a palette, but it is legal. | -
| q/rgb24largepal.bmp | -3 | - |
-  |
- A 24-bit image, with a palette containing 300 colors. - The fact that the palette has more than 256 colors may cause some viewers - to complain, but the documentation does not mention a size limit. | -
| q/rgb24prof.bmp | -5 | - |
-  |
- My attempt to make a BMP file with an embedded color profile. | -
| q/rgb24lprof.bmp | -5 | - |
-  |
- My attempt to make a BMP file with a linked color profile. | -
| q/rgb24jpeg.bmp | -5 | - |
-  |
- My attempt to make BMP files with embedded JPEG and PNG images. - These are not likely to be supported by much of anything (they’re - intended for printers). | -
| q/rgb24png.bmp | -5 | - |
-  |
- |
| g/rgb32.bmp | -3 | - |
-  |
- A 32-bit image using the default color format for 32-bit images (no - BITFIELDS segment). There are 8 bits per color channel, and 8 unused - bits. The unused bits are set to 0. | -
| g/rgb32bf.bmp | -3 | - |
-  |
- A 32-bit image with a BITFIELDS segment. As usual, there are 8 bits per - color channel, and 8 unused bits. But the color channels are in an unusual - order, so the viewer must read the BITFIELDS, and not just guess. | -
| q/rgb32fakealpha.bmp | -3 | -- or - 
- |
-  |
- Same as g/rgb32.bmp, except that the unused bits are set to something - other than 0. - If the image becomes transparent toward the bottom, it probably means - the viewer uses heuristics to guess whether the undefined - data represents transparency. | -
| q/rgb32-111110.bmp | -3 | - |
-  |
- A 32 bits/pixel image, with all 32 bits used: 11 each for red and - green, and 10 for blue. As far as I know, this is perfectly valid, but it - is unusual. | -
| q/rgba32.bmp | -5 | - |
-  |
- A BMP with an alpha channel. Transparency is barely documented, - so it’s possible that this file is not correctly formed. - The color channels are in an unusual order, to prevent viewers from - passing this test by making a lucky guess. | -
| q/rgba32abf.bmp | -3 | - |
-  |
- An image of type BI_ALHPABITFIELDS. Supposedly, this was used on - Windows CE. I don’t know whether it is constructed correctly. | -
| b/badbitcount.bmp | -3 | -N/A | - |
- Header indicates an absurdly large number of bits/pixel. | -
| b/badbitssize.bmp | -3 | -N/A | - |
- Header incorrectly indicates that the bitmap is several GB in size. | -
| b/baddens1.bmp | -3 | -N/A | - |
- Density (pixels per meter) suggests the image is much - larger in one dimension than the other. | -
| b/baddens2.bmp | -3 | -N/A | - |
- |
| b/badfilesize.bmp | -3 | -N/A | - |
- Header incorrectly indicates that the file is several GB in size. | -
| b/badheadersize.bmp | -? | -N/A | - |
- Header size is 66 bytes, which is not a valid size for any known BMP - version. | -
| b/badpalettesize.bmp | -3 | -N/A | - |
- Header incorrectly indicates that the palette contains an absurdly large - number of colors. | -
| b/badplanes.bmp | -3 | -N/A | - |
- The “planes” setting, which is required to be 1, is not 1. | -
| b/badrle.bmp | -3 | -N/A | - |
- An invalid RLE-compressed image that tries to cause buffer overruns. | -
| b/badwidth.bmp | -3 | -N/A | - |
- The image claims to be a negative number of pixels in width. | -
| b/pal8badindex.bmp | -3 | -N/A | - |
- Many of the palette indices used in the image are not present in the - palette. | -
| b/reallybig.bmp | -3 | -N/A | - |
- An image with a very large reported width and height. | -
| b/rletopdown.bmp | -3 | -N/A | - |
- An RLE-compressed image that tries to use top-down orientation, - which isn’t allowed. | -
| b/shortfile.bmp | -3 | -N/A | - |
- A file that has been truncated in the middle of the bitmap. | -