Trail
*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.
L'objet Trace est utilisé pour créer un effet de trace entre deux accessoires. Au fur et à mesure que les accessoires se déplacent dans l'espace, une texture est dessinée sur leur plan défini. Cela est couramment utilisé pour créer des effets qui visualisent des mouvements comme des traces de traceurs derrière les projectiles, les empreintes digitales, les pistes de roulement et similaires.
Voir Traceurs pour plus d'informations.
Échantillons de code
local TweenService = game:GetService("TweenService")
-- Create a parent part
local part = Instance.new("Part")
part.Material = Enum.Material.SmoothPlastic
part.Size = Vector3.new(4, 1, 2)
part.Position = Vector3.new(0, 5, 0)
part.Anchored = true
part.Parent = workspace
-- Create attachments on part
local attachment0 = Instance.new("Attachment")
attachment0.Name = "Attachment0"
attachment0.Position = Vector3.new(-2, 0, 0)
attachment0.Parent = part
local attachment1 = Instance.new("Attachment")
attachment1.Name = "Attachment1"
attachment1.Position = Vector3.new(2, 0, 0)
attachment1.Parent = part
-- Create a new trail
local trail = Instance.new("Trail")
trail.Attachment0 = attachment0
trail.Attachment1 = attachment1
trail.Parent = part
-- Tween part to display trail
local dir = 15
while true do
dir *= -1
local goal = {Position = part.Position + Vector3.new(0, 0, dir)}
local tweenInfo = TweenInfo.new(3)
local tween = TweenService:Create(part, tweenInfo, goal)
tween:Play()
task.wait(4)
end
Résumé
Propriétés
Avec Attachment1, détermine l'endroit où le sentier commencera à dessiner ses segments.
Avec Attachment0, détermine l'endroit où le sentier commencera à dessiner ses segments.
Échelle la lumière émise par la trace lorsque LightInfluence est inférieure à 1.
La couleur de la trace tout au long de sa vie.
Détermine si la trace sera dessinée ou non.
Détermine si la trace sera toujours face à la caméra, indépendamment de son orientation.
Détermine la durée de chaque segment dans une trace, en secondes.
Détermine dans quel degré les couleurs de la trace sont mélangées avec les couleurs derrière elle.
Détermine la mesure dans laquelle la trace est affectée par l'éclairage de l'environnement.
Définit la longueur maximale de la trace.
Définit la longueur minimale de la trace.
L'ID de contenu de la texture à afficher sur la trace.
Définit la longueur de la texture de la trace, en fonction de TextureMode .
Détermine la manière dont le Texture échelle, se répète et se déplace avec les accessoires de la trace.
Définit la transparence des segments de la trace sur sa Lifetime .
Échelle la largeur de la trace au cours de sa vie.
Méthodes
Efface les segments de la trace.
Propriétés
Attachment0
Un Trail commence à dessiner ses segments à l'emplacement de son Attachment0 et Attachment1 . Lorsque la traceest 1>
Changer les accessoires d'une trace pendant qu'elle dessine supprime tous les segments qu'elle a déjà dessinés.
Attachment1
Un Trail commence à dessiner ses segments à l'emplacement de ses Attachment0 et Attribut1 . Lorsque la traceest 1> Class
Changer les accessoires d'une trace pendant qu'elle dessine supprime tous les segments qu'elle a déjà dessinés.
Brightness
Échelle la lumière émise par la trace lorsque LightInfluence est inférieure à 1. Cette propriété est 1 par défaut et peut être réglée sur n'importe quel nombre dans la tranche de 0 à 10000. Augmenter la valeur de LightInfluence diminue l'effet de la valeur de cette propriété
Color
Détermine la couleur de la trace tout au long de sa durée de vie. Si Texture est configurer, cette couleur teint la texture.
Cette propriété est un ColorSequence, ce qui permet au couleur d'être configurée pour varier dans la longueur de la trace. Si la couleur change après que quelques-uns des segments de la trace aient été dessinés, tous les segments anciens seront mis à jour pour correspondre aux nouvelles couleurs.
Échantillons de code
local TweenService = game:GetService("TweenService")
-- Create a parent part
local part = Instance.new("Part")
part.Material = Enum.Material.SmoothPlastic
part.Size = Vector3.new(4, 1, 2)
part.Position = Vector3.new(0, 5, 0)
part.Anchored = true
part.Parent = workspace
-- Create attachments on part
local attachment0 = Instance.new("Attachment")
attachment0.Name = "Attachment0"
attachment0.Position = Vector3.new(-2, 0, 0)
attachment0.Parent = part
local attachment1 = Instance.new("Attachment")
attachment1.Name = "Attachment1"
attachment1.Position = Vector3.new(2, 0, 0)
attachment1.Parent = part
-- Create a new trail with color gradient
local trail = Instance.new("Trail")
trail.Attachment0 = attachment0
trail.Attachment1 = attachment1
local color1 = Color3.fromRGB(255, 0, 0)
local color2 = Color3.fromRGB(0, 0, 255)
trail.Color = ColorSequence.new(color1, color2)
trail.Parent = part
-- Tween part to display trail
local dir = 15
while true do
dir *= -1
local goal = {Position = part.Position + Vector3.new(0, 0, dir)}
local tweenInfo = TweenInfo.new(3)
local tween = TweenService:Create(part, tweenInfo, goal)
tween:Play()
task.wait(4)
end
Enabled
Cette propriété détermine si la trace sera dessinée ou non.
Si set to false while a trail is drawing, no new segments will be drawn, but any existing segments will be clean up naturally when they reach the end of their Lifetime . Pour forcer de nettoyer les segments existants, appelez la méthode Clear() à la même fois.
FaceCamera
Un Trail est une projection 2D existant dans l'espace 3D, ce qui signifie qu'il peut ne pas être visible de tous les angles. La propriété FaceCamera , lorsqu'elle est réglée sur true, garantit que la trace est toujours face la 1> Class.Workspace.CurrentCamera|CurrentCamera1>, indépendamment de son orientation.
Changer cette propriété affecte immédiatement tous les segments de piste existants et futurs.
Lifetime
La propriété durée de vie détermine la durée à laquelle chaque segment dans unTrace durera, en secondes, avant qu'il ne disparaisse. Par défaut, 2 secondes, mais peut être réglé n'importe où entre 0,01 et 20.
La durée de vie d'une trace est également utilisée par les propriétés Color et Transparency de cet effet pour déterminer comment chaque segment est dessiné. Les deux propriétés sont des séquences, ce qui signifie qu'elles définissent leurs valeurs à certains points clés dans la vie du segment et interpolent ensuite entre les valeurs à mesure que le segment vieillit.
Si la durée de vie d'une trace change, les segments existants se comportent immédiatement comme s'ils avaient toujours la nouvelle durée de vie, ce qui signifie que si elles ont existé plus longtemps que la nouvelle durée de vie, elles seront immédiatement supprimées.
LightEmission
Détermine à quel degré les couleurs de la trace sont mélangées avec les couleurs derrière. Il doit être défini dans la tranche de 0 à 1. Une valeur de 0 utilise les mélanges de couleurs normaux et une valeur de 1 utilise les mélanges de couleurs additives.
Cette propriété ne doit pas être confondue avec LightInfluence qui détermine comment la trace est affectée par la lumière environnementale.
Changer cette propriété affecte immédiatement tous les segments existants et futurs de la trace.
Cette propriété ne fait pas non que la trace s'allume l'environnement.
LightInfluence
Détermine la mesure dans laquelle la trace est affectée par l'éclairage de l'environnement, serrée entre 0 et 1. Lorsque 0, la trace ne sera pas affectée par l'éclairage de l'environnement. Lorsque 1, il sera entièrement affecté par l'éclairage comme un BasePart serait.
Changer cette propriété affecte immédiatement tous les segments existants et futurs de la trace.
Voir également LightEmission qui spécifie dans quelle mesure les couleurs de la trace sont mélangées avec les couleurs derrière elle.
LocalTransparencyModifier
MaxLength
Cette propriété détermine la longueur maximale de la trace, en studs. Sa valeur par défaut est 0, ce qui signifie que la trace n'aura pas de longueur maximale et que les segments de la trace expirent dans leur Lifetime .
Cette propriété peut être utilisée avec la propriété MinLength qui détermine la longueur minimum qu'un trail doit être avant qu'il soit dessiné.
MinLength
Cette propriété détermine la longueur minimale de la trace, en studs. Si aucune des pièces de la trace n'a déplacé au moins cette valeur, aucune nouvelle section n'est créée et les points d'extrémité de la section actuelle sont déplacés à l'emplacement actuel des pièces.
Notez que le changement de cette propriété ne modifiera que les nouveaux segments qui sont dessinés ; les segments existants qui ont déjà été dessinés conserveront leur longueur actuelle.
Cette propriété peut être utilisée avec la propriété MaxLength qui détermine la longueur maximale de la trace avant que ses segments les plus anciens ne soient effacés.
Texture
L'ID de contenu de la texture à afficher sur la trace. Si cette propriété n'est pas configurer, la piste sera affichée comme un avion solide ; cela se produit également lorsque la texture est définie à un ID de contenu invalide ou que l'image associée à la texture n'a pas encore été chargée.
L'apparence de la texture peut être modifiée par d'autres propriétés de la trace, y compris Color et Transparency.
L'échelle de la texture est déterminée par la distance entre Attachment0 et Attachment1, ainsi que les propriétés TextureMode, 1> Class.Trail.TextureLength|TextureLength1> et 4>
Échantillons de code
local TweenService = game:GetService("TweenService")
-- Create a parent part
local part = Instance.new("Part")
part.Material = Enum.Material.SmoothPlastic
part.Size = Vector3.new(2, 1, 2)
part.Position = Vector3.new(0, 5, 0)
part.Anchored = true
part.Parent = workspace
-- Create attachments on part
local attachment0 = Instance.new("Attachment")
attachment0.Name = "Attachment0"
attachment0.Position = Vector3.new(-1, 0, 0)
attachment0.Parent = part
local attachment1 = Instance.new("Attachment")
attachment1.Name = "Attachment1"
attachment1.Position = Vector3.new(1, 0, 0)
attachment1.Parent = part
-- Create a new trail with color gradient
local trail = Instance.new("Trail")
trail.Attachment0 = attachment0
trail.Attachment1 = attachment1
trail.Texture = "rbxassetid://16178262222"
trail.TextureMode = Enum.TextureMode.Static
trail.TextureLength = 2
trail.Parent = part
-- Tween part to display trail
local dir = 15
while true do
dir *= -1
local goal = {Position = part.Position + Vector3.new(0, 0, dir)}
local tweenInfo = TweenInfo.new(3)
local tween = TweenService:Create(part, tweenInfo, goal)
tween:Play()
task.wait(4)
end
TextureLength
Définit la longueur de la texture de la trace, en fonction de TextureMode. Changer cette propriété affecte immédiatement toutes les segments de piste existants et futurs.
TextureMode
Cette propriété, avec TextureLength, détermine comment la Texture d'une trace s'adapte, se répète et se déplace avec les accessoires de la trace. Changer cette propriété affecte immédiatement toutes les segments de la trace existants et futurs.
Échelle et répétition
Lorsque TextureMode est réglé sur Enum.TextureMode.Wrap ou Enum.TextureMode.Static, la propriété 1> Class.Trail.TextureLength|TextureLength1> détermine la longueur de la texture à mesure qu'elle se répète le long de la longueur du trace.
Lorsque TextureMode est réglé sur Enum.TextureMode.Stretch, la texture se répétera TextureLength fois sur la longueur globale du trace.
Mouvement
La propriété TextureMode affecte également le mouvement de la texture de la trace comme suivant :
Si vous avez défini sur Enum.TextureMode.Stretch, la texture s'étirera en fonction de la durée de vie de la trace, et se rapetissera à l'intérieur si les accessoires de la trace arrêtent de se déplacer.
Si défini sur Enum.TextureMode.Wrap, la texture sera imprimée en fonction de la longueur de la trace, mais les textures resteront stationnaires par rapport à leurs accessoires.
Si défini sur Enum.TextureMode.Static, la texture sera déployée comme les accessoires se mouvement, et ils resteront en place jusqu'à ce que leur durée de vie soit atteinte. Ce paramètre est idéal pour les textures de piste de traîneau qui doivent apparaître «griffées» où rendu, tels que les empreintes digitales ou les bandes de roulement.
Transparency
Définit la transparence des segments de la trace sur son Lifetime. Ce value est un NumberSequence, ce qui signifie qu'il peut être une valeur statique ou peut changer tout au long de la vie des segments de la trace.
WidthScale
Cette propriété est un NumberSequence qui met l'échelle de la largeur de la trace au cours de sa durée de vie. Les valeurs peuvent varier entre 0 et 1, agissant comme un multiplicateur sur la distance entre les accessoires de la trace. Par exemple, si les accessoires de la trace sont séparés de 2 studet que la valeur de cette propriété est 0,5, la largeur de la trace sera 1
Méthodes
Clear
Cette méthode supprime immédiatement tous les segments de la trace et est utile pour nettoyer les traces avec une durée de vie plus longue ou pour les cas où la trace devrait être supprimée en raison d'une action spécifique.
L'appel de cette méthode n'affecte que les segments existants. Pour effacer temporairement les segments de la traceexistants, activez la propriété Class.Trail.Enabled|Enabled de la piste à Enabled en même temps.