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.Metadata.Tiff; using Titano.Core.Tests.Metadata.Builders; 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}"); } } } [Test] public void TheChainProbesEachFileForItsTier() { var server = DecoderFactory.CreateServer(); // JPEG, PNG and TIFF decode natively whatever they hold: the probe does not even open them. Assert.Equal(DecodeTier.Native, server.Probe(Path.Combine(_dir, "absent.jpg"), ImageFileFormat.Jpeg).Tier); var supported = server.Probe(Write("IMG_5.CR2", Cr2File("Canon EOS 5D Mark III")), ImageFileFormat.Cr2); Assert.Equal((DecodeTier.Native, "managed-cr2"), (supported.Tier, supported.Decoder)); // An unsupported body decodes only through its 64×48 preview, rotated like the main image (orientation 6). var preview = server.Probe(Write("IMG_6.CR2", Cr2File("Canon EOS R99", orientation: 6)), ImageFileFormat.Cr2); Assert.Equal((DecodeTier.EmbeddedPreview, 48, 64), (preview.Tier, preview.Width, preview.Height)); Assert.Contains("no colour matrix", preview.Reason); 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 unknownBody = System.Text.Encoding.Latin1.GetBytes(System.Text.Encoding.Latin1.GetString(nef).Replace("NIKON D850", "NIKON Z99X")); var none = server.Probe(Write("DSC_7.NEF", unknownBody), ImageFileFormat.Nef); Assert.Equal(DecodeTier.Unavailable, none.Tier); Assert.Contains("no embedded preview", none.Reason); // A Windows-like provider native for CR3 answers from its codec list, before the managed preview tier. var client = DecoderFactory.CreateClient(new FakeProvider()); var cr3 = client.Probe(Path.Combine(_dir, "absent.cr3"), ImageFileFormat.Cr3); Assert.Equal((DecodeTier.Native, "fake"), (cr3.Tier, cr3.Decoder)); Assert.Equal(DecodeTier.Unavailable, client.Probe(Write("y.webp", Fixtures.WebP()), ImageFileFormat.WebP).Tier); } [Test] public void GoProRawDecodesThroughTheJpegBesideIt() { var gpr = Write("GOPR0001.GPR", Gpr(previewWidth: 64, previewHeight: 48)); var server = DecoderFactory.CreateServer(); // Alone, a GPR (VC-5, out of scope) shows its embedded preview. using (var alone = server.Decode(new DecodeRequest(gpr))) Assert.Equal(("managed-preview", 64), (alone!.Decoder, alone.Pixels.Width)); Write("GOPR0001.JPG", JpegFile(160, 120, 1)); using (var withJpeg = server.Decode(new DecodeRequest(gpr))) { Assert.Equal((DecodeTier.EmbeddedPreview, "managed-sidecar"), (withJpeg!.Tier, withJpeg.Decoder)); Assert.Equal((160, 120, 160, 120), (withJpeg.Pixels.Width, withJpeg.Pixels.Height, withJpeg.SourceWidth, withJpeg.SourceHeight)); } using (var scaled = server.Decode(new DecodeRequest(gpr, MaxLongEdge: 40, Purpose: DecodePurpose.Thumbnail))) Assert.Equal(40, scaled!.Pixels.Width); var probe = new ManagedDecoderProvider().Probe(gpr); Assert.Equal((DecodeTier.EmbeddedPreview, "managed-sidecar", 160, 120), (probe.Tier, probe.Decoder, probe.Width, probe.Height)); // A companion smaller than the embedded preview is not the better source. var big = Write("GOPR0002.GPR", Gpr(previewWidth: 320, previewHeight: 240)); Write("GOPR0002.JPG", JpegFile(160, 120, 1)); using (var preview = server.Decode(new DecodeRequest(big))) Assert.Equal(("managed-preview", 320), (preview!.Decoder, preview.Pixels.Width)); Assert.Equal("managed-preview", new ManagedDecoderProvider().Probe(big).Decoder); } [Test] public void GoProRawDecodesThroughItsJpegWhereTheImportKeptIt() { // An import splits sessions per format: the JPEG lives in another sequence folder, under its imported name. var gpr = Write("GOPR0003.GPR", Gpr(previewWidth: 64, previewHeight: 48)); var elsewhere = Path.Combine(context.CreateTempDirectory("jpeg-sequence"), "2026-09-28_0003.JPG"); File.WriteAllBytes(elsewhere, JpegFile(160, 120, 1)); var server = DecoderFactory.CreateServer(); using (var decoded = server.Decode(new DecodeRequest(gpr, Companion: elsewhere))) Assert.Equal(("managed-sidecar", 160, 120), (decoded!.Decoder, decoded.SourceWidth, decoded.SourceHeight)); var probe = server.Probe(gpr, ImageFileFormat.Gpr, elsewhere); Assert.Equal((DecodeTier.EmbeddedPreview, "managed-sidecar", 160, 120), (probe.Tier, probe.Decoder, probe.Width, probe.Height)); // A JPEG that is gone (deleted since) leaves the embedded preview; other formats ignore the companion. var gone = Path.Combine(_dir, "gone.JPG"); using (var preview = server.Decode(new DecodeRequest(gpr, Companion: gone))) Assert.Equal(("managed-preview", 64), (preview!.Decoder, preview.Pixels.Width)); Assert.Equal("managed-preview", server.Probe(gpr, ImageFileFormat.Gpr, gone).Decoder); var jpeg = Write("plain.jpg", JpegFile(64, 48, 1)); using (var plain = server.Decode(new DecodeRequest(jpeg, Companion: elsewhere))) Assert.Equal(("managed-jpeg", 64), (plain!.Decoder, plain.SourceWidth)); } [Test] public void AFileNoProviderCouldReadIsAReadErrorNotAnUndecodableFile() { var path = Write("locked.jpg", JpegFile(64, 48, 1)); // Every provider failed to read the file (locked by another program, a network read failed): nothing is known // about its content, so the caller gets the read error instead of "nothing decodes it". var unreadable = new ImageDecoder([new ScriptedProvider("a", _ => throw new IOException("sharing violation"))]); Assert.Throws(() => unreadable.Decode(new DecodeRequest(path))); // One provider read it and found nothing, another could not read it: still unproven. var mixed = new ImageDecoder([new ScriptedProvider("a", _ => null), new ScriptedProvider("b", _ => throw new IOException("short read"))]); Assert.Throws(() => mixed.Decode(new DecodeRequest(path))); // A provider that produces pixels wins over one that could not read the file. var recovered = new ImageDecoder([new ScriptedProvider("a", _ => throw new IOException("busy")), new ManagedDecoderProvider()]); using (var image = recovered.Decode(new DecodeRequest(path))) Assert.Equal("managed-jpeg", image!.Decoder); // Providers that read the file and found it malformed prove it undecodable. var damaged = new ImageDecoder([new ScriptedProvider("a", _ => throw new InvalidDataException("bad marker"))]); Assert.Null(damaged.Decode(new DecodeRequest(path))); Assert.Null(DecoderFactory.CreateServer().Decode(new DecodeRequest(Write("garbage.jpg", new byte[3000])))); Assert.Throws(() => DecoderFactory.CreateServer().Decode(new DecodeRequest(Path.Combine(_dir, "vanished.jpg")))); } /// A GoPro GPR as far as Titano reads it: a DNG made by "GoPro" whose only decodable image is a YCbCr JPEG preview. private static byte[] Gpr(int previewWidth, int previewHeight) { var preview = new IfdSpec().Long(TiffTags.NewSubfileType, 1) .Long(TiffTags.ImageWidth, (uint)previewWidth).Long(TiffTags.ImageLength, (uint)previewHeight) .Short(TiffTags.BitsPerSample, 8, 8, 8).Short(TiffTags.Compression, 7) .Short(TiffTags.PhotometricInterpretation, 6).Strip(JpegFile(previewWidth, previewHeight, 1)); var ifd0 = Fixtures.Ifd0("GoPro", "HERO8 Black", 1) .Bytes(TiffTags.DngVersion, 1, 4, 0, 0) .Child(TiffTags.SubIfds, preview); return TiffFile.Build(ifd0); } /// 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; } } /// A JPEG provider whose decode does what the test says (return nothing, or throw). private sealed class ScriptedProvider(string name, Func decode) : IImageDecoderProvider { public string Name => name; public DecodeTier? TierFor(ImageFileFormat format) => format == ImageFileFormat.Jpeg ? DecodeTier.Native : null; public DecodedImage? Decode(DecodeRequest request, CancellationToken cancellationToken = default) => decode(request); } }