Tween
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
L'objet Tween contrôle la lecture d'une interpolation.La création et la configuration d'un Tween est effectuée avec la fonction TweenService:Create() ; Instance.new() ne peut pas être utilisée pour cet objet spécifique.
Notez que bien que la configuration d'un tween puisse être accédée après la création d'un tween, il ne peut pas être modifié.Si de nouveaux objectifs sont nécessaires pour une interpolation, un nouveau Tween doit être créé.
Notez également que plusieurs adolescents peuvent être joués sur le même objet en même temps, mais ils ne doivent pas interpoler la même propriété.Si deux adolescents tentent de modifier la même propriété, le tween initial sera annulé et remplacé par le tween le plus récent.
Échantillons de code
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()Résumé
Propriétés
Propriété de lecture seule qui pointe vers le Instance dont les propriétés sont interpolées par le tween.
Propriété de lecture seule qui inclut des informations sur la manière dont l'interpolation de la Tween doit être effectuée.
Propriété de lecture seule qui montre l'état actuel de l'animationsTween.
Méthodes
Méthodes hérités de TweenBaseArrête la lecture et réinitialise les variables d'adolescent.Si vous appelez ensuite TweenBase:Play(), les propriétés de l'adolescent reprennent l'interpolation vers leur destination, mais prennent toute la longueur de l'animation pour le faire.
Arrête la lecture du tween.Ne réinitialise pas ses variables de progression, ce qui signifie que si vous appelez TweenBase:Play(), le préadolescent reprend le jeu à partir du moment où il a été interrompu.
Démarre la lecture d'un tween.Notez que si la lecture a déjà commencé, l'appel de Play() n'a aucun effet à moins que le pré-adolescent n'ait fini ou ne soit arrêté (par TweenBase:Cancel() ou TweenBase:Pause() ).
Évènements
Évènements hérités de TweenBaseSe déclenche lorsque la nageoire adolescente finit de jouer ou lorsqu'elle est arrêtée avec TweenBase:Cancel() .
Propriétés
Instance
Cette propriété d'un Tween (lecture seule) pointe vers le Instance dont les propriétés sont interpolées.
Échantillons de code
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
Propriété de lecture seule qui inclut des informations sur la façon dont l'interpolation de la Tween doit être effectuée, en utilisant le taperde données TweenInfo.
Échantillons de code
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)