Beam

Il Attachment il raggio si origina da.Questo allegato è il primo punto di controllo sulla curva cubica Bézier del raggio; la sua orientazione, insieme alla ProprietàCurveSize0 , determina la posizione del secondo punto di controllo.Vedi Fasi per maggiori dettagli.

Per il Attachment dove termina il raggio, vedi Attachment1 .

Il Attachment il raggio finisce a.Questo allegato è il quarto e ultimo punto di controllo sulla curva cubica Bézier del raggio; la sua orientazione, insieme alla ProprietàCurveSize1 , determina la posizione del terzo punto di controllo.Vedi Fasi per maggiori dettagli.

Per il Attachment dove il fascio si origina, vedi Attachment0 .

Scala la luce emessa dal raggio 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à.

Determina il colore del raggio attraverso la sua Segments .Se Texture è Impostare, questo colore verrà applicato alla Strutturadel raggio.Se non è Impostarealcuna Texture, la Beam apparirà come una linea solida colorata in conformità a questa Proprietà.

Questa proprietà è un ColorSequence , che consente al colore di essere configurato per variare lungo la lunghezza del raggio.Considera il seguente ColorSequence che, quando applicato a un raggio, produrrebbe il Risultatorappresentato.

local colorSequence = ColorSequence.new({
		ColorSequenceKeypoint.new(0, Color3.fromRGB(255, 0, 0)), -- Rosso
		ColorSequenceKeypoint.new(0.5, Color3.fromRGB(0, 188, 203)), -- Ciano
		ColorSequenceKeypoint.new(1, Color3.fromRGB(196, 0, 255)), -- Viola
	}
)

Si noti che anche la colorazione del raggio dipende dal numero di Segments che Beam ha.Ogni segmento del raggio può mostrare solo una transizione tra due colori.Pertanto un Beam avrà bisogno di avere almeno n-1 segmenti perché il colore venga visualizzato correttamente, dove n è il numero di ColorSequenceKeypoints in ColorSequence .

Determina, insieme a Attachment0, la posizione del secondo punto di controllo nella curva Bézier del raggio. Vedi Beams per maggiori dettagli.

La posizione di questo punto può essere determinata dall'equazione seguente:

local controlPoint2 = Beam.Attachment0.WorldPosition + (Beam.Attachment0.CFrame.RightVector * Beam.CurveSize0)

Determina, insieme a Attachment1, la posizione del terzo punto di controllo nella curva Bézier del raggio. Vedi Beams per maggiori dettagli.

La posizione di questo punto può essere determinata dall'equazione seguente:

local controlPoint3 = Beam.Attachment1.WorldPosition - (Beam.Attachment1.CFrame.RightVector * Beam.CurveSize1)

Determina se il fascio è visibile o meno.

Quando questa proprietà è impostata su false, il fascio di Segments non verrà visualizzato.

Un Beam è 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 raggio si diriga sempre verso il CurrentCamera, indipendentemente dall'orientamento.

Determina fino a che punto i colori del fascio 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 fascio sia influenzato dalla luce ambientale.

Questa proprietà non fa non accendere il fascio l'Ambiente.

Determina il grado in cui il fascio è influenzato dalla luce dell'Ambiente, appuntata tra 0 e 1.Quando 0, il fascio non verrà influenzato dalla luce dell'Ambiente.Quando 1, sarà completamente influenzato dalla luce come sarebbe BasePart .

Vedi anche LightEmission che specifica fino a che punto i colori del fascio sono mescolati con i colori dietro di esso.

Piuttosto che essere una curva perfetta, un raggio è composto da segmenti retti.Più segmenti, maggiore è la risoluzione della curva.La proprietà Segmenti imposta il numero di segmenti retti di cui è composto il raggio, con un valore predefinito di 10.

Nota che le proprietà Color e Transparency richiedono un certo numero di segmenti per essere visualizzate correttamente.Questo perché ogni segmento può mostrare solo una transizione tra due colori o trasparenze.Pertanto un Beam richiede almeno n-1 segmenti per essere visualizzati correttamente, dove n è il numero di punti chiave associati al raggio di Color e Transparency.

L'ID del contenuto della texture da mostrare sul raggio.Se questa proprietà non è Impostare, il raggio verrà visualizzato come una linea solida; 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 raggio incluse Color e Transparency .

La ridimensionamento della texture è determinato dalle proprietà TextureMode, TextureLength, Width0 e Width1.

Imposta la lunghezza della Strutturadel fascio, dipendente da TextureMode .

