From f9c07893260959f233960a1e7c0ba2b91be3d2b3 Mon Sep 17 00:00:00 2001
From: syzygy <nunezja@oregonstate.edu>
Date: Mon, 2 Jun 2025 15:35:32 -0600
Subject: [PATCH] Clarify offest.y behavior for Sprite2D vs Sprite3D

---
 doc/classes/Sprite2D.xml     | 1 +
 doc/classes/SpriteBase3D.xml | 1 +
 2 files changed, 2 insertions(+)

diff --git a/doc/classes/Sprite2D.xml b/doc/classes/Sprite2D.xml
index 239c4dcf095..538386eaa6f 100644
--- a/doc/classes/Sprite2D.xml
+++ b/doc/classes/Sprite2D.xml
@@ -71,6 +71,7 @@
 		</member>
 		<member name="offset" type="Vector2" setter="set_offset" getter="get_offset" default="Vector2(0, 0)">
 			The texture's drawing offset.
+			[b]Note:[/b] When you increase [member offset].y in Sprite2D, the sprite moves downward on screen (i.e., +Y is down).
 		</member>
 		<member name="region_enabled" type="bool" setter="set_region_enabled" getter="is_region_enabled" default="false">
 			If [code]true[/code], texture is cut from a larger atlas texture. See [member region_rect].
diff --git a/doc/classes/SpriteBase3D.xml b/doc/classes/SpriteBase3D.xml
index b2b954ec93c..791699fa4c0 100644
--- a/doc/classes/SpriteBase3D.xml
+++ b/doc/classes/SpriteBase3D.xml
@@ -85,6 +85,7 @@
 		</member>
 		<member name="offset" type="Vector2" setter="set_offset" getter="get_offset" default="Vector2(0, 0)">
 			The texture's drawing offset.
+			[b]Note:[/b] When you increase [member offset].y in Sprite3D, the sprite moves upward in world space (i.e., +Y is up).
 		</member>
 		<member name="pixel_size" type="float" setter="set_pixel_size" getter="get_pixel_size" default="0.01">
 			The size of one pixel's width on the sprite to scale it in 3D.