Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

PropertyTweener

继承： Tweener < RefCounted < Object

随时间对 Object 的属性进行插值。

描述

PropertyTweener 用于为对象的属性进行插值。详细的用法见 Tween.tween_property。

注意：Tween.tween_property 是创建 PropertyTweener 的唯一正确方法。任何手动创建的 PropertyTweener 都将无法正常运行。

方法

PropertyTweener	as_relative ( )
PropertyTweener	from ( Variant value )
PropertyTweener	from_current ( )
PropertyTweener	set_delay ( float delay )
PropertyTweener	set_ease ( EaseType ease )
PropertyTweener	set_trans ( TransitionType trans )

---

方法说明

PropertyTweener as_relative ( )

调用时，最终值将用作相对值。

示例：

var tween = get_tree().create_tween()
tween.tween_property(self, "position", Vector2.RIGHT * 100, 1).as_relative() # 该节点将向右移动 100 个像素

---

PropertyTweener from ( Variant value )

设置该 PropertyTweener 的自定义初始值。

示例：

var tween = get_tree().create_tween()
tween.tween_property(self, "position", Vector2(200, 100), 1).from(Vector2(100, 100)) # 这会将该节点从位置 (100, 100) 移动到 (200, 100)

---

PropertyTweener from_current ( )

让该 PropertyTweener 使用当前属性值作为起点（即创建这个 PropertyTweener 时的值）。与使用当前值调用 from 等价。以下两种调用方法效果相同：

tween.tween_property(self, "position", Vector2(200, 100), 1).from(position)
tween.tween_property(self, "position", Vector2(200, 100), 1).from_current()

---

PropertyTweener set_delay ( float delay )

设置该 PropertyTweener 开始插值的时间，单位为秒。默认无延迟。

---

PropertyTweener set_ease ( EaseType ease )

设置所使用的缓动类型 EaseType。如果没有设置，则使用包含这个 Tweener 的 Tween 的默认缓动类型。

---

PropertyTweener set_trans ( TransitionType trans )

设置所使用的过渡类型 TransitionType。如果没有设置，则使用包含这个 Tweener 的 Tween 的默认过渡类型。