Python Imaging Library

Capabilities

PIL offers several standard procedures for image manipulation. These include:

• per-pixel manipulations,
• masking and transparency handling,
• image filtering, such as blurring, contouring, smoothing, or edge finding,
• image enhancing, such as sharpening, adjusting brightness, contrast or color,
• adding text

File formats

Supported file formats include PPM, PNG, JPEG, GIF, TIFF, and BMP. PIL is extensible, allowing users to create custom decoders for any file format.

Programming examples

import os
from PIL import Image


def convert_jpegs_to_pngs(folder_path):
    # Checks if the provided path is a folder
    if not os.path.isdir(folder_path):
        print(f"Error: {folder_path} is not a valid folder.")
        return

    # Iterates over all files in the folder
    for filename in os.listdir(folder_path):
        # Checks if the file has a .jpg or .jpeg extension
        if filename.lower().endswith(".jpg") or filename.lower().endswith(".jpeg"):
            # Full path of the file
            jpeg_path = os.path.join(folder_path, filename)
            # Path for the converted file
            png_path = os.path.join(folder_path, os.path.splitext(filename)[0] + ".png")

            try:
                # Opens the JPEG image
                with Image.open(jpeg_path) as img:
                    # Converts and saves as PNG
                    img.save(png_path, "PNG")
                    print(f"Converted {jpeg_path} to {png_path}")
            except Exception as e:
                print(f"Error converting {jpeg_path}: {e}")

References

References

1. "Python Imaging Library".
2. "effbot / pil-2009-raclette".
3. "Software License".
4. "Release Notes".
5. "Pillow: a modern fork of PIL".
6. "Details of package python-imaging in sid". [[Software in the Public Interest]].
7. "Details of package python-imaging in raring". [[Canonical Ltd.]].
8. "PyAccess Module".
9. "ImageFilter Module".
10. "ImageColor Module".
11. "D. Writing Your Own File Decoder". Effbot.org.