145 lines
6.4 KiB
Plaintext
145 lines
6.4 KiB
Plaintext
Metadata-Version: 2.4
|
|
Name: pi_heif
|
|
Version: 1.1.1
|
|
Summary: Python interface for libheif library
|
|
Home-page: https://github.com/bigcat88/pillow_heif
|
|
Author: Alexander Piskun
|
|
Author-email: bigcat88@users.noreply.github.com
|
|
License: BSD-3-Clause
|
|
Project-URL: Documentation, https://pillow-heif.readthedocs.io
|
|
Project-URL: Source, https://github.com/bigcat88/pillow_heif
|
|
Project-URL: Changelog, https://github.com/bigcat88/pillow_heif/blob/master/CHANGELOG.md
|
|
Keywords: heic,heif,pillow
|
|
Classifier: Development Status :: 5 - Production/Stable
|
|
Classifier: Intended Audience :: Developers
|
|
Classifier: Topic :: Software Development
|
|
Classifier: Topic :: Software Development :: Libraries
|
|
Classifier: Topic :: Multimedia :: Graphics
|
|
Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
|
|
Classifier: Programming Language :: Python :: 3
|
|
Classifier: Programming Language :: Python :: 3.9
|
|
Classifier: Programming Language :: Python :: 3.10
|
|
Classifier: Programming Language :: Python :: 3.11
|
|
Classifier: Programming Language :: Python :: 3.12
|
|
Classifier: Programming Language :: Python :: 3.13
|
|
Classifier: Programming Language :: Python :: Implementation :: CPython
|
|
Classifier: Programming Language :: Python :: Implementation :: PyPy
|
|
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
|
|
Classifier: Operating System :: MacOS :: MacOS X
|
|
Classifier: Operating System :: POSIX :: Linux
|
|
Classifier: Operating System :: Microsoft :: Windows
|
|
Requires-Python: >=3.9
|
|
Description-Content-Type: text/markdown
|
|
License-File: LICENSE.txt
|
|
License-File: LICENSES_bundled.txt
|
|
Requires-Dist: pillow>=11.1.0
|
|
Provides-Extra: tests-min
|
|
Requires-Dist: pytest; extra == "tests-min"
|
|
Requires-Dist: defusedxml; extra == "tests-min"
|
|
Requires-Dist: packaging; extra == "tests-min"
|
|
Provides-Extra: tests
|
|
Requires-Dist: pytest; extra == "tests"
|
|
Requires-Dist: defusedxml; extra == "tests"
|
|
Requires-Dist: packaging; extra == "tests"
|
|
Requires-Dist: numpy; extra == "tests"
|
|
Requires-Dist: pympler; extra == "tests"
|
|
Dynamic: license-file
|
|
|
|
# pi-heif
|
|
|
|
[](https://github.com/bigcat88/pillow_heif/actions/workflows/analysis-coverage.yml)
|
|
[](https://github.com/bigcat88/pillow_heif/actions/workflows/test-wheels-pi_heif.yml)
|
|
|
|
|
|
|
|
|
|
[](https://pepy.tech/project/pi-heif)
|
|
[](https://pepy.tech/project/pi-heif)
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
This is a light version of [Pillow-Heif](https://github.com/bigcat88/pillow_heif) with more permissive license for binary wheels.
|
|
|
|
It includes only `HEIF` decoder and does not support `save` operations.
|
|
|
|
All codebase are the same, refer to [pillow-heif docs](https://pillow-heif.readthedocs.io/).
|
|
|
|
The only difference is the name of the imported project.
|
|
|
|
### Install
|
|
```console
|
|
python3 -m pip install -U pip
|
|
python3 -m pip install pi-heif
|
|
```
|
|
|
|
### Example of use as a Pillow plugin
|
|
```python3
|
|
from PIL import Image
|
|
from pi_heif import register_heif_opener
|
|
|
|
register_heif_opener()
|
|
|
|
im = Image.open("images/input.heic") # do whatever need with a Pillow image
|
|
im.show()
|
|
```
|
|
|
|
### 8/10/12 bit HEIF to 8/16 bit PNG using OpenCV
|
|
```python3
|
|
import numpy as np
|
|
import cv2
|
|
import pi_heif
|
|
|
|
heif_file = pi_heif.open_heif("image.heic", convert_hdr_to_8bit=False, bgr_mode=True)
|
|
np_array = np.asarray(heif_file)
|
|
cv2.imwrite("image.png", np_array)
|
|
```
|
|
|
|
### Get decoded image data as a Numpy array
|
|
```python3
|
|
import numpy as np
|
|
import pi_heif
|
|
|
|
if pi_heif.is_supported("input.heic"):
|
|
heif_file = pi_heif.open_heif("input.heic")
|
|
np_array = np.asarray(heif_file)
|
|
```
|
|
|
|
### Accessing Depth Images
|
|
|
|
```python3
|
|
from PIL import Image
|
|
from pillow_heif import register_heif_opener
|
|
import numpy as np
|
|
|
|
register_heif_opener()
|
|
|
|
im = Image.open("../tests/images/heif_other/pug.heic")
|
|
if im.info["depth_images"]:
|
|
depth_im = im.info["depth_images"][0] # Access the first depth image (usually there will be only one).
|
|
# Depth images are instances of `class HeifDepthImage(BaseImage)`,
|
|
# so work with them as you would with any usual image in pillow_heif.
|
|
# Depending on what you need the depth image for, you can convert it to a NumPy array or convert it to a Pillow image.
|
|
pil_im = depth_im.to_pillow()
|
|
np_im = np.asarray(depth_im)
|
|
print(pil_im)
|
|
print(pil_im.info["metadata"])
|
|
```
|
|
|
|
### Wheels
|
|
|
|
| **_Wheels table_** | macOS<br/>Intel | macOS<br/>Silicon | Windows<br/> | musllinux* | manylinux* |
|
|
|--------------------|:---------------:|:-----------------:|:------------:|:----------:|:----------:|
|
|
| CPython 3.9 | ✅ | ✅ | ✅ | ✅ | ✅ |
|
|
| CPython 3.10 | ✅ | ✅ | ✅ | ✅ | ✅ |
|
|
| CPython 3.11 | ✅ | ✅ | ✅ | ✅ | ✅ |
|
|
| CPython 3.12 | ✅ | ✅ | ✅ | ✅ | ✅ |
|
|
| CPython 3.13 | ✅ | ✅ | ✅ | ✅ | ✅ |
|
|
| PyPy 3.10 v7.3 | ✅ | ✅ | ✅ | N/A | ✅ |
|
|
| PyPy 3.11 v7.3 | ✅ | ✅ | ✅ | N/A | ✅ |
|
|
|
|
* **x86_64**, **aarch64** wheels.
|