Files
Chronos/tests/Titano.Core.Tests/Motion/VirtualCameraTests.cs
T
Claude 749eafeebd feat(motion): add Bézier-eased virtual camera composed with stabilisation
BezierEasing evaluates CSS-style cubic-bezier timing curves (Newton with
bisection fallback) with linear, ease-in, ease-out and ease-in-out
presets. VirtualCamera interpolates centre, roll and geometric zoom
between keyframes and returns one view-to-source affine composed with
the inverse stabiliser correction.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012iLMBNwBE2GnphAsu4cjaC
2026-10-02 09:36:42 +00:00

124 lines
5.2 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
using Titano.Core.Imaging.Geometry;
using Titano.Core.Motion;
using Titano.Testing;
namespace Titano.Core.Tests.Motion;
public sealed class VirtualCameraTests
{
private static readonly CameraKeyframe[] Path =
[
new(0, 0.5, 0.5, 1.0, 0),
new(30, 0.3, 0.6, 2.0, 5),
new(75, 0.7, 0.4, 1.5, -3),
new(100, 0.55, 0.45, 3.0, 0) { Easing = BezierEasing.Linear },
];
[Test]
public void EasedPathHitsKeyframesExactly()
{
var camera = new VirtualCamera(Path.Reverse());
foreach (var k in Path) Assert.Equal(k.State, camera.Evaluate(k.Frame));
Assert.Equal(Path[0].State, camera.Evaluate(-10));
Assert.Equal(Path[^1].State, camera.Evaluate(250));
}
[Test]
public void EaseInOutPathIsC1Continuous()
{
var camera = new VirtualCamera(Path);
const double h = 1e-5;
foreach (var frame in new[] { 30.0, 75.0 })
{
foreach (var component in Components)
{
var at = component(camera.Evaluate(frame));
var left = (at - component(camera.Evaluate(frame - h))) / h;
var right = (component(camera.Evaluate(frame + h)) - at) / h;
Assert.Approximately(left, right, 1e-3);
Assert.Approximately(0, right, 1e-3);
}
}
// No jumps in velocity anywhere: neighbouring derivatives differ only by curvature × step.
foreach (var component in Components)
{
double? previous = null;
for (var t = 0.0; t <= 100; t += 0.05)
{
var d = (component(camera.Evaluate(t + h)) - component(camera.Evaluate(t - h))) / (2 * h);
if (previous is { } p) Assert.Less(double.Abs(d - p), 2e-3);
previous = d;
}
}
}
[Test]
public void EasingPresetsBehave()
{
for (var t = 0.0; t <= 1.0; t += 0.01)
{
Assert.Approximately(t, BezierEasing.Linear.Evaluate(t), 1e-9);
Assert.Approximately(1, BezierEasing.EaseInOut.Evaluate(t) + BezierEasing.EaseInOut.Evaluate(1 - t), 1e-9);
}
Assert.Less(BezierEasing.EaseIn.Evaluate(0.5), 0.5);
Assert.Greater(BezierEasing.EaseOut.Evaluate(0.5), 0.5);
Assert.Equal(0.0, BezierEasing.EaseInOut.Evaluate(0));
Assert.Equal(1.0, BezierEasing.EaseInOut.Evaluate(1));
Assert.Monotonic(Enumerable.Range(0, 101).Select(i => BezierEasing.EaseInOut.Evaluate(i / 100.0)));
// CSS "ease" reference value: cubic-bezier(0.25, 0.1, 0.25, 1) at t = 0.5 ≈ 0.8024.
Assert.Approximately(0.8024, new BezierEasing(0.25, 0.1, 0.25, 1).Evaluate(0.5), 1e-3);
var overshoot = new BezierEasing(0.3, 0, 0.6, 1.6);
Assert.Greater(Enumerable.Range(0, 101).Max(i => overshoot.Evaluate(i / 100.0)), 1.0);
Assert.Throws<ArgumentOutOfRangeException>(() => _ = new BezierEasing(1.2, 0, 0.5, 1));
}
[Test]
public void ZoomInterpolatesGeometrically()
{
var camera = new VirtualCamera([new CameraKeyframe(0, 0.5, 0.5, 1, 0) { Easing = BezierEasing.Linear }, new CameraKeyframe(10, 0.5, 0.5, 4, 0)]);
Assert.Approximately(2, camera.Evaluate(5).Zoom, 1e-12);
Assert.Throws<ArgumentOutOfRangeException>(() => new VirtualCamera([new CameraKeyframe(0, 0.5, 0.5, 0.5, 0)]));
Assert.Throws<ArgumentException>(() => new VirtualCamera([new CameraKeyframe(3, 0.5, 0.5, 1, 0), new CameraKeyframe(3, 0.2, 0.5, 1, 0)]));
}
[Test]
public void ViewMapsToSourceWindow()
{
const int w = 1920, h = 1080;
Assert.True(VirtualCamera.ViewToSource(new CameraState(0.5, 0.5, 1, 0), w, h).IsIdentity(1e-12));
var zoomed = VirtualCamera.ViewToSource(new CameraState(0.25, 0.5, 2, 0), w, h);
var (cx, cy) = zoomed.Apply((w - 1) / 2.0, (h - 1) / 2.0);
Assert.Within(479.5, 539.5, cx, cy, 1e-9);
// The view's left edge lands half a view-width (w/4 source pixels) left of the centre.
var (lx, _) = zoomed.Apply(-0.5, (h - 1) / 2.0);
Assert.Approximately(480 - w / 4.0 - 0.5, lx, 1e-9);
var rolled = VirtualCamera.ViewToSource(new CameraState(0.5, 0.5, 1, 90), w, h);
var (vx, vy) = rolled.ApplyVector(1, 0);
Assert.Within(0, 1, vx, vy, 1e-12);
}
[Test]
public void ComposesWithStabilisationIntoOneAffine()
{
const int w = 640, h = 480;
var camera = new VirtualCamera(Path);
var correction = Affine2D.About(Affine2D.Similarity(1.01, 0.004, 1.5, -2.25), (w - 1) / 2.0, (h - 1) / 2.0);
var combined = camera.ToSource(42.5, w, h, correction);
var view = VirtualCamera.ViewToSource(camera.Evaluate(42.5), w, h);
foreach (var (x, y) in new[] { (0.0, 0.0), (320.0, 240.0), (639.0, 100.0) })
{
// Stabilised coordinates of the source sample must be where the view looks.
var (sx, sy) = combined.Apply(x, y);
var (tx, ty) = correction.Apply(sx, sy);
var (ex, ey) = view.Apply(x, y);
Assert.Within(ex, ey, tx, ty, 1e-9);
}
Assert.Equal(view, camera.ToSource(42.5, w, h));
}
private static readonly Func<CameraState, double>[] Components = [s => s.CenterX, s => s.CenterY, s => s.Zoom, s => s.Rotation / 100];
}