JPEG Image Quality in PIL
JPEG Image Quality in PIL
Introduction
The other day, I was haunted by a bug and found that it was an issue with the image quality saved by Pillow after spending a few hours debugging the code.
Initially, the workflow of my code was like loading the JPEG image with PIL and after some operation, saving the image again. But I didn’t give any other parameters except the file name when using Image.save()
method.
The quality parameter
After looking up the documentation, I find that PIL will save the image with quality factor 75 by default so that the image quality is decreased. The documentation for quality
says:
The image quality, on a scale from 1 (worst) to 95 (best). The default is 75. Values above 95 should be avoided; 100 disables portions of the JPEG compression algorithm, and results in large files with hardly any gain in image quality.
Using a quality factor of 95 should be enough to preserve the image quality:
img.save('test.jpg', quality=95)
Subsampling
According to this post, even if you use quality=100
, the saved image will still be slightly different from the original image. This is because PIL will also use subsampling technique to reduce the image size. You can use subsampling=0
to turn off this feature. Overall, to retain the content of original image, you may use:
img.save('test.jpg', quality=100, subsampling=0)
Other options for quality
For JPEG files, there are also a list of preset options you can use for the quality
parameter, such web_high
, high
. The complete list of options can be found here. These preset options will set the subsampling
factor and quantization table which is used in image quantization process.