Trail
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
L'oggetto Sentiero viene utilizzato per creare un effetto sentiero tra due allegati.Mentre gli allegati si muovono attraverso Spazio, viene disegnata una texture sul loro piano definito.Questo è comunemente utilizzato per creare effetti che visualizzino movimenti come sentieri tracciatori dietro proiettili, impronte, tracce di ruote e effetti simili.
Vedi Sentieri per ulteriori informazioni.
Campioni di codice
This example demos the functionality of Trails by creating a BasePart to be the parent of the trail. Two Attachments are then parented to the part. The positions of these two attachments (more importantly the distance between them) determines where the trail is drawn as the part moves.
For these attachments to create a trail as described, a new Trail is parented to the part and its Attachment0 and Attachment1 are parented to attachment0 and attachment1 respectively. Finally, TweenService is used to move the part back and forth, showing how the trail is drawn as the part (and its attachments) move.
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
Sommario
Proprietà
Insieme a Attachment1, determina dove il sentiero inizierà a disegnare i suoi segmenti.
Insieme a Attachment0, determina dove il sentiero inizierà a disegnare i suoi segmenti.
Scala la luce emessa dal sentiero quando LightInfluence è inferiore a 1.
Il colore del sentiero durante tutta la sua vita.
Determina se il sentiero verrà disegnato o meno.
Determina se il sentiero sarà sempre rivolto alla Telecamera, indipendentemente dall'orientamento.
Determina per quanto tempo ciascun segmento in una traccia durerà, in secondi.
Determina fino a che punto i colori del percorso sono mescolati con i colori dietro di esso.
Determina il grado in cui il sentiero è influenzato dalla luce dell'Ambiente.
Imposta la lunghezza massima del traccia.
Imposta la lunghezza minima del traccia.
L'ID del contenuto della texture da mostrare sul traccia.
Imposta la lunghezza della Strutturadel traccia, dipendente da TextureMode .
Determina il modo in cui le scale Texture si ripetono e si muovono insieme agli allegati del traccia.
Imposta la trasparenza dei segmenti del tracciasul suo Lifetime .
Aumenta la larghezza del sentiero nel corso della sua vita.
Metodi
Cancella i segmenti del traccia.
Proprietà
Attachment0
Un Trail inizia a disegnare i suoi segmenti nelle posizioni del suo Attachment0 e Attachment1.Quando il sentiero è Enabled , registra le posizioni dei suoi allegati ad ogni frame e connette queste posizioni alle posizioni degli allegati sul frame precedente, creando un poligono che viene poi riempito dalle posizioni del tracciaColor e Texture .
Cambiare gli allegati di un sentiero mentre un sentiero viene disegnato rimuoverà tutti i segmenti che il sentiero ha già disegnato.
Attachment1
Un Trail inizia a disegnare i suoi segmenti nelle posizioni del suo Attachment0 e Attachment1 .Quando il sentiero è Enabled , registra le posizioni dei suoi allegati ad ogni frame e connette queste posizioni alle posizioni degli allegati sul frame precedente, creando un poligono che viene poi riempito dalle posizioni del tracciaColor e Texture .
Cambiare gli allegati di un sentiero mentre un sentiero viene disegnato rimuoverà tutti i segmenti che il sentiero ha già disegnato.
Brightness
Scala la luce emessa dal sentiero quando LightInfluence è inferiore a 1.Questa proprietà è 1 per impostazione predefinita e può essere impostata a qualsiasi numero all'interno della gamma da 0 a 10000.Aumentare il valore di LightInfluence diminuisce l'effetto del valore di questa Proprietà.
Color
Determina il colore del sentiero durante tutta la sua vita. Se Texture è Impostare, questo colore tingerà la Struttura.
Questa proprietà è una ColorSequence, consentendo al colore di essere configurato per variare lungo la lunghezza del sentiero.Se il colore cambia dopo che alcuni segmenti del tracciasono stati disegnati, tutti i vecchi segmenti verranno aggiornati per abbinarsi ai nuovi colori.
Campioni di codice
This example creates a Trail with a gradient color, meaning that the color at one end of the trail is different than the color at the opposite end, and both colors blend together as they get closer to the middle of the 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 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
Questa proprietà determina se il sentiero verrà disegnato o meno.
Se impostato su false mentre un sentiero viene disegnato, non verranno disegnati nuovi segmenti, ma tutti i segmenti esistenti verranno puliti naturalmente quando raggiungono la fine del loro Lifetime .Per pulire forzatamente i segmenti esistenti, chiama il metodo Clear() alla stessa volta.
FaceCamera
Un Trail è una proiezione 2D esistente nello Spazio3D, il che significa che potrebbe non essere visibile da ogni angolo.La Proprietà FaceCamera , quando impostata su true, garantisce che il sentiero sia sempre rivolto al CurrentCamera, indipendentemente dall'orientamento.
Cambiare questa proprietà influisce immediatamente su tutti i segmenti di traccia esistenti e futuri.
Lifetime
La proprietà Tempo di vita determina quanto tempo durerà ciascun segmento in una traccia, in secondi, prima di scomparire.Predefinito a 2 secondi ma può essere impostato ovunque tra 0,01 e 20.
La durata di un sentiero viene anche utilizzata dalle proprietà Color e Transparency dell'effetto per determinare come viene disegnato ciascun segmento.Entrambe queste proprietà sono sequenze, il che significa che definiscono i loro valori in determinati punti chiave nella vita del segmento e poi interpolano tra i valori man mano che il segmento invecchia.
Se la durata di un tracciacambia, i segmenti esistenti si comporteranno immediatamente come se avessero sempre avuto la nuova durata, il che significa che se sono esistiti per più tempo della nuova durata, verranno rimossi immediatamente.
LightEmission
Determina fino a che punto i colori del percorso sono mescolati con i colori dietro di esso.Dovrebbe essere impostato nella gamma da 0 a 1.Un valore di 0 utilizza i normali modi di fusione e un valore di 1 utilizza la fusione additiva.
Questa proprietà non deve essere confusa con LightInfluence che determina come il sentiero sia influenzato dalla luce ambientale.
Cambiare questa proprietà influisce immediatamente su tutti i segmenti esistenti e futuri del traccia.
Questa proprietà non fa non accendere il sentiero per illuminare l'Ambiente.
LightInfluence
Determina il grado in cui il sentiero è influenzato dalla luce dell'Ambiente, appuntata tra 0 e 1.Quando 0, il sentiero non verrà influenzato dall'illuminazione dell'Ambiente.Quando 1, sarà completamente influenzato dalla luce come sarebbe BasePart .
Cambiare questa proprietà influisce immediatamente su tutti i segmenti esistenti e futuri del traccia.
Vedi anche LightEmission che specifica fino a che punto i colori del sentiero sono mescolati con i colori dietro di esso.
LocalTransparencyModifier
MaxLength
Questa proprietà determina la lunghezza massima del traccia, in studs.Il suo valore predefinito è 0, il che significa che il sentiero non avrà una lunghezza massima e i segmenti del sentiero scadranno nel loro Lifetime .
Questa proprietà può essere utilizzata insieme alla proprietà MinLength che determina la lunghezza minima che un sentiero deve avere prima di essere disegnato.
MinLength
Questa proprietà determina la lunghezza minima del traccia, in studs.Se nessuno degli allegati del tracciaha movimentato almeno questo valore, non verranno creati nuovi segmenti e i punti finali del segmento attuale verranno spostati nella posizione attuale degli allegati.
Nota che cambiare questa proprietà influirà solo su nuovi segmenti che vengono disegnati; qualsiasi vecchio segmento che è già stato disegnato manterrà la sua lunghezza attuale.
Questa proprietà può essere utilizzata insieme alla proprietà MaxLength che determina la lunghezza massima del percorso prima che i suoi segmenti più vecchi vengono cancellati.
Texture
L'ID del contenuto della texture da mostrare sul traccia.Se questa proprietà non è Impostare, il sentiero verrà visualizzato come un solido piano; ciò avviene anche quando la texture è impostata su un ID contenuto non valido o l'immagine associata alla texture non è ancora stata caricata.
L'aspetto della texture può essere ulteriormente modificato da altre proprietà del sentiero incluse Color e Transparency .
La ridimensionamento della texture è determinato dalla distanza tra Attachment0 e Attachment1 , nonché dalle proprietà TextureMode, TextureLength e WidthScale.
Campioni di codice
This example adds a paw prints texture to a trail object. In order for the paw prints to remain "stamped" in place after rendering, TextureMode is set to Enum.TextureMode.Static.
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
Imposta la lunghezza della Strutturadel traccia, dipendente da TextureMode . Cambiare questa proprietà influisce immediatamente su tutti i segmenti di sentiero esistenti e futuri.
TextureMode
Questa Proprietà, insieme a TextureLength , determina come le dimensioni di un sentiero Texture si ripetono e si muovono insieme alle sue allegate.Cambiare questa proprietà influisce immediatamente su tutti i segmenti di traccia esistenti e futuri.
Dimensione e ripetizione
Quando Modalità texture è impostata su Enum.TextureMode.Wrap o Enum.TextureMode.Static, la proprietà TextureLength imposta la lunghezza della texture mentre si ripete lungo la lunghezza del traccia.

