using Titano.Core.Codecs.Jpeg; using Titano.Core.Codecs.Png; using Titano.Core.Codecs.Raw; using Titano.Core.Codecs.Tiff; using Titano.Core.Imaging; using Titano.Core.Imaging.Decoders; using Titano.Core.Metadata; using Titano.Core.Tests.Raw; using Titano.Testing; using static Titano.Core.Tests.Raw.NativeRawWriters; namespace Titano.Core.Tests.Decoding; /// Tier selection (native → embedded preview → unavailable), decoder chains and fast paths. public sealed class ManagedDecoderProviderTests(TestContext context) { private const int W = 96, H = 64; private readonly string _dir = context.CreateTempDirectory(); private string Write(string name, byte[] data) { var path = Path.Combine(_dir, name); File.WriteAllBytes(path, data); return path; } private static byte[] Cr2File(string model, int orientation = 1) { using var scene = SyntheticRaw.Smooth(W, H); var active = new RawRect(24, 4, 24 + W, 4 + H); return Cr2(Sensor(scene, "Canon EOS 5D Mark III", CfaPattern.Bayer("RGGB"), 128, 72, active.Left, active.Top, 2048, 16383), active, orientation, model); } private static byte[] JpegFile(int width, int height, int orientation) { using var image = SyntheticRaw.Smooth(width, height); var exif = ExifWriter.BuildTiff(new FrameMetadata { Make = "TestCam", Model = "T1", Orientation = orientation }); return JpegEncoder.Encode(image, new JpegEncodeOptions { Quality = 90, App1Segments = [[.. "Exif\0\0"u8, .. exif]] }); } [Test] public void ServerFormatTableReportsTiers() { var rows = DecoderFactory.DescribeFormats(DecoderFactory.CreateServer()).ToDictionary(r => r.Format.Format); foreach (var f in new[] { ImageFileFormat.Jpeg, ImageFileFormat.Png, ImageFileFormat.Tiff, ImageFileFormat.Dng, ImageFileFormat.Cr2, ImageFileFormat.Nef, ImageFileFormat.Arw, ImageFileFormat.Pef, ImageFileFormat.Raf }) { Assert.Equal(DecodeTier.Native, rows[f].Tier); Assert.Equal("managed", rows[f].Provider); } foreach (var f in new[] { ImageFileFormat.Cr3, ImageFileFormat.Orf, ImageFileFormat.Rw2, ImageFileFormat.Heif }) Assert.Equal(DecodeTier.EmbeddedPreview, rows[f].Tier); foreach (var f in new[] { ImageFileFormat.WebP, ImageFileFormat.JpegXl, ImageFileFormat.Gif }) { Assert.Equal(DecodeTier.Unavailable, rows[f].Tier); Assert.Null(rows[f].Provider); } } [Test] public void ClientChainPrefersTheWindowsProvider() { var wic = new FakeProvider(); var decoder = DecoderFactory.CreateClient(wic); Assert.Equal(2, decoder.Providers.Count); var rows = DecoderFactory.DescribeFormats(decoder).ToDictionary(r => r.Format.Format); Assert.Equal("fake", rows[ImageFileFormat.Cr3].Provider); Assert.Equal(DecodeTier.Native, rows[ImageFileFormat.Cr3].Tier); Assert.Equal("fake", rows[ImageFileFormat.Jpeg].Provider); Assert.Equal("managed", rows[ImageFileFormat.Dng].Provider); // The Windows provider declines this file: the managed provider decodes it. var path = Write("a.jpg", JpegFile(64, 48, 1)); using var image = decoder.Decode(new DecodeRequest(path)); Assert.Equal(1, wic.Calls); Assert.Equal("managed-jpeg", image!.Decoder); Assert.Count(1, DecoderFactory.CreateClient(null).Providers); } [Test] public void SupportedRawDecodesNatively() { var path = Write("IMG_1.CR2", Cr2File("Canon EOS 5D Mark III")); var provider = new ManagedDecoderProvider(); Assert.Equal(DecodeTier.Native, provider.Probe(path).Tier); using var image = DecoderFactory.CreateServer().Decode(new DecodeRequest(path)); Assert.Equal(DecodeTier.Native, image!.Tier); Assert.Equal("managed-cr2", image.Decoder); Assert.Equal(W, image.Pixels.Width); Assert.Equal(W, image.SourceWidth); } [Test] public void UnsupportedBodyFallsBackToTheOrientedPreview() { var path = Write("IMG_2.CR2", Cr2File("Canon EOS R99", orientation: 6)); var probe = new ManagedDecoderProvider().Probe(path); Assert.Equal(DecodeTier.EmbeddedPreview, probe.Tier); Assert.Contains("no colour matrix", probe.Reason); using var image = DecoderFactory.CreateServer().Decode(new DecodeRequest(path)); Assert.Equal(DecodeTier.EmbeddedPreview, image!.Tier); Assert.Equal("managed-preview", image.Decoder); // The 64×48 preview is rotated by the RAW's orientation (6). Assert.Equal(48, image.Pixels.Width); Assert.Equal(64, image.Pixels.Height); Assert.Equal(48, image.SourceWidth); Assert.Null(DecoderFactory.CreateServer().Decode(new DecodeRequest(path, AllowPreview: false))); } [Test] public void ForcePreviewSkipsNativeDevelopment() { var path = Write("IMG_3.CR2", Cr2File("Canon EOS 5D Mark III")); using var image = DecoderFactory.CreateServer().Decode(new DecodeRequest(path, ForcePreview: true)); Assert.Equal(DecodeTier.EmbeddedPreview, image!.Tier); Assert.Equal(64, image.Pixels.Width); } [Test] public void FilesWithoutDecoderOrPreviewAreUnavailable() { // A NEF whose body has no matrix and no preview, and a WebP. using var scene = SyntheticRaw.Smooth(W, H); var nef = Nef(Sensor(scene, "Nikon D850", CfaPattern.Bayer("RGGB"), W, H, 0, 0, 600, 16383), 14, NefEncoding.Lossless); var text = System.Text.Encoding.Latin1.GetString(nef).Replace("NIKON D850", "NIKON Z99X"); var path = Write("DSC_9.NEF", System.Text.Encoding.Latin1.GetBytes(text)); Assert.Equal(DecodeTier.Unavailable, new ManagedDecoderProvider().Probe(path).Tier); Assert.Null(DecoderFactory.CreateServer().Decode(new DecodeRequest(path))); var webp = Write("x.webp", Metadata.Builders.Fixtures.WebP()); Assert.Null(DecoderFactory.CreateServer().Decode(new DecodeRequest(webp))); Assert.Equal(DecodeTier.Unavailable, new ManagedDecoderProvider().Probe(webp).Tier); } [Test] public void JpegUsesDctScalingAndOrientation() { var path = Write("big.jpg", JpegFile(1600, 1200, 6)); using var small = DecoderFactory.CreateServer().Decode(new DecodeRequest(path, MaxLongEdge: 300)); Assert.Equal(225, small!.Pixels.Width); Assert.Equal(300, small.Pixels.Height); Assert.Equal(1200, small.SourceWidth); Assert.Equal(1600, small.SourceHeight); using var stored = DecoderFactory.CreateServer().Decode(new DecodeRequest(path, MaxLongEdge: 300, ApplyOrientation: false)); Assert.Equal(300, stored!.Pixels.Width); Assert.Equal(3, stored.Pixels.Channels); } [Test] public void RawFastPathsBinAndFit() { using var scene = SyntheticRaw.Smooth(W, H); var path = Write("f.dng", SyntheticDng.Write(scene, new DngSpec())); using var thumb = DecoderFactory.CreateServer().Decode(new DecodeRequest(path, MaxLongEdge: 40, Purpose: DecodePurpose.Thumbnail)); Assert.Equal(40, thumb!.Pixels.Width); Assert.Equal(27, thumb.Pixels.Height); Assert.Equal(W, thumb.SourceWidth); using var expected = Resampler.Resize(scene, 40, 27, ResampleFilter.Box); Assert.GreaterOrEqual(SyntheticRaw.Psnr(expected, thumb.Pixels, 1), 35); } [Test] public void PngAndTiffDecodeToRgb() { using var gray = new ImageBuffer(20, 10, 1); gray.Plane(0).Fill(0.25f); var png = Write("g.png", PngEncoder.Encode(gray)); using var p = DecoderFactory.CreateServer().Decode(new DecodeRequest(png)); Assert.Equal(3, p!.Pixels.Channels); Assert.Approximately(0.25, p.Pixels[2, 5, 5], 0.01); var tif = Write("g.tif", TiffWriter.Write(gray)); using var t = DecoderFactory.CreateServer().Decode(new DecodeRequest(tif, MaxLongEdge: 10)); Assert.Equal(3, t!.Pixels.Channels); Assert.Equal(10, t.Pixels.Width); Assert.Equal("managed-tiff", t.Decoder); } [Test] public void CorruptedRawFilesOnlyRaiseInvalidDataOrReturnNull() { var file = Cr2File("Canon EOS 5D Mark III"); var provider = new ManagedDecoderProvider(); var random = new Random(17); for (var i = 0; i < 60; i++) { var variant = i < 20 ? file[..(file.Length * i / 20)] : (byte[])file.Clone(); if (i >= 20) { for (var k = 0; k < 3; k++) variant[random.Next(variant.Length)] = (byte)random.Next(256); } var path = Write($"fuzz{i}.cr2", variant); try { provider.Probe(path); using var image = provider.Decode(new DecodeRequest(path, MaxLongEdge: i % 2 == 0 ? 0 : 32, Purpose: DecodePurpose.Thumbnail)); } catch (InvalidDataException) { } catch (Exception ex) { Assert.Fail($"variant {i}: {ex.GetType().Name}: {ex.Message}\n{ex.StackTrace}"); } } } /// A Windows-like provider claiming native support for everything but declining every file. private sealed class FakeProvider : IImageDecoderProvider { public int Calls { get; private set; } public string Name => "fake"; public DecodeTier? TierFor(ImageFileFormat format) => format is ImageFileFormat.Jpeg or ImageFileFormat.Cr3 ? DecodeTier.Native : null; public DecodedImage? Decode(DecodeRequest request, CancellationToken cancellationToken = default) { Calls++; return null; } } }