From f1703dd784becf63d55606b51b852e854dae8ea3 Mon Sep 17 00:00:00 2001
From: Tom Edwards <109803929+TomEdwardsEnscape@users.noreply.github.com>
Date: Tue, 6 Jan 2026 14:40:21 +0100
Subject: [PATCH] Add `DrawingImage.Viewbox` (#18913)

* Added DrawingImage.Frame: a rectangular region of `Drawing`, in device independent pixels, to display when rendering the image

* Renamed Frame to Viewbox
Added test
---
 src/Avalonia.Base/Media/DrawingImage.cs       |  39 +++++++++++++++---
 .../Media/ImageDrawingTests.cs                |  27 +++++++++++-
 .../ImageDrawing_Viewbox.expected.png         | Bin 0 -> 8985 bytes
 3 files changed, 59 insertions(+), 7 deletions(-)
 create mode 100644 tests/TestFiles/Skia/Media/ImageDrawing/ImageDrawing_Viewbox.expected.png

diff --git a/src/Avalonia.Base/Media/DrawingImage.cs b/src/Avalonia.Base/Media/DrawingImage.cs
index c83e8eb6ee..7949eaa351 100644
--- a/src/Avalonia.Base/Media/DrawingImage.cs
+++ b/src/Avalonia.Base/Media/DrawingImage.cs
@@ -22,6 +22,12 @@ namespace Avalonia.Media
         public static readonly StyledProperty<Drawing?> DrawingProperty =
             AvaloniaProperty.Register<DrawingImage, Drawing?>(nameof(Drawing));
 
+        /// <summary>
+        /// Defines the <see cref="Viewbox"/> property.
+        /// </summary>
+        public static readonly StyledProperty<Rect?> ViewboxProperty =
+            AvaloniaProperty.Register<DrawingImage, Rect?>(nameof(Viewbox));
+
         /// <inheritdoc/>
         public event EventHandler? Invalidated;
 
@@ -35,8 +41,25 @@ namespace Avalonia.Media
             set => SetValue(DrawingProperty, value);
         }
 
+        /// <summary>
+        /// Gets or sets a rectangular region of <see cref="Drawing"/>, in device independent pixels, to display 
+        /// when rendering this image.
+        /// </summary>
+        /// <remarks>
+        /// This value can be used to display only part of <see cref="Drawing"/>, or to surround it with empty 
+        /// space. If null, <see cref="Drawing"/> will provide its own viewbox.
+        /// </remarks>
+        /// <seealso cref="Drawing.GetBounds"/>
+        public Rect? Viewbox
+        {
+            get => GetValue(ViewboxProperty);
+            set => SetValue(ViewboxProperty, value);
+        }
+
         /// <inheritdoc/>
-        public Size Size => Drawing?.GetBounds().Size ?? default;
+        public Size Size => GetBounds().Size;
+
+        private Rect GetBounds() => Viewbox ?? Drawing?.GetBounds() ?? default;
 
         /// <inheritdoc/>
         void IImage.Draw(
@@ -44,14 +67,18 @@ namespace Avalonia.Media
             Rect sourceRect,
             Rect destRect)
         {
-            var drawing = Drawing;
+            if (Drawing is not { } drawing || sourceRect.Size == default || destRect.Size == default)
+            {
+                return;
+            }
+
+            var bounds = GetBounds();
 
-            if (drawing == null)
+            if (bounds.Size == default)
             {
                 return;
             }
 
-            var bounds = drawing.GetBounds();
             var scale = Matrix.CreateScale(
                 destRect.Width / sourceRect.Width,
                 destRect.Height / sourceRect.Height);
@@ -62,7 +89,7 @@ namespace Avalonia.Media
             using (context.PushClip(destRect))
             using (context.PushTransform(translate * scale))
             {
-                Drawing?.Draw(context);
+                drawing.Draw(context);
             }
         }
 
@@ -71,7 +98,7 @@ namespace Avalonia.Media
         {
             base.OnPropertyChanged(change);
 
-            if (change.Property == DrawingProperty)
+            if (change.Property == DrawingProperty || change.Property == ViewboxProperty)
             {
                 RaiseInvalidated(EventArgs.Empty);
             }
diff --git a/tests/Avalonia.RenderTests/Media/ImageDrawingTests.cs b/tests/Avalonia.RenderTests/Media/ImageDrawingTests.cs
index 4294e3874d..f1e9a12289 100644
--- a/tests/Avalonia.RenderTests/Media/ImageDrawingTests.cs
+++ b/tests/Avalonia.RenderTests/Media/ImageDrawingTests.cs
@@ -45,6 +45,31 @@ namespace Avalonia.Skia.RenderTests
             CompareImages();
         }
 
+        [Fact]
+        public async Task ImageDrawing_Viewbox()
+        {
+            Decorator target = new Decorator
+            {
+                Width = 200,
+                Height = 200,
+                Child = new Image
+                {
+                    Source = new DrawingImage
+                    {
+                        Viewbox = new Rect(48, 37, 100, 125),
+                        Drawing = new ImageDrawing
+                        {
+                            ImageSource = new Bitmap(BitmapPath),
+                            Rect = new Rect(0, 0, 200, 200),
+                        }
+                    }
+                }
+            };
+
+            await RenderToFile(target);
+            CompareImages();
+        }
+
         [Fact]
         public async Task ImageDrawing_BottomRight()
         {
@@ -85,7 +110,7 @@ namespace Avalonia.Skia.RenderTests
         {
             var target = new Border
             {
-                Width = 400, 
+                Width = 400,
                 Height = 400,
                 Child = new DrawingBrushTransformTest()
             };
diff --git a/tests/TestFiles/Skia/Media/ImageDrawing/ImageDrawing_Viewbox.expected.png b/tests/TestFiles/Skia/Media/ImageDrawing/ImageDrawing_Viewbox.expected.png
new file mode 100644
index 0000000000000000000000000000000000000000..c2abd87bd2d10d029f8a836483ce4df8f9055b92
GIT binary patch
literal 8985
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

literal 0
HcmV?d00001