Add DeepZoom static preview services and samples

SkiaSharp.Extended.sln

@@ -21,38 +21,118 @@ 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("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "SkiaSharp.Extended.ImagePyramid.Tests", "tests\SkiaSharp.Extended.ImagePyramid.Tests\SkiaSharp.Extended.ImagePyramid.Tests.csproj", "{C8E5D3F1-2A47-4B89-AD16-7F3E2C1B9A5D}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "SkiaSharp.Extended.UI.Blazor", "source\SkiaSharp.Extended.UI.Blazor\SkiaSharp.Extended.UI.Blazor.csproj", "{AB88B47A-1946-40E9-8418-0FD42D031690}"
+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
+		{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
 		{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}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{B7E4C45C-5CAB-444E-B2D3-294151544256}.Debug|x64.Build.0 = Debug|Any CPU
+		{B7E4C45C-5CAB-444E-B2D3-294151544256}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{B7E4C45C-5CAB-444E-B2D3-294151544256}.Debug|x86.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
+		{B7E4C45C-5CAB-444E-B2D3-294151544256}.Release|x64.ActiveCfg = Release|Any CPU
+		{B7E4C45C-5CAB-444E-B2D3-294151544256}.Release|x64.Build.0 = Release|Any CPU
+		{B7E4C45C-5CAB-444E-B2D3-294151544256}.Release|x86.ActiveCfg = Release|Any CPU
+		{B7E4C45C-5CAB-444E-B2D3-294151544256}.Release|x86.Build.0 = Release|Any CPU
+		{C8E5D3F1-2A47-4B89-AD16-7F3E2C1B9A5D}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{C8E5D3F1-2A47-4B89-AD16-7F3E2C1B9A5D}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{C8E5D3F1-2A47-4B89-AD16-7F3E2C1B9A5D}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{C8E5D3F1-2A47-4B89-AD16-7F3E2C1B9A5D}.Debug|x64.Build.0 = Debug|Any CPU
+		{C8E5D3F1-2A47-4B89-AD16-7F3E2C1B9A5D}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{C8E5D3F1-2A47-4B89-AD16-7F3E2C1B9A5D}.Debug|x86.Build.0 = Debug|Any CPU
+		{C8E5D3F1-2A47-4B89-AD16-7F3E2C1B9A5D}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{C8E5D3F1-2A47-4B89-AD16-7F3E2C1B9A5D}.Release|Any CPU.Build.0 = Release|Any CPU
+		{C8E5D3F1-2A47-4B89-AD16-7F3E2C1B9A5D}.Release|x64.ActiveCfg = Release|Any CPU
+		{C8E5D3F1-2A47-4B89-AD16-7F3E2C1B9A5D}.Release|x64.Build.0 = Release|Any CPU
+		{C8E5D3F1-2A47-4B89-AD16-7F3E2C1B9A5D}.Release|x86.ActiveCfg = Release|Any CPU
+		{C8E5D3F1-2A47-4B89-AD16-7F3E2C1B9A5D}.Release|x86.Build.0 = Release|Any CPU
+		{AB88B47A-1946-40E9-8418-0FD42D031690}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{AB88B47A-1946-40E9-8418-0FD42D031690}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{AB88B47A-1946-40E9-8418-0FD42D031690}.Debug|x64.ActiveCfg = Debug|Any CPU
+		{AB88B47A-1946-40E9-8418-0FD42D031690}.Debug|x64.Build.0 = Debug|Any CPU
+		{AB88B47A-1946-40E9-8418-0FD42D031690}.Debug|x86.ActiveCfg = Debug|Any CPU
+		{AB88B47A-1946-40E9-8418-0FD42D031690}.Debug|x86.Build.0 = Debug|Any CPU
+		{AB88B47A-1946-40E9-8418-0FD42D031690}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{AB88B47A-1946-40E9-8418-0FD42D031690}.Release|Any CPU.Build.0 = Release|Any CPU
+		{AB88B47A-1946-40E9-8418-0FD42D031690}.Release|x64.ActiveCfg = Release|Any CPU
+		{AB88B47A-1946-40E9-8418-0FD42D031690}.Release|x64.Build.0 = Release|Any CPU
+		{AB88B47A-1946-40E9-8418-0FD42D031690}.Release|x86.ActiveCfg = Release|Any CPU
+		{AB88B47A-1946-40E9-8418-0FD42D031690}.Release|x86.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -64,6 +144,8 @@ 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}
+		{C8E5D3F1-2A47-4B89-AD16-7F3E2C1B9A5D} = {5555F827-12DF-4D15-BF07-3A720FC2EF3F}
+		{AB88B47A-1946-40E9-8418-0FD42D031690} = {5DEC7961-7CE3-44D7-A7FC-6185BA2D37FE}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {08D78153-5DD7-4C52-A348-46AA448B2CFC}

docs/docs/image-pyramid/blazor.md

@@ -0,0 +1,165 @@
+# Image Pyramid for Blazor
+
+Use `SKImagePyramidController` with a plain `SKCanvasView` in Blazor WebAssembly to render Image Pyramid images. There is no custom component — the page wires the services directly to the canvas, giving you full control over layout, interaction, and lifecycle.
+
+## Quick Start
+
+```razor
+@page "/deepzoom"
+@implements IAsyncDisposable
+@inject HttpClient Http
+@using SkiaSharp.Extended
+
+<SKCanvasView @ref="_canvas"
+              OnPaintSurface="OnPaintSurface"
+              style="width: 100%; height: 600px; touch-action: none;" />
+
+@code {
+    private SKCanvasView? _canvas;
+    private SKImagePyramidController? _controller;
+    private readonly SKImagePyramidRenderer _renderer = new();
+
+    protected override async Task OnAfterRenderAsync(bool firstRender)
+    {
+        if (!firstRender) return;
+
+        _controller = new SKImagePyramidController();
+        _controller.InvalidateRequired += OnInvalidateRequired;
+
+        var xml     = await Http.GetStringAsync("deepzoom/image.dzi");
+        var baseUrl = new Uri(Http.BaseAddress!, "deepzoom/image_files/").ToString();
+        var source  = SKImagePyramidDziSource.Parse(xml, baseUrl);
+
+        _controller.Load(source, new SKTieredTileProvider(new SKHttpTileFetcher()));
+    }
+
+    private void OnPaintSurface(SKPaintSurfaceEventArgs e)
+    {
+        if (_controller == null) return;
+        _controller.SetControlSize(e.Info.Width, e.Info.Height);
+        _controller.Update();
+        _renderer.Canvas = e.Surface.Canvas;
+        _controller.Render(_renderer);
+    }
+
+    private void OnInvalidateRequired(object? sender, EventArgs e)
+        => InvokeAsync(() => _canvas?.Invalidate());
+
+    public async ValueTask DisposeAsync()
+    {
+        if (_controller != null)
+        {
+            _controller.InvalidateRequired -= OnInvalidateRequired;
+            _controller.Dispose();
+        }
+    }
+}
+```
+
+## Serving Tile Assets
+
+Place `.dzi` and tile folder under `wwwroot`. In the project file, mark them as content:
+
+```xml
+<ItemGroup>
+    <Content Include="wwwroot\deepzoom\image.dzi" />
+    <Content Include="wwwroot\deepzoom\image_files\**" />
+</ItemGroup>
+```
+
+The `SKTieredTileProvider` with `SKHttpTileFetcher` fetches each tile via `HttpClient`; tile URLs are constructed automatically from the base URL you pass to `SKImagePyramidDziSource.Parse`.
+
+## Pan and Zoom
+
+Wire mouse and touch events to the controller's navigation methods:
+
+```razor
+<SKCanvasView @ref="_canvas"
+              OnPaintSurface="OnPaintSurface"
+              @onmousedown="OnMouseDown"
+              @onmousemove="OnMouseMove"
+              @onmouseup="OnMouseUp"
+              @onwheel="OnWheel"
+              style="width: 100%; height: 600px; touch-action: none;" />
+
+@code {
+    private bool _dragging;
+    private double _lastX, _lastY;
+
+    private void OnMouseDown(MouseEventArgs e)
+    {
+        _dragging = true;
+        _lastX = e.ClientX;
+        _lastY = e.ClientY;
+    }
+
+    private void OnMouseMove(MouseEventArgs e)
+    {
+        if (!_dragging || _controller == null) return;
+        _controller.Pan(e.ClientX - _lastX, e.ClientY - _lastY);
+        _lastX = e.ClientX;
+        _lastY = e.ClientY;
+        _canvas?.Invalidate();
+    }
+
+    private void OnMouseUp(MouseEventArgs e) => _dragging = false;
+
+    private void OnWheel(WheelEventArgs e)
+    {
+        if (_controller == null) return;
+        double factor = e.DeltaY < 0 ? 1.15 : 1.0 / 1.15;
+        _controller.ZoomAboutScreenPoint(factor, e.OffsetX, e.OffsetY);
+        _canvas?.Invalidate();
+    }
+}
+```
+
+## Loading a DZC Collection
+
+```csharp
+var xml = await Http.GetStringAsync("collection.dzc");
+var collection = SKImagePyramidDziCollectionSource.Parse(xml);
+collection.TilesBaseUri = Http.BaseAddress!.ToString();
+_controller!.Load(collection, new SKTieredTileProvider(new SKHttpTileFetcher()));
+```
+
+## Custom Provider
+
+Pass a custom `ISKImagePyramidTileProvider` to the controller's `Load()` method for advanced scenarios:
+
+```csharp
+// With disk cache (persists across Blazor restarts via OPFS or service worker)
+controller.Load(source, new SKTieredTileProvider(
+    new SKHttpTileFetcher(),
+    new SKDiskTileCacheStore("/cache/tiles", expiry: TimeSpan.FromDays(7))));
+```
+
+See the [Tile Providers](fetching.md) docs for implementing browser storage tiers, delay wrappers, and other custom strategies.
+
+## Canvas Resize
+
+When the Blazor page resizes, `SetControlSize` automatically picks up the new dimensions on the next paint. If you want to trigger a reset to fit the image after a resize:
+
+```csharp
+// In a JS interop resize callback:
+[JSInvokable]
+public void OnCanvasResized()
+{
+    _controller?.ResetView();
+    InvokeAsync(() => _canvas?.Invalidate());
+}
+```
+
+## Rendering Behaviour
+
+- **Fit and center**: On load the controller calls `ResetView()` — the full image is visible, centered horizontally and vertically, with aspect ratio preserved. No cropping or distortion.
+- **LOD blending**: While high-resolution tiles are in-flight, lower-resolution parent tiles are upscaled and composited as placeholders.
+- **Idle detection**: `controller.IsIdle` is `true` when no tiles are loading. You can pause periodic repaints when the view is idle.
+
+## Related
+
+- [Image Pyramid overview](index.md)
+- [Controller & Viewport](controller.md)
+- [Tile Fetching](fetching.md)
+- [Caching](caching.md)
+- [Image Pyramid for MAUI](maui.md)