Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

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 的默认过渡类型。