Quando Modalità texture è impostata su Enum.TextureMode.Stretch , la texture si ripeterà TextureLength volte lungo l'intera lunghezza del traccia.

Movimento
La proprietà Modalità texture influisce anche sul movimento della texture del tracciacome segue:
Se impostato su Enum.TextureMode.Stretch, la texture si allungherà in base alla durata del tracciae si restringerà all'interno se le allegate del tracciasmettono di muoversi.
Se impostato su Enum.TextureMode.Wrap, la texture sarà piastrellata come la lunghezza del percorso cambia, ma le texture rimarranno ferme rispetto ai loro allegati.
Se impostato su Enum.TextureMode.Static, la texture verrà estesa mentre si Spostagli allegati e rimarranno in posizione fino a quando non verrà soddisfatta la loro durata.Questa impostazione è ideale per le texture di traccia che dovrebbero apparire "stampe" dove vengono visualizzate, come impronte di zampe o tracci di ruote.
Transparency
Imposta la trasparenza dei segmenti del tracciasul suo Lifetime .Questo valore è un NumberSequence , il che significa che può essere un valore statico o può cambiare durante tutta la vita dei segmenti del sentiero.
WidthScale
Questa proprietà è una NumberSequence che scala la larghezza del sentiero nel corso della sua vita.I valori possono variare tra 0 e 1, agendo come moltiplicatore sulla distanza tra gli allegati del sentiero.Ad esempio, se gli allegati della traccia sono a 2 stud di distanza e il valore di questa proprietà è 0,5, la larghezza della traccia sarà di 1 stud e la traccia sarà centrata tra i due allegati.
Metodi
Clear
Questo metodo ripulisce immediatamente tutti i segmenti del sentiero e è utile per pulire i sentieri con una durata di vita più lunga o per casi in cui il sentiero deve essere rimosso a causa di un'azione specifica.
Chiamare questo metodo influisce solo sui segmenti esistenti.Per cancellare i segmenti di traccia esistenti e temporaneamente impedire ai nuovi segmenti di essere disegnati, attiva la proprietà Enabled del sentiero a false contemporaneamente.