Andrew/redot-engine
1
0
Fork 0
mirror of https://github.com/Redot-Engine/redot-engine.git synced 2025-12-06 15:21:56 -05:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #98787 from Meorge/tween-docs-stop

Browse Source 
Update docs for `Tween.stop` to clarify behavior
This commit is contained in:
Thaddeus Crews
2024-11-12 09:28:06 -06:00
parent 316293ecc2 0304f8fd57
commit 0f95061092
1 changed files with 16 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
doc/classes/Tween.xml
View File

@@ -279,6 +279,22 @@
<return type="void" /> <return type="void" />
<description> <description>
Stops the tweening and resets the [Tween] to its initial state. This will not remove any appended [Tweener]s. Stops the tweening and resets the [Tween] to its initial state. This will not remove any appended [Tweener]s.
[b]Note:[/b] This does [i]not[/i] reset targets of [PropertyTweener]s to their values when the [Tween] first started.
[codeblock]
var tween = create_tween()
# Will move from 0 to 500 over 1 second.
position.x = 0.0
tween.tween_property(self, "position:x", 500, 1.0)
# Will be at (about) 250 when the timer finishes.
await get_tree().create_timer(0.5).timeout
# Will now move from (about) 250 to 500 over 1 second,
# thus at half the speed as before.
tween.stop()
tween.play()
[/codeblock]
[b]Note:[/b] If a Tween is stopped and not bound to any node, it will exist indefinitely until manually started or invalidated. If you lose a reference to such Tween, you can retrieve it using [method SceneTree.get_processed_tweens]. [b]Note:[/b] If a Tween is stopped and not bound to any node, it will exist indefinitely until manually started or invalidated. If you lose a reference to such Tween, you can retrieve it using [method SceneTree.get_processed_tweens].
</description> </description>
</method> </method>