mirror of https://github.com/SixLabors/ImageSharp
James Jackson-South
1 week ago
9 changed files with 229 additions and 20 deletions
@ -0,0 +1,71 @@ |
|||||
|
// Copyright (c) Six Labors.
|
||||
|
// Licensed under the Six Labors Split License.
|
||||
|
|
||||
|
using System.Numerics; |
||||
|
using SixLabors.ImageSharp.PixelFormats; |
||||
|
|
||||
|
namespace SixLabors.ImageSharp.Formats.Heif; |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Provides HEIF-specific metadata for an image frame.
|
||||
|
/// </summary>
|
||||
|
public class HeifFrameMetadata : IFormatFrameMetadata<HeifFrameMetadata> |
||||
|
{ |
||||
|
/// <summary>
|
||||
|
/// Initializes a new instance of the <see cref="HeifFrameMetadata"/> class.
|
||||
|
/// </summary>
|
||||
|
public HeifFrameMetadata() |
||||
|
{ |
||||
|
} |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Initializes a new instance of the <see cref="HeifFrameMetadata"/> class by copying another instance.
|
||||
|
/// </summary>
|
||||
|
/// <param name="other">The metadata to copy.</param>
|
||||
|
private HeifFrameMetadata(HeifFrameMetadata other) => this.FrameDelay = other.FrameDelay; |
||||
|
|
||||
|
/// <summary>
|
||||
|
/// Gets or sets the frame display duration in seconds. The numerator contains duration units and the denominator
|
||||
|
/// contains units per second. Zero indicates that no explicit duration is available.
|
||||
|
/// </summary>
|
||||
|
public Rational FrameDelay { get; set; } = new(0); |
||||
|
|
||||
|
/// <inheritdoc/>
|
||||
|
public static HeifFrameMetadata FromFormatConnectingFrameMetadata(FormatConnectingFrameMetadata metadata) |
||||
|
=> new() |
||||
|
{ |
||||
|
FrameDelay = new Rational(metadata.Duration.TotalSeconds) |
||||
|
}; |
||||
|
|
||||
|
/// <inheritdoc/>
|
||||
|
public FormatConnectingFrameMetadata ToFormatConnectingFrameMetadata() |
||||
|
{ |
||||
|
double seconds = this.FrameDelay.ToDouble(); |
||||
|
|
||||
|
// Rational permits a zero denominator for metadata roundtripping. ImageSharp's connecting metadata cannot
|
||||
|
// represent an infinite duration, so preserve it as the same unspecified zero duration used by other formats.
|
||||
|
if (!double.IsFinite(seconds)) |
||||
|
{ |
||||
|
seconds = 0; |
||||
|
} |
||||
|
|
||||
|
return new FormatConnectingFrameMetadata |
||||
|
{ |
||||
|
BlendMode = FrameBlendMode.Source, |
||||
|
DisposalMode = FrameDisposalMode.DoNotDispose, |
||||
|
Duration = TimeSpan.FromSeconds(seconds) |
||||
|
}; |
||||
|
} |
||||
|
|
||||
|
/// <inheritdoc/>
|
||||
|
public void AfterFrameApply<TPixel>(ImageFrame<TPixel> source, ImageFrame<TPixel> destination, Matrix4x4 matrix) |
||||
|
where TPixel : unmanaged, IPixel<TPixel> |
||||
|
{ |
||||
|
} |
||||
|
|
||||
|
/// <inheritdoc/>
|
||||
|
IDeepCloneable IDeepCloneable.DeepClone() => this.DeepClone(); |
||||
|
|
||||
|
/// <inheritdoc/>
|
||||
|
public HeifFrameMetadata DeepClone() => new(this); |
||||
|
} |
||||
@ -0,0 +1,69 @@ |
|||||
|
// Copyright (c) Six Labors.
|
||||
|
// Licensed under the Six Labors Split License.
|
||||
|
|
||||
|
using SixLabors.ImageSharp.Formats; |
||||
|
using SixLabors.ImageSharp.Formats.Heif; |
||||
|
using SixLabors.ImageSharp.PixelFormats; |
||||
|
|
||||
|
namespace SixLabors.ImageSharp.Tests.Formats.Heif; |
||||
|
|
||||
|
[Trait("Format", "Heif")] |
||||
|
public class HeifFrameMetadataTests |
||||
|
{ |
||||
|
[Fact] |
||||
|
public void FormatCreatesFrameMetadata() |
||||
|
{ |
||||
|
HeifFrameMetadata metadata = HeifFormat.Instance.CreateDefaultFormatFrameMetadata(); |
||||
|
|
||||
|
Assert.Equal(new Rational(0), metadata.FrameDelay); |
||||
|
} |
||||
|
|
||||
|
[Fact] |
||||
|
public void DeepCloneCopiesFrameDelay() |
||||
|
{ |
||||
|
HeifFrameMetadata metadata = new() { FrameDelay = new Rational(1, 4) }; |
||||
|
|
||||
|
HeifFrameMetadata clone = metadata.DeepClone(); |
||||
|
clone.FrameDelay = new Rational(1, 2); |
||||
|
|
||||
|
Assert.Equal(new Rational(1, 4), metadata.FrameDelay); |
||||
|
Assert.Equal(new Rational(1, 2), clone.FrameDelay); |
||||
|
} |
||||
|
|
||||
|
[Fact] |
||||
|
public void DurationRoundTripsFormatConnectingMetadata() |
||||
|
{ |
||||
|
FormatConnectingFrameMetadata connectingMetadata = new() { Duration = TimeSpan.FromMilliseconds(250) }; |
||||
|
|
||||
|
HeifFrameMetadata metadata = HeifFrameMetadata.FromFormatConnectingFrameMetadata(connectingMetadata); |
||||
|
FormatConnectingFrameMetadata result = metadata.ToFormatConnectingFrameMetadata(); |
||||
|
|
||||
|
Assert.Equal(0.25, metadata.FrameDelay.ToDouble(), 10); |
||||
|
Assert.Equal(TimeSpan.FromMilliseconds(250), result.Duration); |
||||
|
Assert.Equal(FrameBlendMode.Source, result.BlendMode); |
||||
|
Assert.Equal(FrameDisposalMode.DoNotDispose, result.DisposalMode); |
||||
|
} |
||||
|
|
||||
|
[Fact] |
||||
|
public void ZeroDenominatorConvertsToUnspecifiedDuration() |
||||
|
{ |
||||
|
HeifFrameMetadata metadata = new() { FrameDelay = new Rational(1, 0) }; |
||||
|
|
||||
|
FormatConnectingFrameMetadata result = metadata.ToFormatConnectingFrameMetadata(); |
||||
|
|
||||
|
Assert.Equal(TimeSpan.Zero, result.Duration); |
||||
|
} |
||||
|
|
||||
|
[Fact] |
||||
|
public void ImageFrameMetadataExtensionsReturnAndCloneHeifMetadata() |
||||
|
{ |
||||
|
using Image<Rgba32> image = new(1, 1); |
||||
|
HeifFrameMetadata metadata = image.Frames.RootFrame.Metadata.GetHeifMetadata(); |
||||
|
metadata.FrameDelay = new Rational(1, 5); |
||||
|
|
||||
|
HeifFrameMetadata clone = image.Frames.RootFrame.Metadata.CloneHeifMetadata(); |
||||
|
|
||||
|
Assert.NotSame(metadata, clone); |
||||
|
Assert.Equal(metadata.FrameDelay, clone.FrameDelay); |
||||
|
} |
||||
|
} |
||||
Loading…
Reference in new issue