Skip to content

Update thread_safe_apis.rst to mention don't call certain rendering functions on other threads #8749

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jan 24, 2024
Merged

Update thread_safe_apis.rst to mention don't call certain rendering functions on other threads #8749

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
1790db8
Update thread_safe_apis.rst to mention don't call certain rendering f…
jsjtxietian Jan 11, 2024
3150af6
Update tutorials/performance/thread_safe_apis.rst
mhilbrunner Jan 24, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions tutorials/performance/thread_safe_apis.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -60,6 +60,10 @@ To make rendering thread-safe, set the **Rendering > Driver > Thread Model** pro
Note that the Multi-Threaded thread model has several known bugs, so it may not be usable
in all scenarios.

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

GDScript arrays, dictionaries
-----------------------------

Expand Down