pylibheif 1.21.2.post2__cp314-cp314-macosx_14_0_arm64.whl

lib/cmake/libheif/libheif-config-version.cmake

@@ -0,0 +1,83 @@
+# This is a basic version file for the Config-mode of find_package().
+# It is used by write_basic_package_version_file() as input file for configure_file()
+# to create a version-file which can be installed along a config.cmake file.
+#
+# The created file sets PACKAGE_VERSION_EXACT if the current version string and
+# the requested version string are exactly the same and it sets
+# PACKAGE_VERSION_COMPATIBLE if the current version is equal to the requested version.
+# The tweak version component is ignored.
+# The variable CVF_VERSION must be set before calling configure_file().
+
+
+if (PACKAGE_FIND_VERSION_RANGE)
+  message(AUTHOR_WARNING
+    "`find_package()` specify a version range but the version strategy "
+    "(ExactVersion) of the module `${PACKAGE_FIND_NAME}` is incompatible "
+    "with this request. Only the lower endpoint of the range will be used.")
+endif()
+
+set(PACKAGE_VERSION "1.21.2")
+
+if("1.21.2" MATCHES "^([0-9]+)\\.([0-9]+)\\.([0-9]+)") # strip the tweak version
+  set(CVF_VERSION_MAJOR "${CMAKE_MATCH_1}")
+  set(CVF_VERSION_MINOR "${CMAKE_MATCH_2}")
+  set(CVF_VERSION_PATCH "${CMAKE_MATCH_3}")
+
+  if(NOT CVF_VERSION_MAJOR VERSION_EQUAL 0)
+    string(REGEX REPLACE "^0+" "" CVF_VERSION_MAJOR "${CVF_VERSION_MAJOR}")
+  endif()
+  if(NOT CVF_VERSION_MINOR VERSION_EQUAL 0)
+    string(REGEX REPLACE "^0+" "" CVF_VERSION_MINOR "${CVF_VERSION_MINOR}")
+  endif()
+  if(NOT CVF_VERSION_PATCH VERSION_EQUAL 0)
+    string(REGEX REPLACE "^0+" "" CVF_VERSION_PATCH "${CVF_VERSION_PATCH}")
+  endif()
+
+  set(CVF_VERSION_NO_TWEAK "${CVF_VERSION_MAJOR}.${CVF_VERSION_MINOR}.${CVF_VERSION_PATCH}")
+else()
+  set(CVF_VERSION_NO_TWEAK "1.21.2")
+endif()
+
+if(PACKAGE_FIND_VERSION MATCHES "^([0-9]+)\\.([0-9]+)\\.([0-9]+)") # strip the tweak version
+  set(REQUESTED_VERSION_MAJOR "${CMAKE_MATCH_1}")
+  set(REQUESTED_VERSION_MINOR "${CMAKE_MATCH_2}")
+  set(REQUESTED_VERSION_PATCH "${CMAKE_MATCH_3}")
+
+  if(NOT REQUESTED_VERSION_MAJOR VERSION_EQUAL 0)
+    string(REGEX REPLACE "^0+" "" REQUESTED_VERSION_MAJOR "${REQUESTED_VERSION_MAJOR}")
+  endif()
+  if(NOT REQUESTED_VERSION_MINOR VERSION_EQUAL 0)
+    string(REGEX REPLACE "^0+" "" REQUESTED_VERSION_MINOR "${REQUESTED_VERSION_MINOR}")
+  endif()
+  if(NOT REQUESTED_VERSION_PATCH VERSION_EQUAL 0)
+    string(REGEX REPLACE "^0+" "" REQUESTED_VERSION_PATCH "${REQUESTED_VERSION_PATCH}")
+  endif()
+
+  set(REQUESTED_VERSION_NO_TWEAK
+      "${REQUESTED_VERSION_MAJOR}.${REQUESTED_VERSION_MINOR}.${REQUESTED_VERSION_PATCH}")
+else()
+  set(REQUESTED_VERSION_NO_TWEAK "${PACKAGE_FIND_VERSION}")
+endif()
+
+if(REQUESTED_VERSION_NO_TWEAK STREQUAL CVF_VERSION_NO_TWEAK)
+  set(PACKAGE_VERSION_COMPATIBLE TRUE)
+else()
+  set(PACKAGE_VERSION_COMPATIBLE FALSE)
+endif()
+
+if(PACKAGE_FIND_VERSION STREQUAL PACKAGE_VERSION)
+  set(PACKAGE_VERSION_EXACT TRUE)
+endif()
+
+
+# if the installed or the using project don't have CMAKE_SIZEOF_VOID_P set, ignore it:
+if("${CMAKE_SIZEOF_VOID_P}" STREQUAL "" OR "8" STREQUAL "")
+  return()
+endif()
+
+# check that the installed version has the same 32/64bit-ness as the one which is currently searching:
+if(NOT CMAKE_SIZEOF_VOID_P STREQUAL "8")
+  math(EXPR installedBits "8 * 8")
+  set(PACKAGE_VERSION "${PACKAGE_VERSION} (${installedBits}bit)")
+  set(PACKAGE_VERSION_UNSUITABLE TRUE)
+endif()

