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(value: Variant)
PropertyTweener	from_current()
PropertyTweener	set_custom_interpolator(interpolator_method: Callable)
PropertyTweener	set_delay(delay: float)
PropertyTweener	set_ease(ease: EaseType)
PropertyTweener	set_trans(trans: TransitionType)

Описи методів

PropertyTweener as_relative() 🔗

Під час виклику кінцеве значення використовуватиметься як відносне.

Приклад: Перемістіть вузол на 100 пікселів праворуч.

var tween = get_tree().create_tween()
tween.tween_property(self, "position", Vector2.RIGHT * 100, 1).as_relative()

Tween tween = GetTree().CreateTween();
tween.TweenProperty(this, "position", Vector2.Right * 100.0f, 1.0f).AsRelative();

PropertyTweener from(value: Variant) 🔗

Встановлює спеціальне початкове значення для PropertyTweener.

Приклад: Перемістіть вузол із позиції (100, 100) до (200, 100).

var tween = get_tree().create_tween()
tween.tween_property(self, "position", Vector2(200, 100), 1).from(Vector2(100, 100))

Tween tween = GetTree().CreateTween();
tween.TweenProperty(self, "position", new Vector2(200.0f, 100.0f), 1.0f).From(new Vector2(100.0f, 100.0f));

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()

tween.TweenProperty(this, "position", new Vector2(200.0f, 100.0f), 1.0f).From(Position);
tween.TweenProperty(this, "position", new Vector2(200.0f, 100.0f), 1.0f).FromCurrent();

PropertyTweener set_custom_interpolator(interpolator_method: Callable) 🔗

Дозволяє інтерполювати значення за допомогою спеціальної функції спрощення. Наданий interpolator_method буде викликано зі значенням у діапазоні від 0.0 до 1.0 і, як очікується, поверне значення в тому самому діапазоні (значення за межами діапазону можна використовувати для перевищення). Повернене значення методу потім використовується для інтерполяції між початковим і кінцевим значенням. Зауважте, що параметр, переданий у метод, все ще підлягає власному ослабленню твінера.

@export var curve: Curve

func _ready():
    var tween = create_tween()
    # Інтерполювати значення за допомогою спеціальної кривої.
    tween.tween_property(self, "position:x", 300, 1).as_relative().set_custom_interpolator(tween_curve)

func tween_curve(v):
    повернути curve.sample_baked(v)

[Export]
public Curve Curve { get; set; }

public override void _Ready()
{
    Анімація анімації = CreateTween();
    // Інтерполяція значення за допомогою спеціальної кривої.
    Callable tweenCurveCallable = Callable.From<float, float>(TweenCurve);
    tween.TweenProperty(this, "position:x", 300.0f, 1.0f).AsRelative().SetCustomInterpolator(tweenCurveCallable);
}

private float TweenCurve(float value)
{
    return Curve.SampleBaked(value);
}

PropertyTweener set_delay(delay: float) 🔗

Налаштовує час за секундами, після чого буде переповнено PropertyTweener. За замовчуванням немає затримки.

PropertyTweener set_ease(ease: EaseType) 🔗

Встановлює тип використовуваного зондування з Tween. EaseType. Якщо не встановлено, що зменшення за замовчуванням використовується з Tween, який містить цей Tweener.

PropertyTweener set_trans(trans: TransitionType) 🔗

Встановлює тип використовуваного переходу з TransitionType. Якщо не встановлено, перехід за замовчуванням використовується з Tween, який містить цей Tweener.