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:

Ubuntu 18.04

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

CHANGELOG

0.8.3 (2020-08-30)

Bug Fixes

  • Fixed building of wheels:

    • added libaom;

    • added rav1e encoder for AV1;

    • added stripping of libraries to reduce size of wheels.

0.8 (2020-08-29)

Changes

  • Updated version of libheif-rs to 0.10:

    • updated version of libheif-sys to 1.8.1;

    • added support of new compression format AV1.

  • Updated version of pyo3 to 0.11.1.

0.7.2 (2020-03-20)

Changes

  • Updated version of pyo3 to 0.9.

Bug Fixes

  • Fixed namespace declaration.

0.7 (2020-03-01)

Changes

  • Updated version of libheif-rs to 0.9.

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.

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.0.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Cykooz from gravatar.com Cykooz

Credits

Author: Kirill Kuzminykh

License

MIT License

Tags

heif heic libheif pil pillow

Classifiers

Report project as malware

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.8.3.tar.gz (13.0 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

cykooz.heif-0.8.3-cp38-cp38-manylinux2014_x86_64.whl (5.8 MB view details)

Uploaded CPython 3.8

cykooz.heif-0.8.3-cp37-cp37m-manylinux2014_x86_64.whl (5.8 MB view details)

Uploaded CPython 3.7m

cykooz.heif-0.8.3-cp36-cp36m-manylinux2014_x86_64.whl (5.8 MB view details)

Uploaded CPython 3.6m

cykooz.heif-0.8.3-cp35-cp35m-manylinux2014_x86_64.whl (5.8 MB view details)

Uploaded CPython 3.5m

File details

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

File metadata

  • Download URL: cykooz.heif-0.8.3.tar.gz
  • Upload date:
  • Size: 13.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.6.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.2

File hashes

Hashes for cykooz.heif-0.8.3.tar.gz
Algorithm Hash digest
SHA256 f0ac345dbcef21e37a88d5d4754c6ab970de89d190b3f0aa1691c2e545cf3722
MD5 aeea90cd10a9322edb6e19e9ced1ecd1
BLAKE2b-256 0e50559cde5b155398635ad60e814f36021925f027a007db3988a9f312dfeb4c

See more details on using hashes here.

File details

Details for the file cykooz.heif-0.8.3-cp38-cp38-manylinux2014_x86_64.whl.

File metadata

  • Download URL: cykooz.heif-0.8.3-cp38-cp38-manylinux2014_x86_64.whl
  • Upload date:
  • Size: 5.8 MB
  • Tags: CPython 3.8
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.6.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.8.5

File hashes

Hashes for cykooz.heif-0.8.3-cp38-cp38-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 543c02ccd17f31b2b42d247034a41bc11aba364a0144473b315b87bcf54c4e34
MD5 3db071653313e9ac380d420807acc2fd
BLAKE2b-256 05a9d0afa0d65f74685a9fb143de944261f844ff7947b5f97c97b8a6b41ef6aa

See more details on using hashes here.

File details

Details for the file cykooz.heif-0.8.3-cp37-cp37m-manylinux2014_x86_64.whl.

File metadata

  • Download URL: cykooz.heif-0.8.3-cp37-cp37m-manylinux2014_x86_64.whl
  • Upload date:
  • Size: 5.8 MB
  • Tags: CPython 3.7m
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.6.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.9

File hashes

Hashes for cykooz.heif-0.8.3-cp37-cp37m-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 f7c7eb91d49f2719390f1793e246725b27c0981304cea5ec2bd8001573cc535a
MD5 fe4a3a0a3a0b013b4ab74d54c1f661b5
BLAKE2b-256 0bd90061885b5bd325375eb57e516fd9e9380324846d91221b14af927a7a5b1b

See more details on using hashes here.

File details

Details for the file cykooz.heif-0.8.3-cp36-cp36m-manylinux2014_x86_64.whl.

File metadata

  • Download URL: cykooz.heif-0.8.3-cp36-cp36m-manylinux2014_x86_64.whl
  • Upload date:
  • Size: 5.8 MB
  • Tags: CPython 3.6m
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.6.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.6.12

File hashes

Hashes for cykooz.heif-0.8.3-cp36-cp36m-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 6178adb305acad5c5946e6bec98035e69d8cb345fb3e5955c3b332002f9d3f48
MD5 b6fb4ccb38abd242ade3c8c78f4d6362
BLAKE2b-256 a504d40c606cba53b98b8a3651d415893b0d1416caa126153833501426c8251a

See more details on using hashes here.

File details

Details for the file cykooz.heif-0.8.3-cp35-cp35m-manylinux2014_x86_64.whl.

File metadata

  • Download URL: cykooz.heif-0.8.3-cp35-cp35m-manylinux2014_x86_64.whl
  • Upload date:
  • Size: 5.8 MB
  • Tags: CPython 3.5m
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.15.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/49.6.0 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.5.9

File hashes

Hashes for cykooz.heif-0.8.3-cp35-cp35m-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 e4288c463f249759ffdbaa0302d8f08adc3ee7c76efc68a4deb965f4b2b7c1b9
MD5 3dcca7f0d28cdae98981c08f0becc0f4
BLAKE2b-256 13868eccb7d20fe8b5db7d0f720c94cf7a97a2346f469462eb40d5addb9648c4

See more details on using hashes here.

Release history Release notifications | RSS feed

2.0.1

6 files

2.0.0

6 files

1.3.0

6 files

1.2.0

6 files

1.1.0

6 files

1.0.1

6 files

1.0.0

6 files

0.14.0

5 files

0.13.1

6 files

0.13

6 files

0.12

5 files

0.11

5 files

0.10.4

5 files

0.10.2

5 files

0.10

5 files

0.9

5 files

This release

0.8.3 This release

5 files

0.8

5 files

0.7.2

5 files

0.7

5 files

0.6

1 file

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page