lib/cmake/libheif/libheif-config.cmake

@@ -0,0 +1,108 @@
+# Generated by CMake
+
+if("${CMAKE_MAJOR_VERSION}.${CMAKE_MINOR_VERSION}" LESS 2.8)
+   message(FATAL_ERROR "CMake >= 2.8.12 required")
+endif()
+if(CMAKE_VERSION VERSION_LESS "2.8.12")
+   message(FATAL_ERROR "CMake >= 2.8.12 required")
+endif()
+cmake_policy(PUSH)
+cmake_policy(VERSION 2.8.12...4.0)
+#----------------------------------------------------------------
+# Generated CMake target import file.
+#----------------------------------------------------------------
+
+# Commands may need to know the format version.
+set(CMAKE_IMPORT_FILE_VERSION 1)
+
+# Protect against multiple inclusion, which would fail when already imported targets are added once more.
+set(_cmake_targets_defined "")
+set(_cmake_targets_not_defined "")
+set(_cmake_expected_targets "")
+foreach(_cmake_expected_target IN ITEMS heif)
+  list(APPEND _cmake_expected_targets "${_cmake_expected_target}")
+  if(TARGET "${_cmake_expected_target}")
+    list(APPEND _cmake_targets_defined "${_cmake_expected_target}")
+  else()
+    list(APPEND _cmake_targets_not_defined "${_cmake_expected_target}")
+  endif()
+endforeach()
+unset(_cmake_expected_target)
+if(_cmake_targets_defined STREQUAL _cmake_expected_targets)
+  unset(_cmake_targets_defined)
+  unset(_cmake_targets_not_defined)
+  unset(_cmake_expected_targets)
+  unset(CMAKE_IMPORT_FILE_VERSION)
+  cmake_policy(POP)
+  return()
+endif()
+if(NOT _cmake_targets_defined STREQUAL "")
+  string(REPLACE ";" ", " _cmake_targets_defined_text "${_cmake_targets_defined}")
+  string(REPLACE ";" ", " _cmake_targets_not_defined_text "${_cmake_targets_not_defined}")
+  message(FATAL_ERROR "Some (but not all) targets in this export set were already defined.\nTargets Defined: ${_cmake_targets_defined_text}\nTargets not yet defined: ${_cmake_targets_not_defined_text}\n")
+endif()
+unset(_cmake_targets_defined)
+unset(_cmake_targets_not_defined)
+unset(_cmake_expected_targets)
+
+
+# Compute the installation prefix relative to this file.
+get_filename_component(_IMPORT_PREFIX "${CMAKE_CURRENT_LIST_FILE}" PATH)
+get_filename_component(_IMPORT_PREFIX "${_IMPORT_PREFIX}" PATH)
+get_filename_component(_IMPORT_PREFIX "${_IMPORT_PREFIX}" PATH)
+get_filename_component(_IMPORT_PREFIX "${_IMPORT_PREFIX}" PATH)
+if(_IMPORT_PREFIX STREQUAL "/")
+  set(_IMPORT_PREFIX "")
+endif()
+
+# Create imported target heif
+add_library(heif STATIC IMPORTED)
+
+set_target_properties(heif PROPERTIES
+  INTERFACE_COMPILE_DEFINITIONS "LIBHEIF_EXPORTS;HAVE_VISIBILITY"
+  INTERFACE_INCLUDE_DIRECTORIES "${_IMPORT_PREFIX}/include"
+  INTERFACE_LINK_LIBRARIES "/opt/homebrew/Cellar/x265/4.1/lib/libx265.dylib;/opt/homebrew/Cellar/libde265/1.0.16/lib/libde265.dylib;/opt/homebrew/Cellar/dav1d/1.5.3/lib/libdav1d.dylib;\$<LINK_ONLY:AOM::aom>;\$<LINK_ONLY:AOM::aom>;/opt/homebrew/lib/libjpeg.dylib;/opt/homebrew/lib/libjpeg.dylib;\$<LINK_ONLY:openjp2>;\$<LINK_ONLY:openjp2>;/opt/homebrew/Cellar/x264/r3222/lib/libx264.dylib;/opt/homebrew/Cellar/openh264/2.6.0/lib/libopenh264.dylib"
+)
+
+# Load information for each installed configuration.
+file(GLOB _cmake_config_files "${CMAKE_CURRENT_LIST_DIR}/libheif-config-*.cmake")
+foreach(_cmake_config_file IN LISTS _cmake_config_files)
+  include("${_cmake_config_file}")
+endforeach()
+unset(_cmake_config_file)
+unset(_cmake_config_files)
+
+# Cleanup temporary variables.
+set(_IMPORT_PREFIX)
+
+# Loop over all imported files and verify that they actually exist
+foreach(_cmake_target IN LISTS _cmake_import_check_targets)
+  if(CMAKE_VERSION VERSION_LESS "3.28"
+      OR NOT DEFINED _cmake_import_check_xcframework_for_${_cmake_target}
+      OR NOT IS_DIRECTORY "${_cmake_import_check_xcframework_for_${_cmake_target}}")
+    foreach(_cmake_file IN LISTS "_cmake_import_check_files_for_${_cmake_target}")
+      if(NOT EXISTS "${_cmake_file}")
+        message(FATAL_ERROR "The imported target \"${_cmake_target}\" references the file
+   \"${_cmake_file}\"
+but this file does not exist.  Possible reasons include:
+* The file was deleted, renamed, or moved to another location.
+* An install or uninstall procedure did not complete successfully.
+* The installation package was faulty and contained
+   \"${CMAKE_CURRENT_LIST_FILE}\"
+but not all the files it references.
+")
+      endif()
+    endforeach()
+  endif()
+  unset(_cmake_file)
+  unset("_cmake_import_check_files_for_${_cmake_target}")
+endforeach()
+unset(_cmake_target)
+unset(_cmake_import_check_targets)
+
+# This file does not depend on other imported targets which have
+# been exported from the same project but in a separate export set.
+
+# Commands beyond this point should not need to know the version.
+set(CMAKE_IMPORT_FILE_VERSION)
+cmake_policy(POP)

lib/pkgconfig/libheif.pc

@@ -0,0 +1,15 @@
+prefix=/var/folders/xx/pgt1mtfn3xx3hdys7czt35bh0000gn/T/tmpljmyse36/wheel/platlib
+exec_prefix=${prefix}
+libdir=${exec_prefix}/lib
+includedir=${prefix}/include
+
+Name: libheif
+Description: HEIF image codec.
+URL: https://github.com/strukturag/libheif
+Version: 1.21.2
+Requires:
+Requires.private: libde265 x265 openh264 x264 aom dav1d libjpeg libopenjp2
+Libs: -L${libdir} -lheif
+Libs.private: -lc++
+Cflags: -I${includedir}
+Cflags.private: -DLIBHEIF_STATIC_BUILD

pylibheif-1.21.2.post2.dist-info/METADATA

@@ -0,0 +1,405 @@
+Metadata-Version: 2.2
+Name: pylibheif
+Version: 1.21.2.post2
+Summary: Python bindings for libheif - HEIC/AVIF/JPEG2000 image codec
+Keywords: heif,heic,avif,jpeg2000,image,codec,libheif
+Author-Email: Curry Tang <twn39@163.com>
+License: LGPL-3.0-or-later
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: C++
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
+Project-URL: Homepage, https://github.com/twn39/pylibheif
+Project-URL: Repository, https://github.com/twn39/pylibheif
+Project-URL: Documentation, https://github.com/twn39/pylibheif#readme
+Project-URL: Issues, https://github.com/twn39/pylibheif/issues
+Requires-Python: >=3.11
+Requires-Dist: numpy>=1.26.0
+Description-Content-Type: text/markdown
+
+# pylibheif
+
+Python bindings for [libheif](https://github.com/strukturag/libheif) using pybind11.
+
+## Features
+
+- **HEIC/HEIF Support**: Read and write HEIC images (HEVC/H.265 encoded)
+- **AVIF Support**: Read and write AVIF images (AV1 encoded)
+- **JPEG2000 Support**: Read and write JPEG2000 images in HEIF container
+- **NumPy Integration**: Zero-copy access to image data via Python Buffer Protocol
+- **Metadata Support**: Read EXIF and XMP metadata from images
+- **RAII Resource Management**: Automatic resource cleanup with context managers
+
+## Supported Formats
+
+| Format | Decoding | Encoding | Codec |
+|--------|----------|----------|-------|
+| HEIC (HEVC/H.265) | ✅ | ✅ | libde265 / x265 |
+| AVIF (AV1) | ✅ | ✅ | DAV1D + AOM |
+| JPEG2000 | ✅ | ✅ | OpenJPEG |
+
+## Requirements
+
+- Python >= 3.12
+- NumPy >= 1.26.0
+- CMake >= 3.15
+- C++17 compatible compiler
+
+### System Dependencies
+
+```bash
+# macOS
+brew install openjpeg
+
+# Ubuntu/Debian
+sudo apt install libopenjp2-7-dev
+```
+
+## Installation
+
+```bash
+pip install pylibheif
+```
+
+Or with uv:
+```bash
+uv pip install pylibheif
+```
+
+### Building from Source
+
+```bash
+# Clone with submodules
+git clone --recursive https://github.com/twn39/pylibheif.git
+cd pylibheif
+
+# Install
+uv pip install -e .
+```
+
+## Usage
+
+### Reading HEIC/AVIF Images
+
+**Using context manager (recommended):**
+
+```python
+import pylibheif
+import numpy as np
+
+# Open HEIC file with context manager
+with pylibheif.HeifContext() as ctx:
+    ctx.read_from_file('image.heic')
+    
+    # Get primary image handle
+    handle = ctx.get_primary_image_handle()
+    print(f'Image size: {handle.width}x{handle.height}')
+    print(f'Has alpha: {handle.has_alpha}')
+    
+    # Decode to RGB
+    img = handle.decode(pylibheif.HeifColorspace.RGB, 
+                        pylibheif.HeifChroma.InterleavedRGB)
+    
+    # Get as NumPy array (zero-copy)
+    plane = img.get_plane(pylibheif.HeifChannel.Interleaved, False)
+    arr = np.asarray(plane)  # shape: (height, width, 3)
+```
+
+**Explicit creation (for more control):**
+
+```python
+import pylibheif
+import numpy as np
+
+# Create context explicitly
+ctx = pylibheif.HeifContext()
+ctx.read_from_file('image.heic')
+
+handle = ctx.get_primary_image_handle()
+img = handle.decode(pylibheif.HeifColorspace.RGB, 
+                    pylibheif.HeifChroma.InterleavedRGB)
+plane = img.get_plane(pylibheif.HeifChannel.Interleaved, False)
+arr = np.asarray(plane)
+
+# Resources are automatically freed when objects go out of scope
+```
+
+### Writing HEIC/AVIF Images
+
+```python
+import pylibheif
+import numpy as np
+
+# Create image from NumPy array
+width, height = 1920, 1080
+img = pylibheif.HeifImage(width, height, 
+                          pylibheif.HeifColorspace.RGB,
+                          pylibheif.HeifChroma.InterleavedRGB)
+img.add_plane(pylibheif.HeifChannel.Interleaved, width, height, 8)
+
+# Fill with data
+plane = img.get_plane(pylibheif.HeifChannel.Interleaved, True)
+arr = np.asarray(plane)
+arr[:] = your_image_data  # your RGB data
+
+# Encode and save
+ctx = pylibheif.HeifContext()
+
+# For HEIC (HEVC)
+encoder = pylibheif.HeifEncoder(pylibheif.HeifCompressionFormat.HEVC)
+# For AVIF (AV1)
+# encoder = pylibheif.HeifEncoder(pylibheif.HeifCompressionFormat.AV1)
+# For JPEG2000
+# encoder = pylibheif.HeifEncoder(pylibheif.HeifCompressionFormat.JPEG2000)
+
+encoder.set_lossy_quality(85)
+encoder.encode_image(ctx, img)
+ctx.write_to_file('output.heic')
+```
+
+### Converting HEIC to JPEG
+
+```python
+import pylibheif
+import numpy as np
+from PIL import Image
+
+# Decode HEIC
+ctx = pylibheif.HeifContext()
+ctx.read_from_file('input.heic')
+handle = ctx.get_primary_image_handle()
+img = handle.decode(pylibheif.HeifColorspace.RGB, 
+                    pylibheif.HeifChroma.InterleavedRGB)
+
+# Get NumPy array
+plane = img.get_plane(pylibheif.HeifChannel.Interleaved, False)
+arr = np.asarray(plane)
+
+# Save as JPEG using PIL
+pil_img = Image.fromarray(arr)
+pil_img.save('output.jpg', 'JPEG', quality=85)
+```
+
+### Reading Metadata
+
+```python
+import pylibheif
+
+ctx = pylibheif.HeifContext()
+ctx.read_from_file('image.heic')
+handle = ctx.get_primary_image_handle()
+
+# Get metadata block IDs
+exif_ids = handle.get_metadata_block_ids('Exif')
+for id in exif_ids:
+    metadata_type = handle.get_metadata_block_type(id)
+    metadata_bytes = handle.get_metadata_block(id)
+    print(f'Metadata type: {metadata_type}, size: {len(metadata_bytes)}')
+```
+
+## API Reference
+
+### class `pylibheif.HeifContext`
+
+Manages the valid lifetime of libheif context. It is the main entry point (root object) for high-level API.
+
+#### Methods
+
+**`__init__()`**
+Creates a new empty context.
+
+**`read_from_file(filename: str) -> None`**
+Reads a HEIF file from the given filename.
+- `filename`: Path to the HEIF file.
+
+**`read_from_memory(data: bytes) -> None`**
+Reads a HEIF file from a bytes object.
+- `data`: Bytes containing the file content.
+
+**`write_to_file(filename: str) -> None`**
+Writes the current context to a file.
+- `filename`: Destination path.
+
+**`write_to_bytes() -> bytes`**
+Writes the current context to a bytes object.
+- Returns: `bytes` object containing the encoded file data.
+
+**`get_primary_image_handle() -> HeifImageHandle`**
+Gets the handle for the primary image in the file.
+- Returns: `HeifImageHandle` for the primary image.
+
+**`get_image_handle(id: int) -> HeifImageHandle`**
+Gets the handle for a specific image ID.
+- `id`: The ID of the image (see `get_list_of_top_level_image_IDs`).
+- Returns: `HeifImageHandle`.
+
+**`get_list_of_top_level_image_IDs() -> List[int]`**
+Gets a list of IDs of all top-level images in the file.
+- Returns: List of integer IDs.
+
+---
+
+### class `pylibheif.HeifImageHandle`
+
+Represents a compressed image within the HEIF file.
+
+#### Properties
+
+- **`width`** *(int)*: The width of the image.
+- **`height`** *(int)*: The height of the image.
+- **`has_alpha`** *(bool)*: True if the image has an alpha channel.
+
+#### Methods
+
+**`decode(colorspace: HeifColorspace = HeifColorspace.RGB, chroma: HeifChroma = HeifChroma.InterleavedRGB) -> HeifImage`**
+Decodes the image handle into an uncompressed `HeifImage`.
+- `colorspace`: Target colorspace (default: RGB).
+- `chroma`: Target chroma format (default: InterleavedRGB).
+- Returns: Decoded `HeifImage`.
+
+**`get_metadata_block_ids(type_filter: str = "") -> List[str]`**
+Gets a list of metadata block IDs attached to this image.
+- `type_filter`: Optional filter string (e.g. "Exif", "XMP").
+- Returns: List of metadata ID strings.
+
+**`get_metadata_block_type(id: str) -> str`**
+Gets the type string of a specific metadata block.
+- `id`: Metadata ID.
+- Returns: Type string (e.g. "Exif").
+
+**`get_metadata_block(id: str) -> bytes`**
+Gets the raw data of a metadata block.
+- `id`: Metadata ID.
+- Returns: `bytes` object containing the metadata.
+
+---
+
+### class `pylibheif.HeifImage`
+
+Represents an uncompressed image containing pixel data. Supports the Python Buffer Protocol for zero-copy access with NumPy.
+
+#### Properties
+
+- **`width`** *(int)*: The width of the image.
+- **`height`** *(int)*: The height of the image.
+
+#### Methods
+
+**`__init__(width: int, height: int, colorspace: HeifColorspace, chroma: HeifChroma)`**
+Creates a new empty image.
+- `width`: Image width.
+- `height`: Image height.
+- `colorspace`: Image colorspace.
+- `chroma`: Image chroma format.
+
+**`add_plane(channel: HeifChannel, width: int, height: int, bit_depth: int) -> None`**
+Adds a new plane to the image.
+- `channel`: The channel type (e.g. `HeifChannel.Interleaved`).
+- `width`: Width of the plane.
+- `height`: Height of the plane.
+- `bit_depth`: Bit depth (e.g. 8).
+
+**`get_plane(channel: HeifChannel, writeable: bool = False) -> HeifPlane`**
+Gets a plane object that supports the buffer protocol.
+- `channel`: The channel to retrieve.
+- `writeable`: Whether the buffer should be writable.
+- Returns: `HeifPlane` object (wrappable with `np.asarray()`).
+
+---
+
+### class `pylibheif.HeifEncoder`
+
+Controls the encoding process.
+
+#### Methods
+
+**`__init__(format: HeifCompressionFormat)`**
+Creates a new encoder for the specified format.
+- `format`: Compression format (e.g. `HeifCompressionFormat.HEVC`).
+
+**`set_lossy_quality(quality: int) -> None`**
+Sets the quality for lossy compression.
+- `quality`: Integer between 0 (lowest) and 100 (highest).
+
+**`set_parameter(name: str, value: str) -> None`**
+Sets a low-level encoder parameter.
+- `name`: Parameter name (e.g. "speed" for AV1).
+- `value`: Parameter value.
+
+**`encode_image(context: HeifContext, image: HeifImage) -> None`**
+Encodes the given image and appends it to the context.
+- `context`: The destination `HeifContext`.
+- `image`: The source `HeifImage` to encode.
+
+---
+
+### Enums
+
+#### `pylibheif.HeifColorspace`
+- `RGB`, `YCbCr`, `Monochrome`, `Undefined`
+
+#### `pylibheif.HeifChroma`
+- `InterleavedRGB`: Interleaved R, G, B bytes.
+- `InterleavedRGBA`: Interleaved R, G, B, A bytes.
+- `C420`: YUV 4:2:0 planar.
+- `C422`: YUV 4:2:2 planar.
+- `C444`: YUV 4:4:4 planar.
+- `Monochrome`.
+
+#### `pylibheif.HeifChannel`
+- `Interleaved`: For interleaved RGB/RGBA.
+- `Y`, `Cb`, `Cr`: For YUV planar.
+- `R`, `G`, `B`: For RGB planar.
+- `Alpha`: For Alpha channel.
+
+#### `pylibheif.HeifCompressionFormat`
+- `HEVC`: H.265 (libx265).
+- `AV1`: AV1 (AOM/RAV1E/SVT).
+- `JPEG`: JPEG.
+- `JPEG2000`: JPEG 2000 (OpenJPEG).
+
+## Building from Source
+
+```bash
+# Clone with submodules
+git clone --recursive https://github.com/your-username/pylibheif.git
+cd pylibheif
+
+# Build
+uv pip install -e .
+```
+
+## Performance
+
+Benchmarks on 1920x1080 RGB image (Apple Silicon):
+
+| Operation | pylibheif | pillow-heif | Note |
+|:---|:---:|:---:|:---|
+| HEVC Decode | 25 ms | 25 ms | ~39 FPS |
+| HEVC Encode | 279 ms | 272 ms | Quality 80 |
+| AV1 Encode | 91 ms | - | Speed 50 |
+
+`pylibheif` offers performance comparable to `pillow-heif` (both wrapper libheif), but exposes a lower-level C++ API for fine-grained control.
+
+Run benchmarks yourself:
+```bash
+uv pip install pillow-heif pytest-benchmark
+uv run pytest tests/test_benchmark.py --benchmark-only
+```
+
+## License
+
+This project is licensed under the LGPL-3.0 License - see the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+- [libheif](https://github.com/strukturag/libheif) - HEIF/AVIF codec library
+- [pybind11](https://github.com/pybind/pybind11) - C++/Python bindings

pylibheif-1.21.2.post2.dist-info/RECORD

@@ -0,0 +1,44 @@
+pylibheif.cpython-314-darwin.so,sha256=Kw1zQmJFUwX2PGSHrg2eC11_C2Rpoe7MdbJTepGZjmI,1465232
+include/libheif/heif_error.h,sha256=buuv0fMvYb1NU_r7rPeHkcFMYIOzG-DH-7mOQI-xl2M,8765
+include/libheif/heif_plugin.h,sha256=phh6v7n8qs9XpZhR7tx1U1qSD2HkaBD9ZsX2dZ8OluI,13118
+include/libheif/heif.h,sha256=lttx6Y--O6YMPgA442G3CyDbCrjHoQ76rHgJMkCSnDI,1351
+include/libheif/heif_entity_groups.h,sha256=x4U5pwoD1BmdNYRkzqPD5Yr6A-82hgC9o9w2DG-Ie_A,1895
+include/libheif/heif_text.h,sha256=4_gegjTlEhG8YsLuyikP76xhk4VLUKWNn3q4jeKbSyg,5502
+include/libheif/heif_tiling.h,sha256=kLI4NA3u_uFdN_s-GKYS200yu5w7dp45qnl2f1f3jMg,5453
+include/libheif/heif_color.h,sha256=F0kvmt5GOkgJP5iHPeuGJUCCETJtd0O0GS8R-1VZgFQ,14427
+include/libheif/heif_cxx.h,sha256=tdB9fHtbxuVb2KILP2LUJ-w5c013X0kZLVnnVB4IMnE,41357
+include/libheif/heif_metadata.h,sha256=fse7pHVkgYzjBY36cY4P4qtCeWB73Rca-7j87L5xrVo,6225
+include/libheif/heif_version.h,sha256=R_2fiedGQk0x-PNuG1W5hpDrMU2QUxksRcZNbXY6m0Q,1275
+include/libheif/heif_brands.h,sha256=JeOWoR7YAG3akn_NsrDelL4uAMRSHbsaQzaDLHfMHUk,10586
+include/libheif/heif_encoding.h,sha256=Eqz-RkGubU34WBvFA0J5JgbnJ8RhWnBKdgrtywko1Uw,16574
+include/libheif/heif_library.h,sha256=xu0O9sYUz5D70eARJLuJ5wj_PcJFq1-Mpw6AHsvHF6M,7943
+include/libheif/heif_regions.h,sha256=qUiOn9Q8tidWjNFWRQB3j2gVwtz_NMScaKiBiYM8mYQ,38812
+include/libheif/heif_security.h,sha256=BfyBApRa2ly_fNeuTd9B4k9579ZLNigDWH2YXG2_-N4,3316
+include/libheif/heif_tai_timestamps.h,sha256=1FDjZmwkJXMsKYcBKoRcWKuESEWUKaC5UWlKDicWeH0,7798
+include/libheif/heif_items.h,sha256=zDci6_hSvJ0BTPiOEIJ9XGfMq73LgzvvjuGVPbHA8m4,9849
+include/libheif/heif_aux_images.h,sha256=ZWIRPKs07k9-HOaKt6AQYrgAAPNdt-ji-_EHILxasr4,7258
+include/libheif/heif_sequences.h,sha256=_H6zhko2pELq-DfVMO8BVk1VyDNzCBiw0SutYs4RhA4,22789
+include/libheif/heif_decoding.h,sha256=lfIrX1wb-eYkf5zkBB2mWNlhWpPLTrOFL7ieV5zNlZw,6332
+include/libheif/heif_properties.h,sha256=ZFN9A_9Jnq6_fICy7Ew_10oZAAyiOxN38i9yO-6QIyM,10721
+include/libheif/heif_image.h,sha256=X888K_zjlJutbnmNX5lglU-vi8prFgdiKIQPL8QAKQQ,13681
+include/libheif/heif_image_handle.h,sha256=7iFydgGAdY6WzAGECrSXHMpuIhnYvHGzyppgNIF3c-c,5134
+include/libheif/heif_uncompressed.h,sha256=TQKIEDnly7GjolFdoI492vhma28V96Gex5FWsKZ2zGk,3868
+include/libheif/heif_context.h,sha256=FfIGQVcB1-M1e8Bde8FTVQbcM0UxSAO5vYoew0v_3-Y,13014
+pylibheif.dylibs/libvmaf.3.dylib,sha256=lcTjGz9G1hkeuh-Ev0VOEOzXstTUOzjdLjAr9ClgcW0,748064
+pylibheif.dylibs/libdav1d.7.dylib,sha256=tjhJqwA_EqyChtFvKLRuYvdvyVNc2XGaUFPiqUbUJaw,798624
+pylibheif.dylibs/libx264.165.dylib,sha256=7c9nVoZBWDmPYhmbpPRf1rX1X9WsWio5lYK1aNdKf9s,1298192
+pylibheif.dylibs/libopenjp2.2.5.4.dylib,sha256=H5iNXa_UvIHu8ttzJYCEgo3BX6QHoBtK7uAqerKZjhU,325968
+pylibheif.dylibs/libde265.0.dylib,sha256=mw2Bp02q-Rmf0lOr0Gdihj2j-UuWD6ndUhDQRIef9d0,422608
+pylibheif.dylibs/libx265.215.dylib,sha256=0HBo8OEcH0SKUdOpcON3korZdB1ncqiyb6Rkiu1CQBY,4923728
+pylibheif.dylibs/libjpeg.8.3.2.dylib,sha256=RMLYdlLWUEf_YBlB5yY9En2gLESSjcS8KnopOXTLxKk,473200
+pylibheif.dylibs/libaom.3.13.1.dylib,sha256=-slvol0iSmqGkxMbc0-sca04zA6UlGjhHkHY9N6_Z0Y,3924256
+pylibheif.dylibs/libopenh264.2.6.0.dylib,sha256=sJHxJ7Vvwa7KrRUGlnxLZg0OsiwZEIf7X8cmZysvZ1o,964688
+lib/libheif.a,sha256=POnFyN4K3eKQdvQ4367RwrSfoVIh_eW_KvyjjpBzBJY,3818520
+lib/pkgconfig/libheif.pc,sha256=2RIo4ggnnFYo5wbwb_PV98D13zP_FUXqd5yCj6-mTrE,457
+lib/cmake/libheif/libheif-config.cmake,sha256=oGWkMDTOt-ctBuVjnkx5esCLHVd38tBC3GyFngQ4Ex4,4593
+lib/cmake/libheif/libheif-config-release.cmake,sha256=NmefsNyqv-yyAObfvRLShZEKExbE98P2Cd28eroyejw,789
+lib/cmake/libheif/libheif-config-version.cmake,sha256=r0Rw3uKsVEzNcMMg60edTBAr9df_-NWIXMYIdIy51Og,3252
+pylibheif-1.21.2.post2.dist-info/RECORD,,
+pylibheif-1.21.2.post2.dist-info/WHEEL,sha256=DQQNi05f3Gr0rtExT3J4XDWeFIC7xBSHbQO7D5gfL1U,141
+pylibheif-1.21.2.post2.dist-info/METADATA,sha256=6LMVtZRo2C641xDBIvzDZpXb7wsMVv6B6JQ6dqLLnjI,11503
+pylibheif-1.21.2.post2.dist-info/licenses/LICENSE,sha256=fDdTdPxIYzjisSIHtLHWfwdQjCB1YbnGO14a-rg3M7s,7636

pylibheif-1.21.2.post2.dist-info/WHEEL

@@ -0,0 +1,6 @@
+Wheel-Version: 1.0
+Generator: scikit-build-core 0.11.6
+Root-Is-Purelib: false
+Tag: cp314-cp314-macosx_14_0_arm64
+Generator: delocate 0.13.0
+