bigcat88/pillow_heif

해결하는 문제

HEIF/HEIC는 JPEG보다 효율적으로 사진을 저장하는 최신 이미지 형식이지만, Python의 인기 있는 Pillow 이미징 라이브러리에서는 기본적으로 지원되지 않습니다. 이 프로젝트는 이러한 부족한 지원을 추가하여 Python 개발자가 Pillow의 친숙한 API를 통해 HEIF 이미지를 직접 읽고 쓸 수 있게 합니다.

작동 방식

libheif(HEIF/HEIC 이미지용 C 라이브러리)에 대한 Python 바인딩이며 Pillow 플러그인으로 등록됩니다. register_heif_opener()를 호출하면 모든 Pillow 열기/저장 작업이 .heic 파일에서 작동합니다. 8비트, 10비트, 12비트 이미지를 디코딩 및 인코딩할 수 있고, 메타데이터(EXIF, XMP, IPTC)를 처리하며, 파일당 여러 이미지, 썸네일, 타일(그리드) 인코딩, 깊이 이미지를 지원합니다. 또한 원시 디코딩 데이터에 직접 접근하고 NumPy 배열로 변환할 수 있습니다.

대상 사용자

HEIF 이미지를 다루는 Python 개발자, 특히 최신 기기(예: iPhone)의 사진을 자동화된 워크플로우, 웹 앱 또는 이미지 처리 파이프라인에서 처리해야 하는 사람들을 위한 것입니다. 또한 Pillow를 사용하여 HEIF와 다른 형식 간에 변환하려는 모든 사람에게 유용합니다.

주요 기능

• 채널당 8비트, 10비트, 12비트로 HEIC 파일을 디코딩 및 인코딩합니다.
• EXIF, XMP, IPTC 메타데이터 읽기 및 쓰기를 지원합니다.
• 지정된 기본 이미지를 포함하여 하나의 파일에서 여러 이미지를 처리합니다.
• 썸네일을 추가하거나 제거하고 Apple 기기와 같은 그리드(타일) 인코딩을 지원합니다.
• 깊이 이미지(인물 사진 효과용) 및 보조 이미지(베타)를 읽을 수 있습니다.
• 한 줄 등록으로 모든 Pillow 코드가 즉시 HEIF 인식이 됩니다.
• macOS, Windows, Linux 등을 위한 사전 빌드된 휠이 제공됩니다.