mono · mattleibow · Feb 5, 2026 · Feb 5, 2026 · Feb 5, 2026 · Feb 19, 2026
diff --git a/SkiaSharp.Extended.sln b/SkiaSharp.Extended.sln
@@ -21,38 +21,96 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SkiaSharp.Extended.UI.Maui.
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SkiaSharpDemo.Blazor", "samples\SkiaSharpDemo.Blazor\SkiaSharpDemo.Blazor.csproj", "{B7E4C45C-5CAB-444E-B2D3-294151544256}"
 EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SkiaSharp.Extended.DeepZoom.Tests", "tests\SkiaSharp.Extended.DeepZoom.Tests\SkiaSharp.Extended.DeepZoom.Tests.csproj", "{34DADF5B-AF1D-4896-9925-B113B13155D6}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
+		Debug|x64 = Debug|x64
+		Debug|x86 = Debug|x86
 		Release|Any CPU = Release|Any CPU
+		Release|x64 = Release|x64
+		Release|x86 = Release|x86
 	EndGlobalSection
 	GlobalSection(ProjectConfigurationPlatforms) = postSolution
 		{FDA62359-1C0D-4661-8ACF-023EF7DAF2A0}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{FDA62359-1C0D-4661-8ACF-023EF7DAF2A0}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{FDA62359-1C0D-4661-8ACF-023EF7DAF2A0}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{FDA62359-1C0D-4661-8ACF-023EF7DAF2A0}.Debug|x64.Build.0 = Debug|Any CPU
+		{FDA62359-1C0D-4661-8ACF-023EF7DAF2A0}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{FDA62359-1C0D-4661-8ACF-023EF7DAF2A0}.Debug|x86.Build.0 = Debug|Any CPU
 		{FDA62359-1C0D-4661-8ACF-023EF7DAF2A0}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{FDA62359-1C0D-4661-8ACF-023EF7DAF2A0}.Release|Any CPU.Build.0 = Release|Any CPU
+		{FDA62359-1C0D-4661-8ACF-023EF7DAF2A0}.Release|x64.ActiveCfg = Release|Any CPU
+		{FDA62359-1C0D-4661-8ACF-023EF7DAF2A0}.Release|x64.Build.0 = Release|Any CPU
+		{FDA62359-1C0D-4661-8ACF-023EF7DAF2A0}.Release|x86.ActiveCfg = Release|Any CPU
+		{FDA62359-1C0D-4661-8ACF-023EF7DAF2A0}.Release|x86.Build.0 = Release|Any CPU
 		{B5A95CCE-FF80-4ACA-AA49-F150C23C65D5}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{B5A95CCE-FF80-4ACA-AA49-F150C23C65D5}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{B5A95CCE-FF80-4ACA-AA49-F150C23C65D5}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{B5A95CCE-FF80-4ACA-AA49-F150C23C65D5}.Debug|x64.Build.0 = Debug|Any CPU
+		{B5A95CCE-FF80-4ACA-AA49-F150C23C65D5}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{B5A95CCE-FF80-4ACA-AA49-F150C23C65D5}.Debug|x86.Build.0 = Debug|Any CPU
 		{B5A95CCE-FF80-4ACA-AA49-F150C23C65D5}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{B5A95CCE-FF80-4ACA-AA49-F150C23C65D5}.Release|Any CPU.Build.0 = Release|Any CPU
+		{B5A95CCE-FF80-4ACA-AA49-F150C23C65D5}.Release|x64.ActiveCfg = Release|Any CPU
+		{B5A95CCE-FF80-4ACA-AA49-F150C23C65D5}.Release|x64.Build.0 = Release|Any CPU
+		{B5A95CCE-FF80-4ACA-AA49-F150C23C65D5}.Release|x86.ActiveCfg = Release|Any CPU
+		{B5A95CCE-FF80-4ACA-AA49-F150C23C65D5}.Release|x86.Build.0 = Release|Any CPU
 		{2C0DAB3F-1246-4AE7-BFA5-E7F5DDD7E1C4}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{2C0DAB3F-1246-4AE7-BFA5-E7F5DDD7E1C4}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{2C0DAB3F-1246-4AE7-BFA5-E7F5DDD7E1C4}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{2C0DAB3F-1246-4AE7-BFA5-E7F5DDD7E1C4}.Debug|x64.Build.0 = Debug|Any CPU
+		{2C0DAB3F-1246-4AE7-BFA5-E7F5DDD7E1C4}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{2C0DAB3F-1246-4AE7-BFA5-E7F5DDD7E1C4}.Debug|x86.Build.0 = Debug|Any CPU
 		{2C0DAB3F-1246-4AE7-BFA5-E7F5DDD7E1C4}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{2C0DAB3F-1246-4AE7-BFA5-E7F5DDD7E1C4}.Release|Any CPU.Build.0 = Release|Any CPU
