pillow-heif 0.1.5

Python 3.7+ interface to libheif library

pillow_heif

A HEIF/HEIC add-on for Pillow using the libheif library via CFFI.

Binary wheels for Python 3.7-3.10. Linux(+Alpine)/macOS - x64/aarch64(+M1).

Version 0.1.4 was last to support Python 3.6 and still can be used.

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

(Recommended) 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
pip3 install git+https://github.com/bigcat88/pillow_heif.git

If on macOS it fails with installing from source, just try second time(helps me on M1 with Monterey):

pip3 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