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

Eredita: Tweener < RefCounted < Object

Interpola una proprietà di un Object nel corso del tempo.

Descrizione

PropertyTweener serve per interpolare una proprietà in un oggetto. Vedi Tween.tween_property() per ulteriori informazioni sull'utilizzo.

Il tweener terminerà automaticamente se l'oggetto di destinazione viene liberato.

Nota: Tween.tween_property() è l'unico modo corretto per creare PropertyTweener. Qualsiasi PropertyTweener creato manualmente non funzionerà correttamente.

Metodi

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)

Descrizioni dei metodi

PropertyTweener as_relative() 🔗

Quando viene chiamato, il valore finale verrà invece utilizzato come valore relativo.

Esempio: Sposta il nodo di 100 pixel verso destra.

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

Imposta un valore iniziale personalizzato per il PropertyTweener.

Esempio: Sposta il nodo dalla posizione (100, 100) a (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(this, "position", new Vector2(200.0f, 100.0f), 1.0f).From(new Vector2(100.0f, 100.0f));

PropertyTweener from_current() 🔗

Fa sì che il PropertyTweener utilizzi il valore della proprietà attuale (ad esempio al momento della creazione di questo PropertyTweener) come punto di partenza. Ciò equivale a usare from() con il valore attuale. Le due chiamate seguenti daranno lo stesso risultato:

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

Permette di interpolare il valore con una funzione di allentamento personalizzata. Il interpolator_method fornito sarà chiamato con un valore compreso tra 0.0 e 1.0 e dovrebbe restituire un valore compreso nello stesso intervallo (i valori al di fuori dell'intervallo possono essere utilizzati per oltrepassarlo). Il valore restituito dal metodo è quindi utilizzato per l'interpolazione tra il valore iniziale e quello finale. Nota che il parametro passato al metodo è comunque soggetto all'allentamento del tweener stesso.

@export var curve: Curve

func _ready():
    var tween = create_tween()
    # Interpola il valore attraverso una curva personalizzata.
    tween.tween_property(self, "position:x", 300, 1).as_relative().set_custom_interpolator(tween_curve)

func tween_curve(v):
    return curve.sample_baked(v)

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

public override void _Ready()
{
    Tween tween = CreateTween();
    // Interpola il valore attraverso una curva personalizzata.
    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) 🔗

Imposta il tempo in secondi dopo il quale il PropertyTweener inizierà l'interpolazione. Per impostazione predefinita, non c'è alcun ritardo.

PropertyTweener set_ease(ease: EaseType) 🔗

Imposta il tipo di allentamento utilizzato, da EaseType. Se non impostato, viene utilizzato l'allentamento predefinito dal Tween che contiene questo Tweener.

PropertyTweener set_trans(trans: TransitionType) 🔗

Imposta il tipo di transizione utilizzata, da TransitionType. Se non impostata, viene utilizzata la transizione predefinita dal Tween che contiene questo Tweener.