pillow-heif 0.1.4

Python 3.6+ interface to libheif library

pillow_heif

A HEIF/HEIC add-on for Pillow using the libheif library via CFFI, with binary wheels (Python 3.6-3.9, linux/macos - x64, aarch64).

Mostly based on David Poirier's pyheif. The idea for this plugin came from Christian Bianciotto's pyheif-pillow-opener. Many thanks!

Pull requests are greatly welcome.

Installation

You can install pillow_heif from PyPi:

pip install pillow_heif

or from GitHub:

pip install https://github.com/bigcat88/pillow_heif/archive/master.zip

Installation from source

Linux Ubuntu

sudo add-apt-repository ppa:strukturag/libheif
apt install libffi libheif-dev libde265-dev
pip install git+https://github.com/bigcat88/pillow_heif.git

MacOS

brew install libffi libheif
pip install git+https://github.com/bigcat88/pillow_heif.git

Windows

With Visual Studio 2015+ C Compiler and SDK installed:

set INCLUDE=%INCLUDE%;X:\path\to\libheif\source
set LIB=%LIB%;X:\path\to\libheif\build
pip install git+https://github.com/bigcat88/pillow_heif.git

Example of use as opener

from PIL import Image
from pillow_heif import register_heif_opener

register_heif_opener()

image = Image.open('image.heic')
image.load()

Example of use as reader

from PIL import Image
import pillow_heif

heif_file = pillow_heif.read("ABC.HEIC")
image = Image.frombytes(
    heif_file.mode, 
    heif_file.size, 
    heif_file.data,
    "raw",
    heif_file.mode,
    heif_file.stride,
    )

The HeifFile object

The returned HeifFile has the following properties:

• size - the size of the image as a (width, height) tuple of integers
• brand - a list of heif_brand constants
• has_alpha - (bool)presence of alpha channel
• mode - the image mode, e.g. "RGB" or "RGBA"
• bit_depth - the number of bits in each component of a pixel
• metadata - a list of metadata dictionaries
• color_profile - a color profile dictionary
• data - the raw decoded file data, as bytes
• stride - the number of bytes in a row of decoded file data