Python envelope for the popular C library libjpeg for handling JPEG files.
Project description
jpeglib
Python envelope for the popular C library libjpeg for handling JPEG files.
libjpeg offers full control over compression and decompression and exposes DCT coefficients and quantization tables.
Installation
Simply install the package with pip3
pip install jpeglib
or using the cloned repository
python setup.py install
:warning: This will install
jpeglibtogether with multiple versions of libjpeg, libjpeg-turbo and mozjpeg. For common architectures/OS we provide prebuilt wheels, but installing from source takes couple of minutes.
Usage
Import the library in Python 3
import jpeglib
DCT
Get discrete cosine transform (DCT) coefficients and quantization matrices as numpy array
im = jpeglib.read_dct('input.jpeg')
im.Y; im.Cb; im.Cr; im.qt
You get luminance DCT, chrominance DCT and quantization tables.
Write the DCT coefficients back to a file with
im.write_dct('output.jpeg')
Pixel data
Decompress the input.jpeg into spatial representation in numpy array with
im = jpeglib.read_spatial('input.jpeg')
im.spatial
You can specify parameters such as output color space, DCT method, dithering, etc.
Write spatial representation in numpy arrray back to file with
im.write_spatial('output.jpeg')
You can specify input color space, DCT method, sampling factor, output quality, smoothing factor etc.
You can find all the details in the documentation.
libjpeg version
It is possible to choose, which version of libjpeg should be used.
jpeglib.version.set('6b')
Currently jpeglib supports all versions of libjpeg from 6b to 9e, libjpeg-turbo 2.1.0 and mozjpeg 4.0.3.
Their source codes is baked inside the package and thus distributed with it, avoiding external dependency.
Get currently used libjpeg version by
version = jpeglib.version.get()
You can also set a libjpeg version for a scope only.
jpeglib.version.set('6b')
im = jpeglib.read_spatial('image.jpeg') # using 6b
with jpeglib.version('9e'):
im = jpeglib.read_spatial('image.jpeg') # using 9e
im = jpeglib.read_spatial('image.jpeg') # using 6b again
Credits
Developed by Martin Benes, University of Innsbruck, 2023.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for jpeglib-1.0.0-cp38-abi3-win_amd64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c6401374eadec6f94f3f7235e2a8b6f1c4a371362b84cf21c9ff12fe88639170 |
|
| MD5 | 89dbaeb8bb82ae4e357c311d66b0b4bf |
|
| BLAKE2b-256 | 33c6504daf0c70279f016d88e7823628162d000f24a7d6883a571175f5ce29a1 |
Hashes for jpeglib-1.0.0-cp38-abi3-win32.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | f3714aa038de4a8527ce51b41d5d42f60db1052b507bd3787fb61c82c1dbcb24 |
|
| MD5 | 6b106f40d2ff29d9db9c6a971d06f820 |
|
| BLAKE2b-256 | 38ffcf212c3955263f8b8650ae57e17c98fe11a2af048965958e3f22256c75ce |
Hashes for jpeglib-1.0.0-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 5a19bb64edd9b0b6551b893ee9e5728fcfe0e0e828a3c4b9b5f548075c44dbf1 |
|
| MD5 | bdf881e9d0a689a92f4c0200895f9c4a |
|
| BLAKE2b-256 | 2b9a905e89b8b4cbad594c49b547a805d88d6419f5b000b9f439e0cb8d2d8402 |
Hashes for jpeglib-1.0.0-cp38-abi3-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 57937a46fe420bd292c5f7dee7a78e9132740512858f98ca4b3d533b9dc49883 |
|
| MD5 | e369759172209afaae4687b2bec7024d |
|
| BLAKE2b-256 | 20dee648fbcf0bb09e61f15abf56bbe02cf9c6936736ef97e91d50a0d83aea2e |
Hashes for jpeglib-1.0.0-cp38-abi3-macosx_11_0_arm64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | d207a659723bd730d5e89b647852f5b62abcca988f20afd2935e32a94f59a452 |
|
| MD5 | a32378cb32e771408699d85d20690493 |
|
| BLAKE2b-256 | 3589816f22265188e4ec683c0284640d1b59decc9b11a267dc5e3380557c8c07 |
Hashes for jpeglib-1.0.0-cp38-abi3-macosx_10_9_x86_64.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | eb31cc39fbcd96b1edbb3b92075fed64328d82e7840dea912ce7f441aef19811 |
|
| MD5 | 2279539c3f8dcb52c659c236c825463d |
|
| BLAKE2b-256 | 49994cbbde28e1f6a4fbd94c3a6bfd91bc1319ce54b2ce00719196a1cd6619dd |
Hashes for jpeglib-1.0.0-cp38-abi3-macosx_10_9_universal2.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 015a5043d0e6d345d2f41aaf872ed03bf69275b19ecac375c0a815862dd2e006 |
|
| MD5 | f350a5044180d59b0ede2eb64ce6648d |
|
| BLAKE2b-256 | 93aa65f0ea4f0bf6e2918c3ac544b145846df9eae0c4f4a938f3c0195438944c |
