// Copyright (c) Six Labors. // Licensed under the Apache License, Version 2.0. using System.Collections.Generic; using System.IO; using System.Threading; using System.Threading.Tasks; using SixLabors.ImageSharp.Formats.Jpeg; using SixLabors.ImageSharp.Metadata; using SixLabors.ImageSharp.Metadata.Profiles.Exif; using SixLabors.ImageSharp.Metadata.Profiles.Icc; using SixLabors.ImageSharp.Metadata.Profiles.Iptc; using SixLabors.ImageSharp.PixelFormats; using SixLabors.ImageSharp.Processing; using SixLabors.ImageSharp.Tests.TestUtilities.ImageComparison; using Xunit; namespace SixLabors.ImageSharp.Tests.Formats.Jpg { [Trait("Format", "Jpg")] public class JpegEncoderTests { public static readonly TheoryData QualityFiles = new TheoryData { { TestImages.Jpeg.Baseline.Calliphora, 80 }, { TestImages.Jpeg.Progressive.Fb, 75 } }; public static readonly TheoryData BitsPerPixel_Quality = new TheoryData { { JpegSubsample.Ratio420, 40 }, { JpegSubsample.Ratio420, 60 }, { JpegSubsample.Ratio420, 100 }, { JpegSubsample.Ratio444, 40 }, { JpegSubsample.Ratio444, 60 }, { JpegSubsample.Ratio444, 100 }, }; public static readonly TheoryData RatioFiles = new TheoryData { { TestImages.Jpeg.Baseline.Ratio1x1, 1, 1, PixelResolutionUnit.AspectRatio }, { TestImages.Jpeg.Baseline.Snake, 300, 300, PixelResolutionUnit.PixelsPerInch }, { TestImages.Jpeg.Baseline.GammaDalaiLamaGray, 72, 72, PixelResolutionUnit.PixelsPerInch } }; [Theory] [MemberData(nameof(QualityFiles))] public void Encode_PreserveQuality(string imagePath, int quality) { var options = new JpegEncoder(); var testFile = TestFile.Create(imagePath); using (Image input = testFile.CreateRgba32Image()) { using (var memStream = new MemoryStream()) { input.Save(memStream, options); memStream.Position = 0; using (var output = Image.Load(memStream)) { JpegMetadata meta = output.Metadata.GetJpegMetadata(); Assert.Equal(quality, meta.Quality); } } } } [Theory] [WithFile(TestImages.Png.CalliphoraPartial, nameof(BitsPerPixel_Quality), PixelTypes.Rgba32)] [WithTestPatternImages(nameof(BitsPerPixel_Quality), 73, 71, PixelTypes.Rgba32)] [WithTestPatternImages(nameof(BitsPerPixel_Quality), 48, 24, PixelTypes.Rgba32)] [WithTestPatternImages(nameof(BitsPerPixel_Quality), 46, 8, PixelTypes.Rgba32)] [WithTestPatternImages(nameof(BitsPerPixel_Quality), 51, 7, PixelTypes.Rgba32)] [WithSolidFilledImages(nameof(BitsPerPixel_Quality), 1, 1, 255, 100, 50, 255, PixelTypes.Rgba32)] [WithTestPatternImages(nameof(BitsPerPixel_Quality), 7, 5, PixelTypes.Rgba32)] [WithTestPatternImages(nameof(BitsPerPixel_Quality), 600, 400, PixelTypes.Rgba32)] public void EncodeBaseline_WorksWithDifferentSizes(TestImageProvider provider, JpegSubsample subsample, int quality) where TPixel : unmanaged, IPixel => TestJpegEncoderCore(provider, subsample, quality); [Theory] [WithFile(TestImages.Png.BikeGrayscale, nameof(BitsPerPixel_Quality), PixelTypes.L8)] [WithSolidFilledImages(nameof(BitsPerPixel_Quality), 1, 1, 100, 100, 100, 255, PixelTypes.L8)] public void EncodeBaseline_GrayscaleWorksWithDifferentSizes(TestImageProvider provider, JpegSubsample subsample, int quality) where TPixel : unmanaged, IPixel => TestJpegEncoderCore(provider, subsample, quality, JpegColorType.Luminance); [Theory] [WithTestPatternImages(nameof(BitsPerPixel_Quality), 48, 48, PixelTypes.Rgba32 | PixelTypes.Bgra32)] public void EncodeBaseline_IsNotBoundToSinglePixelType(TestImageProvider provider, JpegSubsample subsample, int quality) where TPixel : unmanaged, IPixel => TestJpegEncoderCore(provider, subsample, quality); [Theory] [WithFile(TestImages.Png.CalliphoraPartial, PixelTypes.Rgba32, JpegSubsample.Ratio444)] [WithTestPatternImages(587, 821, PixelTypes.Rgba32, JpegSubsample.Ratio444)] [WithTestPatternImages(677, 683, PixelTypes.Bgra32, JpegSubsample.Ratio420)] [WithSolidFilledImages(400, 400, "Red", PixelTypes.Bgr24, JpegSubsample.Ratio420)] public void EncodeBaseline_WorksWithDiscontiguousBuffers(TestImageProvider provider, JpegSubsample subsample) where TPixel : unmanaged, IPixel { ImageComparer comparer = subsample == JpegSubsample.Ratio444 ? ImageComparer.TolerantPercentage(0.1f) : ImageComparer.TolerantPercentage(5f); provider.LimitAllocatorBufferCapacity().InBytesSqrt(200); TestJpegEncoderCore(provider, subsample, 100, JpegColorType.YCbCr, comparer); } /// /// Anton's SUPER-SCIENTIFIC tolerance threshold calculation /// private static ImageComparer GetComparer(int quality, JpegSubsample subsample) { float tolerance = 0.015f; // ~1.5% if (quality < 50) { tolerance *= 10f; } else if (quality < 75 || subsample == JpegSubsample.Ratio420) { tolerance *= 5f; if (subsample == JpegSubsample.Ratio420) { tolerance *= 2f; } } return ImageComparer.Tolerant(tolerance); } private static void TestJpegEncoderCore( TestImageProvider provider, JpegSubsample subsample, int quality = 100, JpegColorType colorType = JpegColorType.YCbCr, ImageComparer comparer = null) where TPixel : unmanaged, IPixel { using Image image = provider.GetImage(); // There is no alpha in Jpeg! image.Mutate(c => c.MakeOpaque()); var encoder = new JpegEncoder { Subsample = subsample, Quality = quality, ColorType = colorType }; string info = $"{subsample}-Q{quality}"; comparer ??= GetComparer(quality, subsample); // Does DebugSave & load reference CompareToReferenceInput(): image.VerifyEncoder(provider, "jpeg", info, encoder, comparer, referenceImageExtension: "png"); } [Fact] public void Quality_0_And_1_Are_Identical() { var options = new JpegEncoder { Quality = 0 }; var testFile = TestFile.Create(TestImages.Jpeg.Baseline.Calliphora); using (Image input = testFile.CreateRgba32Image()) using (var memStream0 = new MemoryStream()) using (var memStream1 = new MemoryStream()) { input.SaveAsJpeg(memStream0, options); options.Quality = 1; input.SaveAsJpeg(memStream1, options); Assert.Equal(memStream0.ToArray(), memStream1.ToArray()); } } [Fact] public void Quality_0_And_100_Are_Not_Identical() { var options = new JpegEncoder { Quality = 0 }; var testFile = TestFile.Create(TestImages.Jpeg.Baseline.Calliphora); using (Image input = testFile.CreateRgba32Image()) using (var memStream0 = new MemoryStream()) using (var memStream1 = new MemoryStream()) { input.SaveAsJpeg(memStream0, options); options.Quality = 100; input.SaveAsJpeg(memStream1, options); Assert.NotEqual(memStream0.ToArray(), memStream1.ToArray()); } } [Theory] [MemberData(nameof(RatioFiles))] public void Encode_PreserveRatio(string imagePath, int xResolution, int yResolution, PixelResolutionUnit resolutionUnit) { var options = new JpegEncoder(); var testFile = TestFile.Create(imagePath); using (Image input = testFile.CreateRgba32Image()) { using (var memStream = new MemoryStream()) { input.Save(memStream, options); memStream.Position = 0; using (var output = Image.Load(memStream)) { ImageMetadata meta = output.Metadata; Assert.Equal(xResolution, meta.HorizontalResolution); Assert.Equal(yResolution, meta.VerticalResolution); Assert.Equal(resolutionUnit, meta.ResolutionUnits); } } } } [Fact] public void Encode_PreservesIptcProfile() { // arrange using var input = new Image(1, 1); input.Metadata.IptcProfile = new IptcProfile(); input.Metadata.IptcProfile.SetValue(IptcTag.Byline, "unit_test"); var encoder = new JpegEncoder(); // act using var memStream = new MemoryStream(); input.Save(memStream, encoder); // assert memStream.Position = 0; using var output = Image.Load(memStream); IptcProfile actual = output.Metadata.IptcProfile; Assert.NotNull(actual); IEnumerable values = input.Metadata.IptcProfile.Values; Assert.Equal(values, actual.Values); } [Fact] public void Encode_PreservesExifProfile() { // arrange using var input = new Image(1, 1); input.Metadata.ExifProfile = new ExifProfile(); input.Metadata.ExifProfile.SetValue(ExifTag.Software, "unit_test"); var encoder = new JpegEncoder(); // act using var memStream = new MemoryStream(); input.Save(memStream, encoder); // assert memStream.Position = 0; using var output = Image.Load(memStream); ExifProfile actual = output.Metadata.ExifProfile; Assert.NotNull(actual); IReadOnlyList values = input.Metadata.ExifProfile.Values; Assert.Equal(values, actual.Values); } [Fact] public void Encode_PreservesIccProfile() { // arrange using var input = new Image(1, 1); input.Metadata.IccProfile = new IccProfile(IccTestDataProfiles.Profile_Random_Array); var encoder = new JpegEncoder(); // act using var memStream = new MemoryStream(); input.Save(memStream, encoder); // assert memStream.Position = 0; using var output = Image.Load(memStream); IccProfile actual = output.Metadata.IccProfile; Assert.NotNull(actual); IccProfile values = input.Metadata.IccProfile; Assert.Equal(values.Entries, actual.Entries); } [Theory] [InlineData(JpegSubsample.Ratio420, 0)] [InlineData(JpegSubsample.Ratio420, 3)] [InlineData(JpegSubsample.Ratio420, 10)] [InlineData(JpegSubsample.Ratio444, 0)] [InlineData(JpegSubsample.Ratio444, 3)] [InlineData(JpegSubsample.Ratio444, 10)] public async Task Encode_IsCancellable(JpegSubsample subsample, int cancellationDelayMs) { using var image = new Image(5000, 5000); using MemoryStream stream = new MemoryStream(); var cts = new CancellationTokenSource(); if (cancellationDelayMs == 0) { cts.Cancel(); } else { cts.CancelAfter(cancellationDelayMs); } var encoder = new JpegEncoder() { Subsample = subsample }; await Assert.ThrowsAsync(() => image.SaveAsync(stream, encoder, cts.Token)); } } }