TweenService
*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.
TweenService wird verwendet, um Tweens zu erstellen, die die Eigenschaften der Instanzen interpolieren oder tweenen. Tweens kann auf jedem Objekt mit kompatiblen Eigenschaftstypen verwendet werden, einschließlich:
TweenService:Create() , die Hauptbaumeisterungsfunktion, nimmt TweenInfo Spezifikationen über den Tween und generiert das Class.Tween -Objekt, das dann verwendet werden kann, um den Tween abzuspielen.
Beachten Sie, dass Tweens mehrere Eigenschaften gleichzeitig interpolieren kann, aber sie müssen nicht dasselbe Eigenschaft interpolieren. Wenn zwei Tweens versuchen, dasselbe Eigenschaft zu ändern, wird das ursprüngliche Tween abgebrochen und überschrieben durch das neueste Tweens.
Code-Beispiele
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()local TweenService = game:GetService("TweenService")
local part = Instance.new("Part")
part.Position = Vector3.new(0, 10, 0)
part.Anchored = true
part.Parent = workspace
local tweenInfo = TweenInfo.new(
2, -- Time
Enum.EasingStyle.Linear, -- EasingStyle
Enum.EasingDirection.Out, -- EasingDirection
-1, -- RepeatCount (when less than zero the tween will loop indefinitely)
true, -- Reverses (tween will reverse once reaching it's goal)
0 -- DelayTime
)
local tween = TweenService:Create(part, tweenInfo, { Position = Vector3.new(0, 30, 0) })
tween:Play()
task.wait(10)
tween:Cancel() -- cancel the animation after 10 secondslocal TweenService = game:GetService("TweenService")
local part = Instance.new("Part")
part.Position = Vector3.new(0, 10, 0)
part.Anchored = true
part.BrickColor = BrickColor.new("Bright green")
part.Parent = workspace
local goal = {}
goal.Position = Vector3.new(50, 10, 0)
local tweenInfo = TweenInfo.new(10, Enum.EasingStyle.Linear)
local tween = TweenService:Create(part, tweenInfo, goal)
tween:Play()
task.wait(3)
part.BrickColor = BrickColor.new("Bright red")
tween:Pause()
task.wait(2)
part.BrickColor = BrickColor.new("Bright green")
tween:Play()Zusammenfassung
Methoden
Erstellt ein neues Tween mit den Eigenschaften des zu tweenenden Objekts, einer TweenInfo und einer Datenbank von Ziel-Eigenschaften.
- GetValue(alpha : number,easingStyle : Enum.EasingStyle,easingDirection : Enum.EasingDirection):number
Berechnet eine neue Alpha, die eine Enum.EasingStyle und eine Enum.EasingDirection hat.
- SmoothDamp(current : Variant,target : Variant,velocity : Variant,smoothTime : number,maxSpeed : number?,dt : number?):Tuple
Eigenschaften
Methoden
Create
Der Create() erstellt einen neuen Tween aus drei Argumenten: das Objekt zum Tweeln, die Spezifikationen von TweenInfo und eine Tabelle mit den Eigenschaften zum Tweeln und Werten zum Tweeln.
Der propertyTable-Parameter muss ein Wörterbuch sein, in dem die Schlüssel die Stringsamen der Eigenschaft sind (z. B. Position, Transparency oder 1>Color1>), und die Werte sind die Ziel-Eigenschaften am Ende des Tween.
Das Tween , das mit dieser Funktion erstellt wurde, ist einzigartig für das Objekt, das als instance -Parameter gegeben wird. Um dieselbe Tween auf ein anderes Objekt anzuwenden, rufe diese Funktion erneut mit dem neuen Objekt auf.
Parameter
Ein Wörterbuch von Eigenschaften und ihren Zielwerten, die tweened werden sollen.
Rückgaben
Code-Beispiele
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()local TweenService = game:GetService("TweenService")
local part = Instance.new("Part")
part.Position = Vector3.new(0, 10, 0)
part.Anchored = true
part.Parent = workspace
local tweenInfo = TweenInfo.new(
2, -- Time
Enum.EasingStyle.Linear, -- EasingStyle
Enum.EasingDirection.Out, -- EasingDirection
-1, -- RepeatCount (when less than zero the tween will loop indefinitely)
true, -- Reverses (tween will reverse once reaching it's goal)
0 -- DelayTime
)
local tween = TweenService:Create(part, tweenInfo, { Position = Vector3.new(0, 30, 0) })
tween:Play()
task.wait(10)
tween:Cancel() -- cancel the animation after 10 secondsGetValue
Gibt einen neuen Alpha-Wert für die Interpolation mit dem angegebenen Alpha-Wert zurück, Enum.EasingStyle und Enum.EasingDirection. Der angegebene alpha -Wert wird zwischen 1> 01> und 4> 14> geklemmt.
Parameter
Ein Interpolation-Wert zwischen 0 und 1 .
Der Entlastungsstil, den Sie verwenden.
Die Entlastungsrichtung, die verwendet wird.
Rückgaben
Ein neuer Alpha-Wert, der aus dem gegebenen Stil und der Richtung erzeugt wird.