Questa Proprietà, insieme a TextureLength , determina come si ripete un raggio di Texture .

Quando è impostato su Enum.TextureMode.Wrap o Enum.TextureMode.Static, le ripetizioni della texture saranno uguali alla lunghezza complessiva del raggio (in studs) divisa per il suo TextureLength.

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

Determina la velocità alla quale l'immagine Texture si muove lungo il raggio.Quando questa proprietà è un valore positivo, la texture del raggio si sposterà da Attachment0 a Attachment1 .Questa direzione può essere invertita impostando questa proprietà a un numero negativo.

Determina la trasparenza del raggio attraverso i suoi segmenti.Questa proprietà è un NumberSequence , consentendo la trasparenza di essere configurata per variare lungo la lunghezza del raggio.

Considera il seguente NumberSequence che, quando applicato a un raggio, produrrebbe il Risultatorappresentato.

local numberSequence = NumberSequence.new({
		NumberSequenceKeypoint.new(0, 0), -- Opaco
		NumberSequenceKeypoint.new(0.5, 1), -- Trasparente
		NumberSequenceKeypoint.new(1, 0), -- Opaco
	}
)

Si noti che la trasparenza del raggio dipende anche dal numero di Segments.Ogni segmento del raggio può mostrare solo una transizione tra due trasparenze.Pertanto un raggio avrà bisogno di avere almeno n-1 segmenti per essere visualizzato correttamente, dove n è il numero di NumberSequenceKeypoints in NumberSequence .

La larghezza del raggio alla sua origine ( Attachment0 ), in studs. La larghezza del raggio cambierà linealmente a Width1 studs alla sua fine ( Attachment1 ).

L'ampiezza del raggio alla sua fine ( Attachment1 ), in studs. L'ampiezza del raggio cambierà linealmente da Width0 studs alla sua origine ( Attachment0 ).

La distanza, in studs, la visualizzazione del fascio è spostata rispetto al CurrentCamera .Quando 0, il fascio verrà visualizzato nella sua posizione standard tra Attachment0 e Attachment1 . ZOffset può essere positivo o negativo.

Questa proprietà è particolarmente utile per evitare "Z‑fighting" quando si utilizza più Beams tra gli stessi Attachments.

-- Create beams
local beam1 = Instance.new("Beam")
beam1.Color = ColorSequence.new(Color3.new(1, 0, 0))
beam1.FaceCamera = true
beam1.Width0 = 3
beam1.Width1 = 3
local beam2 = Instance.new("Beam")
beam2.Color = ColorSequence.new(Color3.new(0, 1, 0))
beam2.FaceCamera = true
beam2.Width0 = 2
beam2.Width1 = 2
local beam3 = Instance.new("Beam")
beam3.Color = ColorSequence.new(Color3.new(0, 0, 1))
beam3.FaceCamera = true
beam3.Width0 = 1
beam3.Width1 = 1

-- Layer beams
beam1.ZOffset = 0
beam2.ZOffset = 0.01
beam3.ZOffset = 0.02

-- Create attachments
local attachment0 = Instance.new("Attachment")
attachment0.Position = Vector3.new(0, -10, 0)
attachment0.Parent = workspace.Terrain
local attachment1 = Instance.new("Attachment")
attachment1.Position = Vector3.new(0, 10, 0)
attachment1.Parent = workspace.Terrain

-- Connect beams
beam1.Attachment0 = attachment0
beam1.Attachment1 = attachment1
beam2.Attachment0 = attachment0
beam2.Attachment1 = attachment1
beam3.Attachment0 = attachment0
beam3.Attachment1 = attachment1

-- Parent beams
beam1.Parent = workspace
beam2.Parent = workspace
beam3.Parent = workspace

L'offset del ciclo della texture di un raggio rappresenta il progresso della sua animazionidella texture.Questo metodo imposta l'offset attuale del ciclo della texture del fascio; pertanto, può essere utilizzato per ripristinare il ciclo passando 0 come parametro offset.

Notizie

• Si prevede che il parametro offset dato sia un valore tra 0 e 1, ma possono essere utilizzati valori più elevati.
• Il ciclo della texture si avvolge a 0 e 1, il che significa che la texture è nella stessa posizione quando l'offset è a 0 o 1.
• Se la proprietà Texture non è Impostare, questo metodo non fa nulla.
• L'aumento dell'offset agirà nella direzione inversa alla ProprietàTextureSpeed, cioè sposterà la texture nella direzione opposta a quella in cui si muove quando TextureSpeed è maggiore di 0.

Parametri

Restituzioni