diff --git a/src/Titano.Core/Motion/Stabilizer.cs b/src/Titano.Core/Motion/Stabilizer.cs index 2cc05e26..ac8547c3 100644 --- a/src/Titano.Core/Motion/Stabilizer.cs +++ b/src/Titano.Core/Motion/Stabilizer.cs @@ -23,9 +23,10 @@ public sealed record StabilizerOptions /// Residual (px) under which a patch vector is an inlier of a similarity hypothesis. public double InlierThreshold { get; init; } = 1.0; - /// Largest plausible frame-to-frame rotation (radians) and |ln scale| of a hypothesis. + /// Largest plausible frame-to-frame rotation (radians) of a hypothesis. public double MaxRotation { get; init; } = 0.05; + /// Largest plausible frame-to-frame |ln scale| of a hypothesis. public double MaxScaleChange { get; init; } = 0.05; /// σ (frames) of the Gaussian-weighted local linear regression that smooths the camera path; 0 disables. @@ -58,13 +59,13 @@ public sealed record StabilizationResult( /// /// Video stabilisation. Per frame: Kuglin–Hines phase correlation of nine patches on a 3×3 grid against the -/// previous frame (patches analysed in parallel), texture gating (noise-compensated gradient energy, Immerkær 1996 noise estimate; a -/// textureless frame yields no vectors and therefore no motion), then a robust similarity fit (exhaustive -/// two-point hypotheses as deterministic RANSAC, plausibility limits, weighted least squares on the -/// inliers). accumulates the camera path, smooths its translation, rotation and log-scale -/// with Gaussian-weighted local linear regression (pans survive unchanged), and reports per-frame -/// corrections (smoothed ∘ raw⁻¹), shake RMS and the crop needed to hide borders. Memory holds two -/// luminance planes regardless of sequence length. +/// previous frame (patches analysed in parallel), texture gating (noise-compensated gradient energy, +/// Immerkær 1996 noise estimate; a textureless frame yields no vectors and therefore no motion), then a +/// robust similarity fit (exhaustive two-point hypotheses as deterministic RANSAC, plausibility limits, +/// weighted least squares on the inliers). accumulates the camera path, smooths its +/// translation, rotation and log-scale with Gaussian-weighted local linear regression (pans survive +/// unchanged), and reports per-frame corrections (smoothed ∘ raw⁻¹), shake RMS and the crop needed to hide +/// borders. Memory is two luminance planes plus one small record per frame. /// public sealed class Stabilizer : IDisposable {