using Titano.Core.Export; using Titano.Core.Project; using Titano.Core.Video; using Titano.Testing; namespace Titano.Core.Tests.Project; public sealed class ProjectSettingsTests { [Test] public void JsonRoundTripKeepsAutoAndManualValues() { var settings = new ProjectSettings { Exposure = new ExposureSettings { DeflickerWindow = new Auto().WithAdvice(41, "Advisor.Reason.FlickerPeriod", "10.2"), DeflickerStrength = new Auto().WithManual(0.8), }, Timing = new TimingSettings { FrameRate = new Auto().WithAdvice("24", null) }, ExcludedFrames = [3, 7], }; var back = ProjectSettings.FromJson(settings.ToJson()); Assert.Equal(41, back.Exposure.DeflickerWindow.Resolve(0)); Assert.True(back.Exposure.DeflickerWindow.IsAuto); Assert.Equal("Advisor.Reason.FlickerPeriod", back.Exposure.DeflickerWindow.ReasonKey); Assert.Equal(0.8, back.Exposure.DeflickerStrength.Resolve(1.0)); Assert.False(back.Exposure.DeflickerStrength.IsAuto); Assert.SequenceEqual(new[] { 3, 7 }, back.ExcludedFrames); Assert.Contains("\"deflickerWindow\"", settings.ToJson()); } [Test] public void ValueTypesFallBackOnlyWithoutAdvice() { Assert.Equal(21, new Auto().Resolve(21)); Assert.Equal(FlowQualitySetting.Balanced, new Auto().Resolve(FlowQualitySetting.Balanced)); Assert.Equal(0, new Auto().WithAdvice(0, null).Resolve(21)); Assert.False(new Auto().WithAdvice(false, null).Resolve(true)); Assert.Equal(0.5, new Auto().WithAdvice(0.8, null).WithManual(0.5).Resolve(1.0)); Assert.False(new Auto().WithManual(false).Resolve(true)); var back = ProjectSettings.FromJson(new ProjectSettings { Exposure = new ExposureSettings { Deflicker = new Auto().WithAdvice(false, null) }, }.ToJson()); Assert.False(back.Exposure.Deflicker.Resolve(true)); Assert.True(ProjectSettings.FromJson(new ProjectSettings().ToJson()).Exposure.Deflicker.Resolve(true)); } [Test] public void ResetReturnsToAdvice() { var a = new Auto().WithAdvice(41, null).WithManual(15); Assert.Equal(15, a.Resolve(0)); Assert.Equal(41, a.Reset().Resolve(0)); } [Test] public void NewerVersionIsRefused() => Assert.Throws(() => ProjectSettings.FromJson("{\"version\": 99}")); [Test] public void MissingMembersKeepTheirDefaults() { var defaults = new ProjectSettings().ToJson(); Assert.Equal(defaults, ProjectSettings.FromJson("{}").ToJson()); Assert.Equal(defaults, ProjectSettings.FromJson("null").ToJson()); // An API client's partial edit: one manual value, a section given as null, keys in another casing. var partial = ProjectSettings.FromJson( """{ "Exposure": { "deflicker": { "isAuto": false, "manual": false } }, "motion": null, "export": { "preset": { "isAuto": false, "manual": "4k-hevc" } } }"""); Assert.False(partial.Exposure.Deflicker.Resolve(true)); Assert.True(partial.Exposure.HolyGrail.IsAuto); Assert.Equal(0.9, partial.Exposure.HighlightKnee); Assert.True(partial.Motion.Stabilize.IsAuto); Assert.Equal("4k-hevc", partial.Export.Preset.Resolve("1080p-h264")); Assert.Equal("{date} {title} - {preset}", partial.Export.NameTemplate); Assert.SequenceEqual(new[] { 0.0, 1.0 }, partial.Timing.RemapCurve.Select(p => p.X)); Assert.Equal(9, partial.Stack.Length); Assert.Equal(ProjectSettings.CurrentVersion, partial.Version); // An explicit null clears a nullable value; arrays are replaced, not merged. var cleared = ProjectSettings.FromJson("""{ "exposure": { "highlightKnee": null }, "timing": { "remapCurve": [ { "x": 0, "y": 0.5 } ] } }"""); Assert.Null(cleared.Exposure.HighlightKnee); Assert.Equal(1, cleared.Timing.RemapCurve.Count); } [Test] public void NullHighlightKneeSurvivesTheRoundTrip() { // "No knee, hard clip" must not come back as the default knee when the project is rewritten. var off = new ProjectSettings { Exposure = new ExposureSettings { HighlightKnee = null } }; Assert.Contains("\"highlightKnee\": null", off.ToJson()); Assert.Null(ProjectSettings.FromJson(off.ToJson()).Exposure.HighlightKnee); Assert.Equal(0.9, ProjectSettings.FromJson(new ProjectSettings().ToJson()).Exposure.HighlightKnee); } [Test] public void NullListsAndTextsKeepTheirDefaults() { var project = ProjectSettings.FromJson( """{ "excludedFrames": null, "export": { "batch": null, "nameTemplate": null }, "timing": { "remapCurve": null }, "camera": { "keyframes": null } }"""); Assert.Count(0, project.ExcludedFrames); Assert.Count(0, project.Export.Batch); Assert.Equal("{date} {title} - {preset}", project.Export.NameTemplate); Assert.Count(2, project.Timing.RemapCurve); Assert.Count(0, project.Camera.Keyframes); // Nullable members without a default still clear. Assert.Null(ProjectSettings.FromJson("""{ "export": { "folder": null }, "heroFrame": null }""").HeroFrame); } [Test] public void DuplicateKeysAreAJsonError() { Assert.Throws(() => ProjectSettings.FromJson("""{ "version": 1, "version": 1 }""")); Assert.Throws(() => ProjectSettings.FromJson("""{ "Export": {}, "export": {} }""")); Assert.Throws(() => ProjectSettings.FromJson("""{ "export": { "batch": [], "Batch": [] } }""")); } [Test] public void ProjectMustBeAnObject() => Assert.Throws(() => ProjectSettings.FromJson("[1, 2]")); [Test] public void FramePositionsFollowInsertedFramesAndOtherMembersStay() { var project = new ProjectSettings { ExcludedFrames = [3, 7, 40], HeroFrame = 2, Camera = new CameraSettings { Keyframes = [new CameraKey(0, 0.5, 0.5, 1, 0), new CameraKey(7, 0.4, 0.5, 1.5, 0)] }, Exposure = new ExposureSettings { DeflickerWindow = new Auto().WithManual(41) }, }; // Two frames inserted before position 3 and one before position 7; 40 is no frame of the old list and stays. var moves = new Dictionary { [0] = 0, [1] = 1, [2] = 4, [3] = 5, [4] = 6, [5] = 7, [6] = 8, [7] = 10 }; var moved = ProjectSettings.FromJson(Assert.NotNull(ProjectSettings.MoveFramePositions(project.ToJson(), moves))); Assert.SequenceEqual([5, 10, 40], moved.ExcludedFrames); Assert.Equal(4, moved.HeroFrame); Assert.SequenceEqual([0, 10], moved.Camera.Keyframes.Select(k => k.Frame)); Assert.Equal((0.4, 1.5), (moved.Camera.Keyframes[1].CenterX, moved.Camera.Keyframes[1].Zoom)); Assert.Equal(41, moved.Exposure.DeflickerWindow.Manual); } [Test] public void MovingPositionsEditsTheJsonInPlace() { const string project = """{ "ExcludedFrames": [1, 2], "heroFrame": null, "futureOption": { "keep": [1, 2] }, "camera": { "keyframes": [ { "frame": 1.5 } ] } }"""; var moved = Assert.NotNull(ProjectSettings.MoveFramePositions(project, new Dictionary { [1] = 3 })); var json = System.Text.Json.Nodes.JsonNode.Parse(moved)!; Assert.SequenceEqual([3, 2], json["ExcludedFrames"]!.AsArray().Select(n => n!.GetValue())); Assert.Equal("""{"keep":[1,2]}""", json["futureOption"]!.ToJsonString()); Assert.Null(json["heroFrame"]); Assert.Equal(1.5, json["camera"]!["keyframes"]![0]!["frame"]!.GetValue()); } [Test] public void NothingToMoveGivesNoNewProject() { Assert.Null(ProjectSettings.MoveFramePositions(new ProjectSettings { ExcludedFrames = [1] }.ToJson(), new Dictionary())); Assert.Null(ProjectSettings.MoveFramePositions(new ProjectSettings { ExcludedFrames = [1] }.ToJson(), new Dictionary { [2] = 3, [1] = 1 })); Assert.Null(ProjectSettings.MoveFramePositions("not json", new Dictionary { [1] = 2 })); Assert.Null(ProjectSettings.MoveFramePositions("[1, 2]", new Dictionary { [1] = 2 })); Assert.Null(ProjectSettings.MoveFramePositions("""{ "heroFrame": 1, "HeroFrame": 1 }""", new Dictionary { [1] = 2 })); } [Test] public void PositionsCrossToAnotherCopyByPhotoAndWaitForPhotosItLacks() { // The server holds six photos; this copy only the last four, and one of its own the server lacks. var photos = Enumerable.Range(0, 7).Select(Photo).ToList(); var server = Frames(photos[..6]); var here = Frames([.. photos[2..6], photos[6]]); var project = new ProjectSettings { ExcludedFrames = [0, 3], HeroFrame = 1, Camera = new CameraSettings { Keyframes = [new CameraKey(0, 0.5, 0.5, 1, 0), new CameraKey(4, 0.4, 0.5, 1.5, 0)] }, Exposure = new ExposureSettings { DeflickerWindow = new Auto().WithManual(41) }, }; var taken = ProjectSettings.FromJson(Assert.NotNull(ProjectSettings.TranslateFramePositions(project.ToJson(), server, here))); Assert.SequenceEqual([1], taken.ExcludedFrames); Assert.Null(taken.HeroFrame); Assert.SequenceEqual([2], taken.Camera.Keyframes.Select(k => k.Frame)); Assert.Equal(1.5, taken.Camera.Keyframes[0].Zoom); Assert.Equal(41, taken.Exposure.DeflickerWindow.Manual); var pending = Assert.NotNull(taken.PendingFrames); Assert.Equal(2, pending.Count); var first = Assert.Contains(pending, p => p.Sha256 == photos[0].Sha256); Assert.True(first.Excluded && !first.Hero); Assert.Count(1, first.Keyframes); Assert.Equal(0.5, first.Keyframes[0].CenterX); Assert.True(Assert.Contains(pending, p => p.Sha256 == photos[1].Sha256).Hero); Assert.True(taken.HeroPending); // The two photos arrive (inserted before the others): what waited takes its place, and the rest moved with its frames. var arrived = Frames(photos); var moved = ProjectSettings.MoveFramePositions(taken.ToJson(), new Dictionary { [0] = 2, [1] = 3, [2] = 4, [3] = 5, [4] = 6 })!; var placed = ProjectSettings.FromJson(Assert.NotNull(ProjectSettings.TranslateFramePositions(moved, null, arrived))); Assert.SequenceEqual([0, 3], placed.ExcludedFrames); Assert.Equal(1, placed.HeroFrame); Assert.SequenceEqual([0, 4], placed.Camera.Keyframes.Select(k => k.Frame)); Assert.Null(placed.PendingFrames); Assert.Null(ProjectSettings.TranslateFramePositions(placed.ToJson(), null, arrived)); } [Test] public void SettingsSentBackLandOnTheSamePhotos() { var photos = Enumerable.Range(0, 5).Select(Photo).ToList(); var server = Frames(photos[1..]); var here = Frames(photos); // Photo 0 is only here: its exclusion waits on the server, and comes back as a position. var project = new ProjectSettings { ExcludedFrames = [0, 2], HeroFrame = 4 }; var sent = Assert.NotNull(ProjectSettings.TranslateFramePositions(project.ToJson(), here, server)); var back = ProjectSettings.FromJson(Assert.NotNull(ProjectSettings.TranslateFramePositions(sent, server, here))); Assert.SequenceEqual([1], ProjectSettings.FromJson(sent).ExcludedFrames); Assert.Equal(3, ProjectSettings.FromJson(sent).HeroFrame); Assert.Equal(project.ToJson(), back.ToJson()); } [Test] public void AHeroOrKeyframeChosenSinceIsNewerThanTheOneThatWaited() { var photos = Enumerable.Range(0, 3).Select(Photo).ToList(); var waiting = new ProjectSettings { HeroFrame = 2, Camera = new CameraSettings { Keyframes = [new CameraKey(0, 0.2, 0.2, 2, 0)] }, PendingFrames = [new PendingFrame { Sha256 = photos[0].Sha256, Size = photos[0].Size, Hero = true, Keyframes = [new CameraKey(9, 0.7, 0.7, 1, 0)] }], }; var placed = ProjectSettings.FromJson(Assert.NotNull(ProjectSettings.TranslateFramePositions(waiting.ToJson(), null, Frames(photos)))); Assert.Equal(2, placed.HeroFrame); Assert.Count(1, placed.Camera.Keyframes); Assert.Equal(0.2, placed.Camera.Keyframes[0].CenterX); Assert.Null(placed.PendingFrames); } [Test] public void AHeroChosenSinceAnotherWaitedStaysTheHeroWhenItMustWaitToo() { // This PC chose photo 3 as the hero before the server had it, so it waits there; an editor on the server then // chose photo 2, which this PC lacks. var photos = Enumerable.Range(0, 4).Select(Photo).ToList(); var server = Frames(photos[..3]); var here = Frames([photos[0], photos[1], photos[3]]); var edited = new ProjectSettings { ExcludedFrames = [0], HeroFrame = 2, PendingFrames = [new PendingFrame { Sha256 = photos[3].Sha256, Size = photos[3].Size, CapturedAt = photos[3].CapturedAt, Hero = true }], }; var taken = ProjectSettings.FromJson(Assert.NotNull(ProjectSettings.TranslateFramePositions(edited.ToJson(), server, here))); Assert.Null(taken.HeroFrame); Assert.SequenceEqual([0], taken.ExcludedFrames); var waiting = Assert.NotNull(taken.PendingFrames); Assert.Count(1, waiting); Assert.True(waiting[0].Hero && waiting[0].Sha256 == photos[2].Sha256, "the newer hero waits for its photo"); Assert.True(taken.HeroPending); // Its photo arrives: it is the hero again. var arrived = Frames([photos[0], photos[1], photos[2], photos[3]]); var moved = ProjectSettings.MoveFramePositions(taken.ToJson(), new Dictionary { [2] = 3 }) ?? taken.ToJson(); var placed = ProjectSettings.FromJson(Assert.NotNull(ProjectSettings.TranslateFramePositions(moved, null, arrived))); Assert.Equal(2, placed.HeroFrame); Assert.Null(placed.PendingFrames); // A hero chosen here while one waits clears the waiting one, even before its photo arrives. var chosen = (taken with { HeroFrame = 1 }).ToJson(); var cleared = ProjectSettings.FromJson(Assert.NotNull(ProjectSettings.TranslateFramePositions(chosen, null, here))); Assert.Equal(1, cleared.HeroFrame); Assert.Null(cleared.PendingFrames); } [Test] public void APhotoHeldTwiceKeepsEachCopysPositions() { // The server adopted a folder holding photo 1 twice ('IMG_0001.JPG', 'IMG_0001 (1).JPG'); this PC keeps it once. var photos = Enumerable.Range(0, 3).Select(Photo).ToList(); var server = Frames([photos[0], photos[1], photos[1], photos[2]]); var here = Frames(photos); var project = new ProjectSettings { ExcludedFrames = [2], HeroFrame = 2, Camera = new CameraSettings { Keyframes = [new CameraKey(1, 0.1, 0.5, 1, 0), new CameraKey(2, 0.2, 0.5, 1, 0)] }, }; // The second copy, which the deep analysis flags as a duplicate, is excluded there: this PC still renders its only copy. var taken = ProjectSettings.FromJson(Assert.NotNull(ProjectSettings.TranslateFramePositions(project.ToJson(), server, here))); Assert.Empty(taken.ExcludedFrames); Assert.Null(taken.HeroFrame); Assert.SequenceEqual([1], taken.Camera.Keyframes.Select(k => k.Frame)); Assert.Equal(0.1, taken.Camera.Keyframes[0].CenterX); var waiting = Assert.NotNull(taken.PendingFrames); Assert.Count(1, waiting); Assert.True(waiting[0] is { Excluded: true, Hero: true, Occurrence: 1 } && waiting[0].Sha256 == photos[1].Sha256); Assert.Count(1, waiting[0].Keyframes); Assert.Equal(0.2, waiting[0].Keyframes[0].CenterX); Assert.Contains("\"occurrence\": 1", taken.ToJson()); // Sent back after an edit of something else, every position lands on the copy it named. var edited = taken with { Exposure = new ExposureSettings { ExposureOffsetEv = 0.3 } }; var back = ProjectSettings.FromJson(Assert.NotNull(ProjectSettings.TranslateFramePositions(edited.ToJson(), here, server))); Assert.SequenceEqual([2], back.ExcludedFrames); Assert.Equal(2, back.HeroFrame); Assert.SequenceEqual([1, 2], back.Camera.Keyframes.Select(k => k.Frame)); Assert.SequenceEqual([0.1, 0.2], back.Camera.Keyframes.Select(k => k.CenterX)); Assert.Null(back.PendingFrames); // Both copies excluded there: this PC excludes its copy, and the server gets both back. var both = ProjectSettings.FromJson(Assert.NotNull(ProjectSettings.TranslateFramePositions(new ProjectSettings { ExcludedFrames = [1, 2] }.ToJson(), server, here))); Assert.SequenceEqual([1], both.ExcludedFrames); var excluded = Assert.NotNull(both.PendingFrames); Assert.Count(1, excluded); Assert.True(excluded[0] is { Excluded: true, Hero: false, Occurrence: 1 }); var returned = ProjectSettings.FromJson(Assert.NotNull(ProjectSettings.TranslateFramePositions(both.ToJson(), here, server))); Assert.SequenceEqual([1, 2], returned.ExcludedFrames); Assert.Null(returned.PendingFrames); } [Test] public void TheCopiesOfAPhotoAreToldApartByTheirOrder() { var time = new DateTime(2026, 9, 28, 18, 0, 0); var hashed = new FramePhoto(new string('a', 64), 100, time); var other = new FramePhoto(new string('b', 64), 200, time); // The copy at 3 has not been hashed yet: it is the same photo by size and capture time. var frames = Frames([other, hashed, other, new FramePhoto(null, 100, time), hashed]); Assert.SequenceEqual([1, 3, 4], new[] { 0, 1, 2 }.Select(n => frames.IndexOf(hashed, n)).OfType()); Assert.Null(frames.IndexOf(hashed, 3)); Assert.SequenceEqual([0, 0, 1, 1, 2], Enumerable.Range(0, 5).Select(frames.Occurrence)); Assert.Equal(0, frames.Occurrence(9)); Assert.Equal(2, frames.IndexOf(new FramePhoto(new string('B', 64), 0, null), 1)); } [Test] public void AProjectNamingNoFrameCrossesAsItIs() { var json = new ProjectSettings { Exposure = new ExposureSettings { DeflickerWindow = new Auto().WithManual(41) } }.ToJson(); Assert.False(ProjectSettings.NamesFrames(json)); Assert.False(json.Contains("pendingFrames", StringComparison.OrdinalIgnoreCase), "an old project reads and writes as it did"); Assert.False(ProjectSettings.NamesFrames("not json")); Assert.True(ProjectSettings.NamesFrames("""{ "HeroFrame": 0 }""")); Assert.Null(ProjectSettings.TranslateFramePositions(json, Frames([Photo(1)]), Frames([Photo(2)]))); Assert.Null(ProjectSettings.TranslateFramePositions("[1]", null, Frames([]))); } [Test] public void PhotosMatchByHashElseBySizeAndCaptureTime() { var time = new DateTime(2026, 9, 28, 18, 0, 0, 123); var hashed = new FramePhoto(new string('a', 64), 100, time); Assert.True(hashed.Matches(new FramePhoto(new string('A', 64), 1, null))); Assert.False(hashed.Matches(new FramePhoto(new string('b', 64), 100, time))); Assert.True(hashed.Matches(new FramePhoto("", 100, time.AddTicks(9_999)))); Assert.False(hashed.Matches(new FramePhoto(null, 100, time.AddMilliseconds(1)))); Assert.False(new FramePhoto(null, 100, null).Matches(new FramePhoto(null, 100, null))); var frames = Frames([new FramePhoto(null, 100, time), hashed]); Assert.Equal(1, frames.IndexOf(new FramePhoto(new string('a', 64), 100, null))); Assert.Equal(0, frames.IndexOf(new FramePhoto(null, 100, time))); Assert.Null(frames.IndexOf(new FramePhoto(null, 101, time))); } private static FramePhoto Photo(int seed) => new(Convert.ToHexStringLower(System.Security.Cryptography.SHA256.HashData([(byte)seed])), 1000 + seed, new DateTime(2026, 9, 28, 18, 0, 0).AddSeconds(10 * seed)); private static FramePhotos Frames(IEnumerable photos) => new(photos.Select((p, i) => (i, p))); [Test] public void BuiltInPresetIdsAreUnique() => Assert.Equal(ExportPresets.BuiltIn.Count, ExportPresets.BuiltIn.Select(p => p.Id).Distinct().Count()); [Test] public void BitRateFollowsBitsPerPixel() { var p = Assert.NotNull(ExportPresets.Find("4k-hevc10-archive")); // 0.30 × 3840 × 2160 × 24 ≈ 59.7 Mb/s (archive budget); share presets use the codec default. Assert.Equal(59_719_680L, p.EffectiveBitRate(3840, 2160, new Rational(24, 1))); Assert.Equal(19_906_560L, ExportPresets.Find("4k-h264")!.EffectiveBitRate(3840, 2160, new Rational(24, 1))); var s = p.ToEncodeSettings("out.mp4", 3840, 2160); Assert.Equal(24, s.GopLength); Assert.Equal(10, s.BitDepth); } }