PictureSharp.Heif 0.7.0

PictureSharp.Heif

HEIC/HEIF support for PictureSharp, written entirely in C# with no native libraries. Requires .NET 10+ and PictureSharp 0.9.0+.

dotnet add package PictureSharp.Heif --version 0.7.0

Quick start

Register the format once, then load and save .heic files like any other image:

using PictureSharp;
using PictureSharp.Formats.Heif;

ImageConfiguration.Default = ImageConfiguration.Default.ToBuilder().AddFormat(new HeifFormat()).Build();

using var image = Image.Load("photo.heic");
image.Mutate(x => x.Resize(1600, 0));
image.SaveAsHeic("small.heic", new HeifEncoderOptions { Quality = 60 });

Rotation, crop, alpha, ICC, EXIF and XMP are applied when loading.

Keep deeper samples

using Image photo = Image.Load("photo.heic", new DecoderOptions { PreserveBitDepth = true });
photo.SaveAsHeic("edited.heic", new HeifEncoderOptions { BitDepth = HeifBitDepth.Ten });

Main 10 files load into 16-bit Rgba64 storage. Saving uses up to 10-bit HEVC and remains lossy. Default loading stays 8-bit. Version 0.7.0 explains the depth options and Photos-edit limitations.

iPhone photos

An iPhone HEIC also holds a thumbnail, a depth map and an HDR gain map. HeifDocument reads them:

var document = await HeifDocument.OpenAsync("IMG_6655.HEIC");
HeifItemInfo photo = document.PrimaryImage;

using Image preview = document.LoadPreview(photo, new(320, 240));
using Image depth = document.LoadDepth(photo.FindDepthImage()!).ToImage();

using var withMap = Image.Load("IMG_6655.HEIC", new DecoderOptions { LoadGainMap = true });
using HdrImage hdr = withMap.ToHdr();

LivePhotoPair pair = LivePhotoPair.Read("IMG_8113.HEIC", "IMG_8113.MOV");

The Portrait blur and the Photos "Adjust" edits are not stored in the image itself. Render approximates both; you supply the slider values:

using Image edited = document.Render(photo, new HeifEdits
{
    Adjustments = new HeifPhotosAdjustments { Brightness = 25, Warmth = 10 },
    Portrait = new HeifPortraitOptions { Aperture = 2.8f },
});

Support

Limits, cancellation and TargetSize work as for the built-in formats. Decoded pixels match the HM reference decoder and libheif.

More: decoding · encoding · container · 0.6.10 release notes

License and patents

MIT. Ported code follows H.265, HM and kvazaar (BSD-3); see THIRD-PARTY-NOTICES.txt. libheif, libde265 and x265 are used only as test oracles. HEVC may require a patent license, which this package does not include.

Build

dotnet build -c Release
dotnet test -c Release