From 92fa3e076fa5442ef410996509eb7514d3372da1 Mon Sep 17 00:00:00 2001
From: Hugo Locurcio <hugo.locurcio@hugo.pro>
Date: Sun, 16 Feb 2020 23:43:37 +0100
Subject: [PATCH] Document known performance issues with Sprite3D

See https://github.com/godotengine/godot/issues/20855.
---
 doc/classes/Sprite3D.xml | 1 +
 1 file changed, 1 insertion(+)

diff --git a/doc/classes/Sprite3D.xml b/doc/classes/Sprite3D.xml
index 4c123997617..63958eeb7b2 100644
--- a/doc/classes/Sprite3D.xml
+++ b/doc/classes/Sprite3D.xml
@@ -5,6 +5,7 @@
 	</brief_description>
 	<description>
 		A node that displays a 2D texture in a 3D environment. The texture displayed can be a region from a larger atlas texture, or a frame from a sprite sheet animation.
+		[b]Note:[/b] There are [url=https://github.com/godotengine/godot/issues/20855]known performance issues[/url] when using [Sprite3D]. Consider using a [MeshInstance] with a [QuadMesh] as the mesh instead. You can still have billboarding by enabling billboard properties in the QuadMesh's [StandardMaterial3D].
 	</description>
 	<tutorials>
 	</tutorials>