@@ -23,37 +23,42 @@ Python bindings to [libheif](https://github.com/strukturag/libheif) for working
2323Features:
2424 * Decoding of ` 8 ` , ` 10 ` , ` 12 ` bit HEIF images.
2525 * Encoding of ` 8 ` , ` 10 ` , ` 12 ` bit HEIF images.
26- * ` EXIF ` , ` XMP ` , ` IPTC ` metadata support.
26+ * ` EXIF ` , ` XMP ` , ` IPTC ` read & write support.
2727 * Support of multiple images in one file, e.g ** HEIC** files and ` PrimaryImage ` attribute.
2828 * HEIF ` native thumbnails ` support.
2929 * Adding all this features to Pillow in one line of code as a plugin.
3030 * Includes AVIF(x264) decoder.
3131
32+ ## Install
3233
33- ## Example of use as pillow plugin.
34+ ``` console
35+ python3 -m pip install pillow-heif
36+ ```
37+
38+ ## Example of use as pillow plugin
3439``` python3
3540from PIL import Image, ImageSequence
3641from pillow_heif import register_heif_opener
3742
3843register_heif_opener()
3944
40- image = Image.open(' images/input.heic' )
45+ image = Image.open(" images/input.heic" )
4146for i, frame in enumerate (ImageSequence.Iterator(image)):
4247 rotated = frame.rotate(13 )
43- rotated.save(f ' rotated_frame { i} .heic ' , quality = 90 )
48+ rotated.save(f " rotated_frame { i} .heic " , quality = 90 )
4449```
4550
4651## Standalone example use
4752``` python3
4853import pillow_heif
4954
50- if pillow_heif.is_supported(' input.heic' ):
51- heif_file = pillow_heif.open_heif(' input.heic' )
55+ if pillow_heif.is_supported(" input.heic" ):
56+ heif_file = pillow_heif.open_heif(" input.heic" )
5257 for img in heif_file: # you still can use it without iteration, like before.
5358 img.scale(1024 , 768 ) # scaling each image in file.
5459 heif_file.add_thumbnails([768 , 512 , 256 ]) # add three new thumbnail boxes.
5560 # default quality is probably ~77 in x265, set it a bit lower.
56- heif_file.save(' output.heic' , quality = 70 , save_all = False ) # save_all is True by default.
61+ heif_file.save(" output.heic" , quality = 70 , save_all = False ) # save_all is True by default.
5762```
5863
5964## More Information
0 commit comments