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
set_custom_interpolator(interpolator_method: Callable) |
|
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.