From ea2ea58a28fefe9514b076fa96310cbe5d70a48f Mon Sep 17 00:00:00 2001
From: David Rautert <davidrautert@gmail.com>
Date: Sat, 13 Jul 2024 16:11:20 -0400
Subject: [PATCH] Add note about alpha channels blending to `Image.blit_rect`

---
 doc/classes/Image.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doc/classes/Image.xml b/doc/classes/Image.xml
index 9b71a8c37f4..4421318be70 100644
--- a/doc/classes/Image.xml
+++ b/doc/classes/Image.xml
@@ -48,6 +48,7 @@
 			<param index="2" name="dst" type="Vector2i" />
 			<description>
 				Copies [param src_rect] from [param src] image to this image at coordinates [param dst], clipped accordingly to both image bounds. This image and [param src] image [b]must[/b] have the same format. [param src_rect] with non-positive size is treated as empty.
+				[b]Note:[/b] The alpha channel data in [param src] will overwrite the corresponding data in this image at the target position. To blend alpha channels, use [method blend_rect] instead.
 			</description>
 		</method>
 		<method name="blit_rect_mask">