Made clear behavior in RenderTargetBitmap.CreateDrawingContext optional

api/Avalonia.nupkg.xml

@@ -1,6 +1,12 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- https://learn.microsoft.com/en-us/dotnet/fundamentals/package-validation/diagnostic-ids -->
 <Suppressions xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
+  <Suppression>
+    <DiagnosticId>CP0002</DiagnosticId>
+    <Target>M:Avalonia.Media.Imaging.RenderTargetBitmap.CreateDrawingContext</Target>
+    <Left>baseline/netstandard2.0/Avalonia.Base.dll</Left>
+    <Right>target/netstandard2.0/Avalonia.Base.dll</Right>
+  </Suppression>
   <Suppression>
     <DiagnosticId>CP0006</DiagnosticId>
     <Target>P:Avalonia.Rendering.Composition.ICompositionGpuImportedObject.ImportCompleted</Target>

src/Avalonia.Base/Media/Imaging/RenderTargetBitmap.cs

@@ -62,10 +62,16 @@ private static IRenderTargetBitmapImpl CreateImpl(PixelSize size, Vector dpi)
             return factory.CreateRenderTargetBitmap(size, dpi);
         }
 
-        public DrawingContext CreateDrawingContext()
+        /// <summary>
+        /// Creates a <see cref="DrawingContext"/> for drawing to the <see cref="RenderTargetBitmap"/>.
+        /// </summary>
+        /// <param name="clear">Indicates if the image should be cleared.</param>
+        /// <returns>The drawing context.</returns>
+        public DrawingContext CreateDrawingContext(bool clear = true)
         {
             var platform = PlatformImpl.Item.CreateDrawingContext();
-            platform.Clear(Colors.Transparent);
+            if(clear)
+                platform.Clear(Colors.Transparent);
             return new PlatformDrawingContext(platform);
         }