/// <summary>
        /// Initializes a new instance of the <see cref="HeifImageHandle"/> class.
        /// </summary>
        /// <param name="handle">The handle.</param>
        /// <param name="decodeErrorHandler">The decode error handler.</param>
        /// <exception cref="ArgumentNullException"><paramref name="handle"/> is null.</exception>
        internal HeifImageHandle(SafeHeifImageHandle handle, HeifContext.ImageDecodeErrorDelegate decodeErrorHandler = null)
        {
            Validate.IsNotNull(handle, nameof(handle));

            this.imageHandle        = handle;
            this.decodeErrorHandler = decodeErrorHandler;
        }
        /// <summary>
        /// Initializes a new instance of the <see cref="HeifImageHandle"/> class.
        /// </summary>
        /// <param name="handle">The handle.</param>
        /// <param name="decodeErrorHandler">The decode error handler.</param>
        /// <param name="auxiliaryImageType">The auxiliary image type.</param>
        /// <exception cref="ArgumentNullException"><paramref name="handle"/> is null.</exception>
        private HeifImageHandle(SafeHeifImageHandle handle,
                                HeifContext.ImageDecodeErrorDelegate decodeErrorHandler,
                                AuxiliaryImageType auxiliaryImageType)
        {
            Validate.IsNotNull(handle, nameof(handle));

            this.imageHandle        = handle;
            this.decodeErrorHandler = decodeErrorHandler;
            this.auxiliaryImageType = auxiliaryImageType;
        }
 /// <summary>
 /// Initializes a new instance of the <see cref="HeifImageHandle"/> class.
 /// </summary>
 /// <param name="handle">The handle.</param>
 /// <param name="decodeErrorHandler">The decode error handler.</param>
 /// <exception cref="ArgumentNullException"><paramref name="handle"/> is null.</exception>
 internal HeifImageHandle(SafeHeifImageHandle handle, HeifContext.ImageDecodeErrorDelegate decodeErrorHandler = null)
     : this(handle, decodeErrorHandler, AuxiliaryImageType.None)
 {
 }