Tween
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
Das Tween -Objekt steuert die Wiedergabe einer Interpolation.Die Erstellung und Konfiguration eines Tween wird mit der TweenService:Create()-Funktion durchgeführt; Instance.new() kann für dieses spezielle Objekt nicht verwendet werden.
Beachten Sie, dass während der Konfiguration eines Tweens nach der Erstellung eines Tweens nicht modifiziert werden kann.Wenn für eine Interpolation neue Ziele erforderlich sind, muss ein neues Tween erstellt werden.
Beachten Sie auch, dass mehrere Teenager gleichzeitig auf demselben Objekt gespielt werden können, aber sie dürfen nicht die gleiche Eigenschafteninterpolieren.Wenn zwei Teenager versuchen, die gleiche Eigenschaftenzu modifizieren, wird der initiale Teenager abgebrochen und durch den jüngsten Tweenüberschrieben.
Code-Beispiele
In this example a Tween is created to animate the position and color of a Part. Because the position and color are part of the same tween, they will change at the exact same rate and will reach their goal at the same time.
local TweenService = game:GetService("TweenService")
local part = Instance.new("Part")
part.Position = Vector3.new(0, 10, 0)
part.Color = Color3.new(1, 0, 0)
part.Anchored = true
part.Parent = game.Workspace
local goal = {}
goal.Position = Vector3.new(10, 10, 0)
goal.Color = Color3.new(0, 1, 0)
local tweenInfo = TweenInfo.new(5)
local tween = TweenService:Create(part, tweenInfo, goal)
tween:Play()Zusammenfassung
Eigenschaften
Lesbare Eigenschaft, die auf die Instance zeigt, deren Eigenschaften vom Tween interpoliert werden.
Lesbare Eigenschaft, die Informationen enthält, wie die Interpolation der Tween durchgeführt werden soll.
Lesbare Eigenschaft, die den aktuellen Zustand für die Tween Animationenzeigt.
Methoden
Methoden von TweenBase übernommenStoppt die Wiedergabe und setzt die Zwölf-变量 zurück.Wenn du dann aufrufst TweenBase:Play(), werden die Eigenschaften des Zwischenstopps der Animation interpoliert, um zu ihrer Destination fortzufahren, aber die volle Länge der Animation wird benötigt, um dies zu tun.
Stoppt die Wiedergabe des Tween.Setzt seine Fortschrittsvariablen nicht zurück, was bedeutet, dass, wenn du TweenBase:Play() anrufst, der Teenager die Wiedergabe vom Moment an fortsetzt, in dem sie unterbrochen wurde.
Startet die Wiedergabe eines Tween.Beachten Sie, dass wenn die Wiedergabe bereits begonnen hat, das Anrufen von Play() keine Wirkung hat, es sei denn, der Teenager hat sich fertiggestellt oder wurde gestoppt (entweder durch TweenBase:Cancel() oder TweenBase:Pause() ).
Ereignisse
Ereignisse von TweenBase übernommenFeuert, wenn der Teenager die Wiedergabe beendet oder mit TweenBase:Cancel() gestoppt wird.
Eigenschaften
Instance
Diese Eigenschaft eines Tween (nur zum Lesen) zeigt auf die Instance , deren Eigenschaften interpoliert werden.
Code-Beispiele
This code sample includes a simple function that will return true if the instance of a tween is a Part.
local TweenService = game:GetService("TweenService")
local function isInstanceAPart(tween)
local instance = tween.Instance
return instance:IsA("BasePart")
end
local tweenInfo = TweenInfo.new()
local instance = Instance.new("Part")
local tween = TweenService:Create(instance, tweenInfo, {
Transparency = 1,
})
print(isInstanceAPart(tween))TweenInfo
Lesbare Eigenschaft, die Informationen enthält, wie die Interpolation der Tween durchgeführt werden soll, mit dem TweenInfo Daten eingeben.
Code-Beispiele
An example of the range of different interpolation effects that can be used in Tweens.
-- A TweenInfo with all default parameters
TweenInfo.new()
-- A TweenInfo with its time set to 0.5 seconds.
TweenInfo.new(0.5)
-- A TweenInfo with its easing style set to Back.
TweenInfo.new(0.5, Enum.EasingStyle.Back)
-- A TweenInfo with its easing direction set to In.
TweenInfo.new(0.5, Enum.EasingStyle.Back, Enum.EasingDirection.In)
-- A TweenInfo that repeats itself 4 times.
TweenInfo.new(0.5, Enum.EasingStyle.Back, Enum.EasingDirection.In, 4)
-- A TweenInfo that reverses its interpolation after reaching its goal.
TweenInfo.new(0.5, Enum.EasingStyle.Back, Enum.EasingDirection.In, 4, true)
-- A TweenInfo that loops indefinitely.
TweenInfo.new(0.5, Enum.EasingStyle.Back, Enum.EasingDirection.In, -1, true)
-- A TweenInfo with a delay of 1 second between each interpolation.
TweenInfo.new(0.5, Enum.EasingStyle.Back, Enum.EasingDirection.In, 4, true, 1)