godotengine/godot
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Allow Node.create_tween() outside SceneTree

Browse Source
This commit is contained in:
kobewi 2024-01-29 14:10:07 +01:00
parent fa48a51183
commit 0de8a736da
2 changed files with 11 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
doc/classes/Node.xml
View File

@ -205,7 +205,7 @@
<method name="create_tween"> <method name="create_tween">
<return type="Tween" /> <return type="Tween" />
<description> <description>
Creates a new [Tween] and binds it to this node. Fails if the node is not inside the tree. Creates a new [Tween] and binds it to this node.
This is the equivalent of doing: This is the equivalent of doing:
[codeblocks] [codeblocks]
[gdscript] [gdscript]
@ -215,7 +215,8 @@
GetTree().CreateTween().BindNode(this); GetTree().CreateTween().BindNode(this);
[/csharp] [/csharp]
[/codeblocks] [/codeblocks]
The Tween will start automatically on the next process frame or physics frame (depending on [enum Tween.TweenProcessMode]). The Tween will start automatically on the next process frame or physics frame (depending on [enum Tween.TweenProcessMode]). See [method Tween.bind_node] for more info on Tweens bound to nodes.
[b]Note:[/b] The method can still be used when the node is not inside [SceneTree]. It can fail in an unlikely case of using a custom [MainLoop].
</description> </description>
</method> </method>
<method name="duplicate" qualifiers="const"> <method name="duplicate" qualifiers="const">

10
scene/main/node.cpp
View File

@ -2326,8 +2326,14 @@ void Node::_propagate_replace_owner(Node *p_owner, Node *p_by_owner) {
Ref<Tween> Node::create_tween() { Ref<Tween> Node::create_tween() {
ERR_THREAD_GUARD_V(Ref<Tween>()); ERR_THREAD_GUARD_V(Ref<Tween>());
ERR_FAIL_NULL_V_MSG(data.tree, nullptr, "Can't create Tween when not inside scene tree.");
Ref<Tween> tween = get_tree()->create_tween(); SceneTree *tree = data.tree;
if (!tree) {
tree = SceneTree::get_singleton();
}
ERR_FAIL_NULL_V_MSG(tree, Ref<Tween>(), "No available SceneTree to create the Tween.");
Ref<Tween> tween = tree->create_tween();
tween->bind_node(this); tween->bind_node(this);
return tween; return tween;
} }