TweenService
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
TweenService è usato per creare Tweens che interpola, o gemellati, le proprietà delle istanze. Tweens può essere utilizzato su qualsiasi oggetto con tipi di proprietà compatibili, tra cui:
TweenService:Create() , la funzione principale costruttore, prende TweenInfo specifiche sul tween e genera l'oggetto Tween che può quindi essere utilizzato per giocare il gemellati.
Nota che Tweens può interpolare più proprietà contemporaneamente, ma non devono essere interpolate sulla stessa Proprietà. Se due tweens tentano di modificare la stessa Proprietà, l'originale tween verrà annullato e sovrascritto dal gemellatipiù recente.
Campioni di codice
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()Sommario
Proprietà
Metodi
Crea un nuovo Tween dato all'oggetto cui le sue proprietà sono da tuenizzare, un TweenInfo e un dizionario di valori di proprietà di obiettivo.
- GetValue(alpha : number,easingStyle : Enum.EasingStyle,easingDirection : Enum.EasingDirection):number
Calcola una nuova alpha data un Enum.EasingStyle e un Enum.EasingDirection .
- SmoothDamp(current : Variant,target : Variant,velocity : Variant,smoothTime : number,maxSpeed : number?,dt : number?):Tuple
Proprietà
Metodi
Create
Il Create() costruttore crea un nuovo Tween a partire da tre argomenti: l'oggetto a gemellati, le specifiche TweenInfo e una tabella che contiene le proprietà a tween e valori a tween.
Il parametro propertyTable deve essere una dizionario in cui le chiavi sono i nomi di stringa della proprietà (per esempio Position , Transparency , o 1> Color1> ) e i valori sono i target della proprietà alla fine del gemellati.
Il Tween creato utilizzando questa funzione è unico per l'oggetto dato come il parametro instance . Per applicare lo stesso tween a un altro oggetto, chiama questa funzione di nuovo con l'oggetto nuovo.
Parametri
Un dizionario di proprietà e dei loro valori di destinazione, da tuenizzare.
Restituzioni
Campioni di codice
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
Restituisce un nuovo valore alfa per l'interpolazione utilizzando il valore alfa fornito, Enum.EasingStyle e Enum.EasingDirection . Il valore fornito alpha sarà bloccato tra 1> 01> e 4> 14> .
Parametri
Un valore di interpolazione tra 0 e 1 .
Lo stile di facilezza da utilizzare.
La direzione di facilezza da utilizzare.
Restituzioni
Un nuovo valore alpha generato dallo stile di facilezza e dalla direzione forniti.