Trail

Afficher les obsolètes

*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

Creating a Part with a Basic Trail

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

Propriétés

Attachment0

Lecture parallèle

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

Lecture parallèle

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

Lecture parallèle

É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é

Lecture parallèle

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

Creating a Trail with a Color Gradient

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

Lecture parallèle

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

Lecture parallèle

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

Lecture parallèle

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

Lecture parallèle

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

Lecture parallèle

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

Caché
Non répliqué
Lecture parallèle

MaxLength

Lecture parallèle

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

Lecture parallèle

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

ContentId
Lecture parallèle

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

Creating a Trail with a Paw Print Texture

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

Lecture parallèle

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

Lecture parallèle

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.

TextureMode diagram with Wrap mode

Lorsque TextureMode est réglé sur Enum.TextureMode.Stretch, la texture se répétera TextureLength fois sur la longueur globale du trace.

TextureMode diagram with Stretch mode

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

Lecture parallèle

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

Lecture parallèle

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

void

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.


Retours

void

Évènements