SkiaSharp.Heic 0.0.1

SkiaSharp.Heic

HEIC/HEIF image format decoding support for SkiaSharp. Decode HEIC images to SKBitmap and SKImage, with multi-frame support.

Features

• Decode HEIC/HEIF images to SkiaSharp SKBitmap and SKImage
• Convert HEIC to other formats (PNG, JPEG, WEBP, etc.) via SkiaSharp encoding
• Multi-frame support for HEIC files with multiple images
• Cross-platform - pure C# implementation, works on Windows, macOS, Linux, iOS, Android
• Async support for non-blocking I/O operations

Installation

dotnet add package SkiaSharp.Heic

Or via NuGet Package Manager:

Install-Package SkiaSharp.Heic

Quick Start

Basic Decoding

using SkiaSharp;
using SkiaSharp.Heic;

// Decode HEIC to SKBitmap
using var bitmap = HeicDecoder.Decode("photo.heic");

// Or from a stream
using var stream = File.OpenRead("photo.heic");
using var bitmap2 = HeicDecoder.Decode(stream);

Convert HEIC to Other Formats

using SkiaSharp;
using SkiaSharp.Heic;

// Decode and convert to PNG
using var bitmap = HeicDecoder.Decode("photo.heic");
bitmap.SaveToFormat("photo.png", SKEncodedImageFormat.Png);

// Convert to JPEG with quality setting
bitmap.SaveToFormat("photo.jpg", SKEncodedImageFormat.Jpeg, quality: 85);

// Convert to WEBP
bitmap.SaveToFormat("photo.webp", SKEncodedImageFormat.Webp, quality: 90);

Access Image Information

using SkiaSharp.Heic;

using var info = HeicDecoder.DecodeWithInfo("photo.heic");

Console.WriteLine($"Dimensions: {info.ImageInfo.Width}x{info.ImageInfo.Height}");
Console.WriteLine($"Has Alpha: {info.HasAlpha}");
Console.WriteLine($"Frame count: {info.Frames.Count}");

Multi-Frame Support

using SkiaSharp.Heic;

using var info = HeicDecoder.DecodeWithInfo("multi-image.heic");

Console.WriteLine($"Frame count: {info.Frames.Count}");
Console.WriteLine($"Is animated: {info.IsAnimated}");

foreach (var frame in info.Frames)
{
    Console.WriteLine($"Frame {frame.Id}: {frame.Width}x{frame.Height}");

    using var frameBitmap = frame.ToBitmap();
    // Process frame...
}

// Get thumbnail if available
using var thumbnail = info.GetThumbnail();

Async Operations

using SkiaSharp.Heic;

// Async decoding
using var bitmap = await HeicDecoder.DecodeAsync("photo.heic");

// Async format conversion
await bitmap.SaveToFormatAsync("photo.png", SKEncodedImageFormat.Png);

Validation

using SkiaSharp.Heic;

// Check if a file is a valid HEIC image
using var stream = File.OpenRead("unknown.file");
if (HeicDecoder.CanDecode(stream))
{
    using var bitmap = HeicDecoder.Decode(stream);
    // Process...
}

// Try pattern for safe decoding
if (HeicDecoder.TryDecode("photo.heic", out var bitmap))
{
    using (bitmap)
    {
        // Process...
    }
}

Supported Platforms

Supported Output Formats

When converting from HEIC, you can use any format supported by SkiaSharp:

• PNG
• JPEG
• WEBP
• BMP
• GIF
• ICO

Dependencies

• SkiaSharp - 2D graphics library
• Openize.HEIC - HEIC decoder (pure C#)

Limitations

• Decoding only - This library only supports decoding HEIC files. Encoding to HEIC format is not supported.
• EXIF metadata - EXIF metadata extraction is not currently supported by the underlying Openize.HEIC decoder.
• HDR images - HDR HEIC images are not supported by the underlying decoder.
• P/B-slice animations - Only I-slice animations are supported.

License

This project is licensed under the MIT License - see the LICENSE file for details.

HEVC Patent Notice

HEIC images use the HEVC (H.265) codec, which is covered by patents. Users are responsible for ensuring compliance with HEVC patent licensing requirements for commercial use. See Access Advance for more information.

Test Images

Test images used in this project are from tigranbs/test-heic-images.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Acknowledgments

• Openize for the excellent HEIC decoder library
• SkiaSharp team for the cross-platform graphics library
• tigranbs for providing test HEIC images