Trail

Visualizza obsoleti

*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.

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

Sommario

Proprietà

Proprietà

Attachment0

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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à.

Lettura Parallela

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.

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Nascosto
Non Replicato
Lettura Parallela

MaxLength

Lettura Parallela

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

Lettura Parallela

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

ContentId
Lettura Parallela

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.

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

Lettura Parallela

Imposta la lunghezza della Strutturadel traccia, dipendente da TextureMode . Cambiare questa proprietà influisce immediatamente su tutti i segmenti di sentiero esistenti e futuri.

TextureMode

Lettura Parallela

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.

TextureMode diagram with Wrap mode

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

TextureMode diagram with Stretch mode

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

Lettura Parallela

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

Lettura Parallela

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.


Restituzioni

()

Eventi