cykooz-heif

cykooz.heif is simple python wrapper for the library libheif-rs.

RawHeifImage is a simple wrapper around low level HEIF-decoder.

Usage Examples

Read HEIF-image from file:

from cykooz.heif.image import RawHeifImage

img = RawHeifImage.from_path('data/test.heif')
assert img.width == 3024
assert img.height == 4032
assert img.mode == 'RGB'
assert len(img.data) == 36578304
assert img.stride == 9072
assert len(img.exif) == 2026

Read HEIF-image from file-like object:

from cykooz.heif.image import RawHeifImage

with open('data/test.heif') as fp
    img = RawHeifImage.from_stream(fp)
    assert img.width == 3024
    assert img.height == 4032

Also package provides an opener plugin for PIL (Pillow):

from PIL import Image
from cykooz.heif.pil import register_heif_opener

register_heif_opener()
img = Image.open('data/test.heif')
assert isinstance(img, Image.Image)
assert img.size == (3024, 4032)
assert img.mode == 'RGB'
assert img.getpixel((100, 100)) == (73, 73, 69)
img.save('test.jpg', 'JPEG')

Installation from source

System requirements:

Nightly Rust (https://www.rust-lang.org/)
libheif-dev >= 1.5 (https://github.com/strukturag/libheif)
python3-dev (tested with Python 3.6 and 3.7)

Ubuntu 18.04

$ sudo add-apt-repository ppa:strukturag/libheif
$ sudo apt-get install build-essential python3.7-dev libheif-dev curl
$ curl https://sh.rustup.rs -sSf | sh
$ source $HOME/.cargo/env
$ rustup toolchain install nightly
$ pip3 install -U setuptools setuptools-rust
$ PYTHON_SYS_EXECUTABLE=python3 pip3 install cykooz.heif

CHANGELOG

0.6 (2019-10-03)

Changes

Updated version of pyo3 to 0.8.
Updated version of libheif-rs to 0.8.

0.5 (2019-08-28)

Changes

Updated version of libheif-rs to 0.6.

0.4.2 (2019-07-17)

Bug Fixes

Added checking of image type inside of HeifImageFile._open().

0.4 (2019-07-17)

Features

Added RawHeifImage.check_file_type to check by first bytes of file what it file is supported by libheif.
Added opener plugin for Pillow.

0.3 (2019-06-28)

Features

Added method for creating HeifImage from any file-like object.

0.2 (2019-06-25)

Changes

Added exception HeifError.

0.1 (2019-06-25)

Initial version.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cykooz.heif-0.6.tar.gz (10.9 kB view details)

Uploaded Oct 3, 2019 Source

File details

Details for the file cykooz.heif-0.6.tar.gz.

File metadata

Download URL: cykooz.heif-0.6.tar.gz
Upload date: Oct 3, 2019
Size: 10.9 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.3

File hashes

Hashes for cykooz.heif-0.6.tar.gz
Algorithm	Hash digest
SHA256	`c04d60fd91b935fa70ec958858b510855ced443b50a8624dc638c709498c337c`
MD5	`b2aa59e2956e851c4bc2e38871323552`
BLAKE2b-256	`5f1aea2bd1c2dcd8dc63dcf9e096ff903e579d7a9554b4e2a74ccd38af09fb09`