Pārlūkot izejas kodu

Document low performance when using `SurfaceTool.append_from()` in thread

(cherry picked from commit f39375d315dc67e53ecdeb5964ffad59959c888f)
Hugo Locurcio 3 gadi atpakaļ
vecāks
revīzija
a49e3bb449
1 mainītis faili ar 1 papildinājumiem un 0 dzēšanām
  1. 1 0
      doc/classes/SurfaceTool.xml

+ 1 - 0
doc/classes/SurfaceTool.xml

@@ -113,6 +113,7 @@
 			<argument index="2" name="transform" type="Transform" />
 			<description>
 				Append vertices from a given [Mesh] surface onto the current vertex array with specified [Transform].
+				[b]Note:[/b] Using [method append_from] on a [Thread] is much slower as the GPU must communicate data back to the CPU, while also causing the main thread to stall (as OpenGL is not thread-safe). Consider requesting a copy of the mesh, converting it to an [ArrayMesh] and adding vertices manually instead.
 			</description>
 		</method>
 		<method name="begin">