TweenService
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
TweenService est utilisé pour créer Tweens qui interpolent ou tween les propriétés des instances. Tweens peut être utilisé sur n'importe quel objet avec des types de propriété compatibles, y compris :
TweenService:Create() , la fonction de construction principale, prend TweenInfo spécifications sur le tween et génère le Class.Tween objet qui peut ensuite être utilisé pour jouer le tween.
Notez que Tweens peut interpréter plusieurs propriétés à la fois, mais elles ne doivent pas être interprétées par la même propriété. Si deux tweens tentent de modifier la même propriété, la tween initiale sera annulée et écrasée par la plus récente tween.
Échantillons de code
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()Résumé
Méthodes
Crée une nouvelle Tween donné à l'objet dont les propriétés sont à tweener, un TweenInfo et un dictionnaire de valeurs de propriété de but.
- GetValue(alpha : number,easingStyle : Enum.EasingStyle,easingDirection : Enum.EasingDirection):number
Calcul un nouveau alpha donné un Enum.EasingStyle et un Enum.EasingDirection .
- SmoothDamp(current : Variant,target : Variant,velocity : Variant,smoothTime : number,maxSpeed : number?,dt : number?):Tuple
Propriétés
Méthodes
Create
Le Create() constructeur crée un nouveau Tween à partir de trois arguments : l'objet à tween, les spécifications TweenInfo et une table contenant les propriétés à tween et les valeurs à tween.
Le paramètre propertyTable doit être un dictionnaire où les clés sont les noms de chaîne de la propriété (par exemple Position , Transparency ou 1> Color1> ) et les valeurs sont les cibles de propriété à la fin du tween.
La création de Tween à l'aide de cette fonction est unique pour l'objet donné comme le instance paramètre. Pour appliquer le même tween à un autre objet, appelez cette fonction à nouveau avec le nouvel objet.
Paramètres
Un dictionnaire de propriétés et de leurs valeurs cibles, à être tweetées.
Retours
Échantillons de code
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
Renvoie une nouvelle valeur alpha pour l'interpolation en utilisant la valeur alpha donnée, Enum.EasingStyle et Enum.EasingDirection. La valeur alpha fournie sera ajustée entre 1> 01> et 4> 14>.
Paramètres
Une valeur d'interpolation entre 0 et 1.
Le style d'allègement à utiliser.
La direction d'atténuation à utiliser.
Retours
Une nouvelle valeur alpha générée à partir du style de soulèvement et de la direction donnés.