Skip to content

Commit c6abcba

Browse files
jsjtxietianmhilbrunnerAThousandShips
authored
Update thread_safe_apis.rst to mention don't call certain rendering functions on other threads (godotengine#8749)
* Update thread_safe_apis.rst to mention don't call certain rendering functions on other threads --------- Co-authored-by: Max Hilbrunner <[email protected]> Co-authored-by: A Thousand Ships <[email protected]>
1 parent aab5dc7 commit c6abcba

File tree

1 file changed

+4
-0
lines changed

1 file changed

+4
-0
lines changed

tutorials/performance/thread_safe_apis.rst

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -60,6 +60,10 @@ To make rendering thread-safe, set the **Rendering > Driver > Thread Model** pro
6060
Note that the Multi-Threaded thread model has several known bugs, so it may not be usable
6161
in all scenarios.
6262

63+
You should avoid calling functions involving direct interaction with the GPU on other threads, such as creating new textures
64+
or modifying and retrieving image data, these operations can lead to performance stalls because they require synchronization
65+
with the :ref:`RenderingServer<class_RenderingServer>`, as data needs to be transmitted to or updated on the GPU.
66+
6367
GDScript arrays, dictionaries
6468
-----------------------------
6569

0 commit comments

Comments
 (0)