/// <summary>
/// Decodes this instance to a <see cref="HeifImage"/>.
/// </summary>
/// <param name="colorspace">The destination image color space.</param>
/// <param name="chroma">The chroma.</param>
/// <param name="options">The decoding options.</param>
/// <returns>The decoded image.</returns>
/// <exception cref="HeifException">
/// A LibHeif error occurred.
///
/// -or-
///
/// The color profile type is not supported.
/// </exception>
/// <exception cref="ObjectDisposedException">The object has been disposed.</exception>
public HeifImage Decode(HeifColorspace colorspace, HeifChroma chroma, HeifDecodingOptions options = null)
{
VerifyNotDisposed();
HeifImage image = null;
SafeHeifImage safeHeifImage = null;
var imageHandleColorProfile = GetImageHandleColorProfile();
try
{
heif_error error;
if (options != null)
{
using (var safeHeifDecodingOptions = options.CreateDecodingOptions())
{
error = LibHeifNative.heif_decode_image(this.imageHandle,
out safeHeifImage,
colorspace,
chroma,
safeHeifDecodingOptions);
}
}
else
{
error = LibHeifNative.heif_decode_image(this.imageHandle,
out safeHeifImage,
colorspace,
chroma,
IntPtr.Zero);
}
if (error.IsError)
{
if (this.decodeErrorHandler != null)
{
this.decodeErrorHandler.Invoke(error);
}
else
{
error.ThrowIfError();
}
}
// Passing the image handle width and height works around a bug with the
// heif_image_get_primary_height method in some versions of libheif.
image = new HeifImage(safeHeifImage,
this.Width,
this.Height,
imageHandleColorProfile);
safeHeifImage = null;
}
finally
{
safeHeifImage?.Dispose();
}
return(image);
}