FileFormat.HEIC 24.7.0

FileFormat.HEIC

FileFormat.HEIC is an open source SDK implementing the ISO/IEC 23008-12:2017 HEIF file format decoder.

It is written from scratch and has a plain C# API to enable a simple integration into other software.

Supported features

FileFormat.HEIC has support for:

• HEIC coded static images;
  • I slices;
  • 4:2:0, 4:2:2 and 4:4:4 chroma subsampling.
• HEIC coded animations that use several I‑slices;
• multiple images in a file;
• alpha channels, depth maps, thumbnails, auxiliary images;
• correct color transform according to embedded color profiles;
• image transformations (crop, mirror, rotate), overlay images.

FileFormat.HEIC doesn't support:

• HDR images;
• reading EXIF and XMP metadata;
• color transform according to EXIF contained color profiles;
• HEIC coded animations that use P and B‑slices;
• deblocking filter.

New features & enhancements in version 24.6:

• HeicImage changes:
  • property "Frames" changed and grants access only to public frames;
  • added new property "AllFrames", it grants access to all frames.
• HeicImageFrame changes:
  • added property "IsHidden" that indicates if the frame is marked as hidden;
  • added property "IsImage" that indicates if the frame contains image data;
  • added property "AuxiliaryReferenceType" that indicates the type of auxiliary reference layer in case the frame type is auxiliary;
  • added method "GetTextData()" that grants access to text data for mime frame types;
  • methods GetByteArray() and GetInt32Array() now return null for non-image frames.

Usage examples

Read .heic file to int array with Argb32 data

using (var fs = new FileStream("filename.heic", FileMode.Open))
{
    HeicImage image = HeicImage.Load(fs);
    int[] pixels = image.GetInt32Array(Heic.Decoder.PixelFormat.Argb32);
}

Convert .heic file to .png

using (var fs = new FileStream("filename.heic", FileMode.Open))
{
    HeicImage image = HeicImage.Load(fs);
     
    var pixels = image.GetByteArray(Heic.Decoder.PixelFormat.Bgra32);
    var width = (int)image.Width;
    var height = (int)image.Height;
     
    var wbitmap = new WriteableBitmap(width, height, 72, 72, PixelFormats.Bgra32, null);
    var rect = new Int32Rect(0, 0, width, height);
    wbitmap.WritePixels(rect, pixels, 4 * width, 0);
    
    using FileStream saveStream = new FileStream("output.png", FileMode.OpenOrCreate);
    PngBitmapEncoder encoder = new PngBitmapEncoder();
    encoder.Frames.Add(BitmapFrame.Create(wbitmap));
    encoder.Save(saveStream);
}

Convert .heic file to .jpg

using (var fs = new FileStream("filename.heic", FileMode.Open))
{
    HeicImage image = HeicImage.Load(fs);
     
    var pixels = image.GetByteArray(Heic.Decoder.PixelFormat.Bgra32);
    var width = (int)image.Width;
    var height = (int)image.Height;
     
    var wbitmap = new WriteableBitmap(width, height, 72, 72, PixelFormats.Bgra32, null);
    var rect = new Int32Rect(0, 0, width, height);
    wbitmap.WritePixels(rect, pixels, 4 * width, 0);
    
    using FileStream saveStream = new FileStream("output.jpg", FileMode.OpenOrCreate);
    JpegBitmapEncoder encoder = new JpegBitmapEncoder();
    encoder.Frames.Add(BitmapFrame.Create(wbitmap));
    encoder.Save(saveStream);
}

Convert .heic collection to a set of .png files

using (var fs = new FileStream("filename.heic", FileMode.Open))
{
    HeicImage image = HeicImage.Load(fs);

    foreach (var key in image.Frames.Keys)
    {
        var width = (int)image.Frames[key].Width;
        var height = (int)image.Frames[key].Height;
        var pixels = image.Frames[key].GetByteArray(FileFormat.Heic.Decoder.PixelFormat.Bgra32);

        var wbitmap = new WriteableBitmap(width, height, 72, 72, PixelFormats.Bgra32, null);
        var rect = new Int32Rect(0, 0, width, height);
        wbitmap.WritePixels(rect, pixels, 4 * width, 0);

        using FileStream saveStream = new FileStream("output"+key+".png", FileMode.OpenOrCreate);
        PngBitmapEncoder encoder = new PngBitmapEncoder();
        encoder.Frames.Add(BitmapFrame.Create(wbitmap));
        encoder.Save(saveStream);
    }
}

Documentation

All public classes, methods and properties are documented in corresponding API_README:

• /FileFormat.Heic.Decoder/docs/API_README.md for FileFormat.Heic.Decoder;
• /FileFormat.IsoBmff/docs/API_README.md for FileFormat.IsoBmff.

HeicImage

Methods

Properties

HeicImageFrame

Methods

Properties

License

FileFormat.HEIC is available under Openize License.

⚠️ Openize does not and cannot grant You a patent license for the utilization of HEVC/H.265 image compression/decompression technologies.

FileFormat.HEIC uses FileFormat.IsoBmff that is distributed under MIT License.

OSS Notice

Sample files used for tests and located in the "./FileFormat.Heic.Tests/TestsData/samples/nokia" folder belong to Nokia Technologies and are used according to Nokia High-Efficiency Image File Format (HEIF) License

Licensed Field means the non-commercial purposes of evaluation, testing and academic research in each non-commercial case to use, run, modify (in a way that still complies with the Specification) and copy the Software to (a) generate, using one or more encoded pictures as inputs, a file complying with the Specification and including the one or more encoded pictures that were given as inputs; and/or (b) read a file complying with the Specification, resulting into one or more encoded pictures included in the file as outputs.