+		{2C0DAB3F-1246-4AE7-BFA5-E7F5DDD7E1C4}.Release|x64.ActiveCfg = Release|Any CPU
+		{2C0DAB3F-1246-4AE7-BFA5-E7F5DDD7E1C4}.Release|x64.Build.0 = Release|Any CPU
+		{2C0DAB3F-1246-4AE7-BFA5-E7F5DDD7E1C4}.Release|x86.ActiveCfg = Release|Any CPU
+		{2C0DAB3F-1246-4AE7-BFA5-E7F5DDD7E1C4}.Release|x86.Build.0 = Release|Any CPU
 		{2C67033A-2C49-4146-B942-9CDD2E0BA412}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{2C67033A-2C49-4146-B942-9CDD2E0BA412}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{2C67033A-2C49-4146-B942-9CDD2E0BA412}.Debug|Any CPU.Deploy.0 = Debug|Any CPU
+		{2C67033A-2C49-4146-B942-9CDD2E0BA412}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{2C67033A-2C49-4146-B942-9CDD2E0BA412}.Debug|x64.Build.0 = Debug|Any CPU
+		{2C67033A-2C49-4146-B942-9CDD2E0BA412}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{2C67033A-2C49-4146-B942-9CDD2E0BA412}.Debug|x86.Build.0 = Debug|Any CPU
 		{2C67033A-2C49-4146-B942-9CDD2E0BA412}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{2C67033A-2C49-4146-B942-9CDD2E0BA412}.Release|Any CPU.Build.0 = Release|Any CPU
 		{2C67033A-2C49-4146-B942-9CDD2E0BA412}.Release|Any CPU.Deploy.0 = Release|Any CPU
+		{2C67033A-2C49-4146-B942-9CDD2E0BA412}.Release|x64.ActiveCfg = Release|Any CPU
+		{2C67033A-2C49-4146-B942-9CDD2E0BA412}.Release|x64.Build.0 = Release|Any CPU
+		{2C67033A-2C49-4146-B942-9CDD2E0BA412}.Release|x86.ActiveCfg = Release|Any CPU
+		{2C67033A-2C49-4146-B942-9CDD2E0BA412}.Release|x86.Build.0 = Release|Any CPU
 		{4B4EC78C-33B5-456D-BD7D-4358D16272F4}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{4B4EC78C-33B5-456D-BD7D-4358D16272F4}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{4B4EC78C-33B5-456D-BD7D-4358D16272F4}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{4B4EC78C-33B5-456D-BD7D-4358D16272F4}.Debug|x64.Build.0 = Debug|Any CPU
+		{4B4EC78C-33B5-456D-BD7D-4358D16272F4}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{4B4EC78C-33B5-456D-BD7D-4358D16272F4}.Debug|x86.Build.0 = Debug|Any CPU
 		{4B4EC78C-33B5-456D-BD7D-4358D16272F4}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{4B4EC78C-33B5-456D-BD7D-4358D16272F4}.Release|Any CPU.Build.0 = Release|Any CPU
 		{B7E4C45C-5CAB-444E-B2D3-294151544256}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{B7E4C45C-5CAB-444E-B2D3-294151544256}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{B7E4C45C-5CAB-444E-B2D3-294151544256}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{B7E4C45C-5CAB-444E-B2D3-294151544256}.Release|Any CPU.Build.0 = Release|Any CPU
+		{4B4EC78C-33B5-456D-BD7D-4358D16272F4}.Release|x64.ActiveCfg = Release|Any CPU
+		{4B4EC78C-33B5-456D-BD7D-4358D16272F4}.Release|x64.Build.0 = Release|Any CPU
+		{4B4EC78C-33B5-456D-BD7D-4358D16272F4}.Release|x86.ActiveCfg = Release|Any CPU
+		{4B4EC78C-33B5-456D-BD7D-4358D16272F4}.Release|x86.Build.0 = Release|Any CPU
+		{34DADF5B-AF1D-4896-9925-B113B13155D6}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{34DADF5B-AF1D-4896-9925-B113B13155D6}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{34DADF5B-AF1D-4896-9925-B113B13155D6}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{34DADF5B-AF1D-4896-9925-B113B13155D6}.Debug|x64.Build.0 = Debug|Any CPU
+		{34DADF5B-AF1D-4896-9925-B113B13155D6}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{34DADF5B-AF1D-4896-9925-B113B13155D6}.Debug|x86.Build.0 = Debug|Any CPU
+		{34DADF5B-AF1D-4896-9925-B113B13155D6}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{34DADF5B-AF1D-4896-9925-B113B13155D6}.Release|Any CPU.Build.0 = Release|Any CPU
+		{34DADF5B-AF1D-4896-9925-B113B13155D6}.Release|x64.ActiveCfg = Release|Any CPU
+		{34DADF5B-AF1D-4896-9925-B113B13155D6}.Release|x64.Build.0 = Release|Any CPU
+		{34DADF5B-AF1D-4896-9925-B113B13155D6}.Release|x86.ActiveCfg = Release|Any CPU
+		{34DADF5B-AF1D-4896-9925-B113B13155D6}.Release|x86.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -64,6 +122,7 @@ Global
 		{2C67033A-2C49-4146-B942-9CDD2E0BA412} = {51B0C2C7-732B-4A5C-A4F2-55655D147866}
 		{4B4EC78C-33B5-456D-BD7D-4358D16272F4} = {5555F827-12DF-4D15-BF07-3A720FC2EF3F}
 		{B7E4C45C-5CAB-444E-B2D3-294151544256} = {51B0C2C7-732B-4A5C-A4F2-55655D147866}
