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.