godotengine/godot-docs
1
0
Fork 0
mirror of https://github.com/godotengine/godot-docs.git synced 2026-01-05 22:09:56 +03:00
Code Issues Packages Projects Releases Wiki Activity

Small formating fixes for the new Thread API page

Browse Source
This commit is contained in:
Michael Alexsander Silva Dias
2018-08-01 16:07:19 -03:00
parent 72e4322148
commit c28f716f3c
1 changed files with 10 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
tutorials/threads/thread_safe_apis.rst
View File

@@ -1,7 +1,7 @@
.. _doc_thread_safe_apis:
Thread Safe APIs
=============
================
Threads
-------
@@ -25,22 +25,22 @@ Interacting with the active scene tree is **NOT** thread safe. Make sure to use
::
# unsafe:
node.add_child(child_node)
# safe:
node.call_deferred("add_child",child_node)
# Unsafe:
node.add_child(child_node)
# Safe:
node.call_deferred("add_child", child_node)
However, creating scene chunks (nodes in tree arrangement) outside the active tree is fine. This way, parts of a scene can be built or instantiated in a thread, then added in the main thread:
::
var enemy_scene = load("res://enemy_scene.scn").instance()
var enemy = enemy_scene.instance()
enemy.add_child(weapon) #set a weapon
world.call_deferred("add_child",enemy)
var enemy_scene = load("res://enemy_scene.scn").instance()
var enemy = enemy_scene.instance()
enemy.add_child(weapon) # Set a weapon.
world.call_deferred("add_child", enemy)
GDScript Arrays, Dictionaries:
-------------------------------
------------------------------
In GDScript, reading and writing elements from multiple threads is ok, but anything that changes the container size (resizing, adding or removing elements) requires locking a mutex.