+		{34DADF5B-AF1D-4896-9925-B113B13155D6} = {5555F827-12DF-4D15-BF07-3A720FC2EF3F}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {08D78153-5DD7-4C52-A348-46AA448B2CFC}

diff --git a/docs/docs/animation.md b/docs/docs/animation.md
@@ -0,0 +1,110 @@
+# Animation System
+
+SkiaSharp.Extended ships a small, composable animation toolkit in the `SkiaSharp.Extended` assembly. It powers the built-in gesture animations in `SKGestureTracker` but is fully independent — you can use any part on its own.
+
+## Architecture
+
+| Class | Role |
+| :---- | :--- |
+| `SKAnimationTimer` | Runs an animation loop at ~60 fps using a platform timer. Cancels itself when done. |
+| `SKAnimationEasing` | Static easing functions (e.g., `CubicOut`, `Linear`). |
+| `SKAnimationSpring` | Single-axis spring physics (position + velocity). |
+
+All classes live in the `SkiaSharp.Extended` namespace.
+
+## SKAnimationTimer
+
+An internal animation runner used by `SKGestureTracker`. On each tick it fires a callback with the elapsed fraction (0 → 1). When the callback returns `false` the animation stops.
+
+```csharp
+// SKAnimationTimer is internal — use it via SKGestureTracker, or via SKAnimationEasing for your own easing.
+// To run your own animation, simply use a platform timer + SKAnimationEasing:
+
+private async void AnimateSomething()
+{
+    var start = DateTimeOffset.UtcNow;
+    var duration = TimeSpan.FromMilliseconds(300);
+
+    while (true)
+    {
+        var t = (DateTimeOffset.UtcNow - start).TotalSeconds / duration.TotalSeconds;
+        if (t >= 1.0) { t = 1.0; break; }
+
+        var eased = SKAnimationEasing.CubicOut(t);
+        ApplyValue(Lerp(fromValue, toValue, eased));
+
+        await Task.Delay(16); // ~60 fps
+    }
+    ApplyValue(toValue);
+}
+```
+
+## SKAnimationEasing
+
+A static class providing common easing curves. All functions take a `double t` in `[0, 1]` and return an eased value in approximately `[0, 1]`.
+
+```csharp
+using SkiaSharp.Extended;
+
+// Ease-out cubic: fast start, slows near end (the default for double-tap zoom)
+double eased = SKAnimationEasing.CubicOut(t);
+
+// Ease-in-out cubic: slow start, fast middle, slow end
+double eased = SKAnimationEasing.CubicInOut(t);
+
+// Linear (no easing)
+double eased = SKAnimationEasing.Linear(t);
+```
+
+All easing functions are pure static methods — no allocation, no state.
+
+## SKAnimationSpring
+
+A single-axis spring simulation. Useful for smooth animated transitions where you want physical feel (configurable stiffness and damping).
+
+```csharp
+using SkiaSharp.Extended;
+
+var spring = new SKAnimationSpring(0.0); // initialValue
+spring.Stiffness = 100.0;
+spring.DampingRatio = 1.0;
+
+// Set target (current position stays where it is, velocity carries through)
+spring.Target = 1.0;
+
+// Advance simulation (call ~60 fps)
+spring.Update(deltaTime: 0.016); // seconds
+
+// Read current state
+double position = spring.Current;
+bool settled = spring.IsSettled;
+```
+
+**Properties:**
+- `Stiffness` — how fast the spring snaps to target (higher = faster). Default `100.0`.
+- `DampingRatio` — `1.0` = critically damped (no overshoot), `< 1.0` = bouncy, `> 1.0` = sluggish.
+- `Target` — the target value the spring is animating toward.
+- `Current` — the current interpolated value.
+- `IsSettled` — `true` when position and velocity are both near zero.
+
+## Relationship to SKGestureTracker
+
+`SKGestureTracker` uses `SKAnimationTimer` and `SKAnimationEasing` internally to animate fling deceleration and double-tap zoom. These animations fire `TransformChanged` events on each frame — you don't need to manage a timer yourself.
+
+```
+Touch events
+    ↓
+SKGestureTracker  ← owns SKAnimationTimer + SKAnimationEasing
+    ↓ TransformChanged (every frame while animating)
+Your code  →  update viewport / deep zoom controller / canvas
+    ↓ InvalidateSurface
+Canvas repaint
+```
+
+## Next Steps
+
+- [Gestures](gestures.md) — SKGestureTracker and how animation integrates with gesture handling
+- [Gesture Configuration](gesture-configuration.md) — Fine-tune zoom speed, fling behavior, and easing
+- [Deep Zoom](deep-zoom.md) — How animation and gestures compose with tile loading
+- [API Reference — SKAnimationEasing](xref:SkiaSharp.Extended.SKAnimationEasing)
+- [API Reference — SKAnimationSpring](xref:SkiaSharp.Extended.SKAnimationSpring)
diff --git a/docs/docs/deep-zoom-blazor.md b/docs/docs/deep-zoom-blazor.md
@@ -0,0 +1,83 @@
+# Deep Zoom for Blazor
+
+Use `SKDeepZoomController` with a plain `SKCanvasView` to render Deep Zoom images in Blazor WebAssembly. There is no custom component — the page wires the services directly to the canvas.
+
+## Quick Start
+
+```razor
+@page "/deepzoom"
+@implements IDisposable
+@inject HttpClient Http
+@using SkiaSharp.Extended.DeepZoom
+
+<SKCanvasView @ref="_canvas"
+              OnPaintSurface="OnPaintSurface"
+              style="width: 100%; height: 600px; border: 1px solid #ccc;" />
+
+@code {
+    private SKCanvasView? _canvas;
+    private SKDeepZoomController? _controller;
+
+    protected override async Task OnAfterRenderAsync(bool firstRender)
+    {
+        if (!firstRender) return;
+
+        _controller = new SKDeepZoomController();
+        _controller.InvalidateRequired += OnInvalidateRequired;
+
+        var xml        = await Http.GetStringAsync("deepzoom/image.dzi");
+        var baseUrl    = new Uri(Http.BaseAddress!, "deepzoom/image_files/").ToString();
+        var tileSource = SKDeepZoomImageSource.Parse(xml, baseUrl);
+
+        _controller.Load(tileSource, new SKDeepZoomHttpTileFetcher(new HttpClient()));
+
+        await InvokeAsync(StateHasChanged);
+    }
+
+    private void OnPaintSurface(SKPaintSurfaceEventArgs e)
+    {
+        if (_controller == null) return;
+
+        _controller.SetControlSize(e.Info.Width, e.Info.Height);
+        _controller.Update();
+        _controller.Render(e.Surface.Canvas);
+    }
+
+    private void OnInvalidateRequired(object? sender, EventArgs e)
+        => InvokeAsync(() => _canvas?.Invalidate());
+
+    public void Dispose()
+    {
+        if (_controller != null)
+        {
+            _controller.InvalidateRequired -= OnInvalidateRequired;
+            _controller.Dispose();
+        }
+    }
+}
+```
+
+## Serving Tile Assets
+
+Place `.dzi` and tile folder under `wwwroot`. In the project file, reference them as content:
+
+```xml
+<ItemGroup>
+    <Content Include="wwwroot\deepzoom\image.dzi" />
+    <Content Include="wwwroot\deepzoom\image_files\**" />
+</ItemGroup>
+```
+
+The `SKDeepZoomHttpTileFetcher` fetches each tile URL via `HttpClient`; tile URLs are constructed automatically from the base URL you supply to `SKDeepZoomImageSource.Parse`.
+
+## Rendering Behaviour
+
+- **Fit and center**: On load the controller calls `FitToView()` so the full image is visible and centered in the canvas. Neither cropping nor distortion occurs.
+- **Tile resolution**: `Update()` selects the pyramid level whose tile size best matches the physical pixel dimensions of the canvas. Only visible tiles are requested.
+- **Tile blending**: While high-resolution tiles are in-flight, parent-level tiles are upscaled and drawn as placeholders.
+
+## Related
+
+- [Deep Zoom overview](deep-zoom.md) — architecture, services, and API reference
+- [Deep Zoom for MAUI](deep-zoom-maui.md) — .NET MAUI integration
+