using Chronos.Core.Archiving; using Chronos.Core.Conversion; using Chronos.Core.Export; using Chronos.Core.Imaging; using Chronos.Core.Model; using Chronos.Testing; namespace Chronos.Core.Tests.Conversion; /// The dry run of a conversion (owner review 2, R7): which frames convert, which stay and why, the sizes, the space and the fingerprint. [Category("conversion")] public sealed class ConvertPlannerTests(TestContext context) { private static SidecarFrame Frame(int i, string file, ImageFileFormat format, string? sha = "s", FrameFlags flags = FrameFlags.None, DecodeTier tier = default) => new() { Id = Guid.NewGuid(), I = i, File = "originals/" + file, Size = 1000 + i, Sha256 = sha is null ? null : sha + i, Format = format, W = 6000, H = 4000, Flags = flags, Tier = tier, }; [Test] public void EachFrameThatCannotConvertSaysWhy() { var folder = new ArchivePaths(context.CreateTempDirectory("archive")).Sequence("2026/roof"); SidecarFrame[] frames = [ Frame(0, "IMG_0001.CR2", ImageFileFormat.Cr2), Frame(1, "IMG_0002.DNG", ImageFileFormat.Dng), Frame(2, "IMG_0003.CR2", ImageFileFormat.Cr2), Frame(3, "IMG_0004.CR2", ImageFileFormat.Cr2, sha: null), Frame(4, "IMG_0005.CR2", ImageFileFormat.Cr2, flags: FrameFlags.Undecodable), Frame(5, "IMG_0006.CR3", ImageFileFormat.Cr3), Frame(6, "IMG_0007.HEIC", ImageFileFormat.Heif), Frame(7, "IMG_0008.JPG", ImageFileFormat.Jpeg, flags: FrameFlags.Missing), Frame(8, "IMG_0009.CR2", ImageFileFormat.Cr2, flags: FrameFlags.PreviewOnly | FrameFlags.Excluded, tier: DecodeTier.EmbeddedPreview), ]; var manifest = new SequenceManifest { Id = Guid.NewGuid(), Frames = frames, Versions = new ManifestVersions { Frames = 7 } }; // The third photo's file is gone; the preview-only one probes as preview here. var present = frames.Where(f => f.I != 2).Select(f => f.File).ToList(); var decoder = new ImageDecoder([new ProbeAs(DecodeTier.EmbeddedPreview)]); var plan = ConvertPlanner.Plan(manifest, folder, present, new ConvertOptions(ConvertTarget.LinearDng), decoder, "Roof"); Assert.Equal((manifest.Id, "Roof", "2026/roof", 7), (plan.SequenceId, plan.Title, plan.Folder, plan.FramesVersion)); Assert.SequenceEqual([0], plan.Frames.Select(f => f.Index)); Assert.SequenceEqual( [(ConvertSkip.SameFormat, 1), (ConvertSkip.NoNativeDecoder, 2), (ConvertSkip.PreviewOnly, 1), (ConvertSkip.Undecodable, 1), (ConvertSkip.Missing, 2), (ConvertSkip.Unhashed, 1)], plan.Skipped.Select(s => (s.Reason, s.Frames))); Assert.True(plan.Converts); Assert.Equal(1000, plan.BytesBefore); Assert.Equal(ConvertPlanner.EstimateBytes(new ConvertOptions(ConvertTarget.LinearDng), 6000, 4000), plan.BytesAfter); Assert.Equal(8, plan.SkippedFrames); } [Test] public void APhotoRecordedAsPreviewOnlyElsewhereConvertsWhereItDecodes() { var folder = new ArchivePaths(context.CreateTempDirectory("archive")).Sequence("roof"); var frame = Frame(0, "IMG_0001.CR2", ImageFileFormat.Cr2, flags: FrameFlags.PreviewOnly, tier: DecodeTier.EmbeddedPreview); var manifest = new SequenceManifest { Id = Guid.NewGuid(), Frames = [frame] }; var plan = ConvertPlanner.Plan(manifest, folder, [frame.File], new ConvertOptions(ConvertTarget.Tiff16), new ImageDecoder([new ProbeAs(DecodeTier.Native)]), "Roof"); Assert.Count(1, plan.Frames); Assert.Empty(plan.Skipped); } [Test] public void SizesAreEstimatedFromThePixels() { const long pixels = 6000L * 4000; Assert.Equal((long)Math.Ceiling(pixels * 30 / 8.0), ConvertPlanner.EstimateBytes(new ConvertOptions(ConvertTarget.Tiff16), 6000, 4000)); Assert.Equal((long)Math.Ceiling(pixels * 26 / 8.0), ConvertPlanner.EstimateBytes(new ConvertOptions(ConvertTarget.LinearDng), 6000, 4000)); Assert.Equal((long)Math.Ceiling(pixels * ExportEstimator.JpegBitsPerPixel(95) * 1.25 / 8), ConvertPlanner.EstimateBytes(new ConvertOptions(ConvertTarget.Jpeg), 6000, 4000)); Assert.Less(ConvertPlanner.EstimateBytes(new ConvertOptions(ConvertTarget.Jpeg, 50), 6000, 4000), ConvertPlanner.EstimateBytes(new ConvertOptions(ConvertTarget.Jpeg, 95), 6000, 4000)); // Unknown size: a 24 MP frame. Assert.Equal(ConvertPlanner.EstimateBytes(new ConvertOptions(ConvertTarget.Tiff16), 6000, 4000), ConvertPlanner.EstimateBytes(new ConvertOptions(ConvertTarget.Tiff16), 0, 0)); Assert.Equal((long)Math.Ceiling(1_000_000_000 * 1.15) + (512L << 20), ConvertPlanner.Required(1_000_000_000)); Assert.True(new ConvertSpace(100, null).Enough); Assert.True(new ConvertSpace(100, 100).Enough); Assert.False(new ConvertSpace(100, 99).Enough); } [Test] public void TheFingerprintFollowsWhatThePlanConverts() { var id = Guid.NewGuid(); ConvertSequencePlan Sequence(int version, int frames, params ConvertBlock[] blocked) => new(id, "Roof", "roof", version, [.. Enumerable.Range(0, frames).Select(i => new ConvertFramePlan(Guid.Empty, i, $"f{i}", ImageFileFormat.Cr2, 10, 20))], [], blocked); ConvertPlan Plan(ConvertOptions options, ConvertMode mode, ConvertSequencePlan sequence) => new(Guid.Empty, options, mode, [sequence], new ConvertSpace(0, null)); var dng = new ConvertOptions(ConvertTarget.LinearDng); var reference = Plan(dng, ConvertMode.Replace, Sequence(3, 2)).Fingerprint(); Assert.Equal(64, reference.Length); Assert.Equal(reference, Plan(dng with { Quality = 40 }, ConvertMode.Replace, Sequence(3, 2)).Fingerprint()); Assert.NotEqual(reference, Plan(dng, ConvertMode.NewSequence, Sequence(3, 2)).Fingerprint()); Assert.NotEqual(reference, Plan(new ConvertOptions(ConvertTarget.Jpeg), ConvertMode.Replace, Sequence(3, 2)).Fingerprint()); Assert.NotEqual(reference, Plan(dng, ConvertMode.Replace, Sequence(4, 2)).Fingerprint()); Assert.NotEqual(reference, Plan(dng, ConvertMode.Replace, Sequence(3, 1)).Fingerprint()); var busy = Plan(dng, ConvertMode.Replace, Sequence(3, 2, ConvertBlock.Busy)); Assert.NotEqual(reference, busy.Fingerprint()); Assert.Equal((0, 0L), (busy.Frames, busy.BytesAfter)); Assert.NotEqual(Plan(new ConvertOptions(ConvertTarget.Jpeg, 90), ConvertMode.Replace, Sequence(3, 2)).Fingerprint(), Plan(new ConvertOptions(ConvertTarget.Jpeg, 80), ConvertMode.Replace, Sequence(3, 2)).Fingerprint()); } /// A provider that reads CR2 natively by format, and probes every file at a fixed tier. private sealed class ProbeAs(DecodeTier tier) : IImageDecoderProvider { public string Name => "probe"; public DecodeTier? TierFor(ImageFileFormat format) => format == ImageFileFormat.Cr2 ? DecodeTier.Native : null; public FileTier Probe(string path, ImageFileFormat format) => new(format, tier, Name, null, 0, 0); public DecodedImage? Decode(DecodeRequest request, CancellationToken cancellationToken = default) => null; } }