pillow-jpls 1.2.0

A JPEG-LS plugin for the Pillow imaging library

JPEG-LS plugin for Python Pillow

A plugin for the Python Pillow imaging library for the JPEG-LS codec, based on the Charls JPEG-LS implemetation. Python bindings implemented using pybind11.

Available on the Python Package Index

Usage

pip install pillow-jpls

With Pillow

import pillow_jpls
from PIL import Image
from io import BytesIO

img = Image.open("image.jls")
img.save("image_copy.jls)

# Saving to a buffer
buffer = BytesIO()
img.save(buffer, "JPEG-LS")

Options

The encoder supports the following options. See the specification for details, and the tests for example usage.

• near_lossless : 0 is lossless - the default.
• interleave : one of none, line or sample
• bits_per_component : override the number of bits encoded per component, otherwise taken from the image format
• maxval: override the maximum value of any component, otherwise taken from bits_per_component
• t1
• t2
• t3
• reset
• spiff: Use a SPIFF image header, generated by default. Use None to just use a standard JPEG header.

Build

The build is driven by PEP 517 and Scikit Build. cibuildwheel is used to generate packages using Github Actions, and C++ dependencies are satisfied by conan.

pip install pep517
python -m pep517.build --binary .

Tests

A suite of tests covering the applicable conformance tests from the specification is provided. You will need git-lfs to clone the data.

pip install pytest .
pytest -v test

Limitations

16 bit multichannel images are not supported, as these are not supported in Pillow. 16bit greyscale images are supported, however.

References

• JPEG-LS on Wikipedia
• The ITU T.87 Specification