ParticleEmitter è un oggetto che emette immagini 2D personalizzabili (particelle) nel mondo, utile per simulare effetti speciali come fuoco, fumo e scintille.
Puoi collegare un ParticleEmitter a un Attachment o a un oggetto della classe BasePart. Quando è collegato a un BasePart, le particelle si generano casualmente all'interno della scatola di delimitazione o forma; quando è collegato a un Attachment, le particelle si generano dalla posizione dell'attacco.
Inoltre, la proprietà EmissionDirection determina la faccia (Enum.NormalId) di emissione quando l'emittente è collegato a un BasePart. Quando cambi questa proprietà, cambi di conseguenza anche la direzione di emissione delle particelle.
Personalizza le particelle
Sperimentando con le seguenti proprietà, puoi personalizzare l'aspetto visivo di una particella per creare elementi di gioco unici come vulcani che esplodono, polvere magica e particelle di polvere.
Texture
La proprietà Texture rende l'immagine che ogni particella visualizza. Per impostazione predefinita, gli emittenti di particelle hanno particelle con una texture di scintilla bianca, ma puoi cambiarla in qualsiasi texture per ottenere effetti interessanti.
Se stai creando un'immagine da utilizzare come texture per particelle, è meglio utilizzare il formato .png con uno sfondo trasparente. Se la tua texture è in scala di grigi senza canale alfa, prova a impostare la proprietà LightEmission dell'emittente a 1 per nascondere le aree più scure.
Colore
La proprietà Color tinge la texture di ogni particella con un colore specifico o con un gradiente di colore durante la sua durata.
In uno script, imposta un ColorSequence per la proprietà Color dell'emittente:
local emitter = Instance.new("ParticleEmitter")
-- Colore costante
emitter.Color = ColorSequence.new(Color3.fromRGB(255, 0, 40))
-- Sequenza di gradiente
emitter.Color = ColorSequence.new{
ColorSequenceKeypoint.new(0, Color3.fromRGB(255, 0, 0)),
ColorSequenceKeypoint.new(0.5, Color3.fromRGB(255, 125, 0)),
ColorSequenceKeypoint.new(1, Color3.fromRGB(255, 200, 0))
}Dimensione
La proprietà Size imposta la dimensione di ogni particella a una dimensione costante o a una sequenza numerica durante la sua durata.
In uno script, imposta un NumberSequence per la proprietà Size dell'emittente:
local emitter = Instance.new("ParticleEmitter")
-- Dimensione costante
emitter.Size = NumberSequence.new(3)
-- Sequenza numerica
emitter.Size = NumberSequence.new{
NumberSequenceKeypoint.new(0, 1),
NumberSequenceKeypoint.new(0.2, 4),
NumberSequenceKeypoint.new(1, 0)
}Trasparenza
La proprietà Transparency imposta l'opacità di ogni particella come un valore costante o come una sequenza di opacità durante la sua durata. L'opacità può variare da 0 (totalmente opaco) a 1 (completamente trasparente). Per dettagli su come impostare le particelle a un'opacità specifica o a una sequenza numerica, segui il processo di personalizzazione della Dimensione ma utilizza il campo della proprietà Transparency dell'emittente.
Durata
La proprietà Lifetime imposta la durata di una particella in secondi. Puoi impostare questa proprietà sia come un valore costante, sia fornire un intervallo Min e Max da cui verrà scelta una durata casuale per ogni particella.
Velocità
La proprietà Speed determina un intervallo casuale di velocità (minimo e massimo) a cui verranno emesse nuove particelle, misurato in stud al secondo. La velocità di ogni particella viene scelta al momento dell'emissione e si applica nella EmissionDirection. I valori negativi fanno sì che le particelle viaggino all'indietro.
Nota che cambiare Speed non influisce sulle particelle attive e esse mantengono la velocità che già hanno. Tuttavia, Acceleration, Drag e VelocityInheritance possono essere utilizzati per influenzare la velocità delle particelle attive durante la loro durata.
Frequenza
La proprietà Rate imposta il numero di particelle che si emettono al secondo. Un singolo emittente di particelle può creare fino a 400 particelle al secondo (100 al secondo su mobile). Per le migliori prestazioni, mantieni la frequenza delle particelle il più bassa possibile e sperimenta con la dimensione e altre proprietà per ottenere l'effetto visivo desiderato.
Orientamento
La proprietà Orientation determina quale modalità di orientamento utilizzare per la geometria delle particelle di un emittente.
| Orientamento | Comportamento delle particelle |
|---|---|
| FacingCamera | Quad standard che guarda la fotocamera; comportamento predefinito. |
| FacingCameraWorldUp | Guarda la fotocamera, ma ruotando solo sull'asse verticale verso l'alto del mondo Y. |
| VelocityParallel | Allineato parallelamente alla loro direzione di movimento. |
| VelocityPerpendicular | Allineato perpendicolarmente alla loro direzione di movimento. |
LightEmission
La proprietà LightEmission determina la fusione dei colori delle particelle Texture con i colori dietro di esse. Un valore di 0 utilizza la modalità di fusione normale mentre un valore di 1 utilizza la fusione additiva. Valori più alti possono far brillare le particelle anche in ambienti con scarsa illuminazione.
SpreadAngle
La proprietà SpreadAngle ha un valore X e un valore Y che determinano l'intervallo di angoli da cui una particella può emettere. L'intervallo è calcolato da entrambi i lati attorno agli assi; ad esempio, un valore di (45, 0) emette particelle in un intervallo da 0° a 45° lontano dalla EmissionDirection lungo l'asse X.
WindAffectsDrag
Se hai abilitato il vento globale in un gioco, le particelle seguiranno il vettore del vento globale finché la proprietà WindAffectsDrag dell'emittente è abilitata e la sua proprietà Drag è maggiore di 0.
Forma
La proprietà Shape imposta la forma dell'emittente di particelle su Box, Sphere, Cylinder o Disc.
Dopo aver selezionato una forma per il tuo emittente di particelle, puoi sperimentare con le proprietà ShapeStyle, ShapeInOut e ShapePartial per personalizzare ulteriormente l'emissione delle particelle.
ShapeStyle
La proprietà ShapeStyle imposta il tipo di emissione su:
- Volume — Le particelle si emettono ovunque all'interno della forma.
- Surface — Le particelle si emettono solo dall'esterno della forma.
ShapeInOut
La proprietà ShapeInOut imposta l'emissione come segue:
- Inward — Le particelle si emettono verso la forma.
- Outward — Le particelle si emettono lontano dalla forma.
ShapePartial
La proprietà ShapePartial è un fattore che puoi utilizzare per modificare ulteriormente le forme Cylinder, Disc e Sphere.
Per i cilindri, ShapePartial moltiplica il raggio del cilindro sul lato della sua EmissionDirection.


Schiacciamento
La proprietà Squash consente una scalatura non uniforme delle particelle, controllata dalla curva durante la loro durata. Valori superiori a 0 fanno sì che le particelle si restringano orizzontalmente e crescano verticalmente, mentre valori inferiori a 0 fanno sì che le particelle crescano orizzontalmente e si restringano verticalmente. Per dettagli su come impostare la quantità di schiacciamento a un valore costante o a un NumberSequence, segui il processo di personalizzazione della Dimensione ma utilizza il campo della proprietà Squash dell'emittente.
Lo schiacciamento è particolarmente utile per la pioggia. Allungare una particella rende la sua texture molto meno riconoscibile, quindi anche la texture di scintilla predefinita può sembrare una goccia di pioggia che cade. Per dettagli, vedere simulare la pioggia.
Flipbook
Le texture flipbook delle particelle ti consentono di animare la texture di una particella durante la sua durata.
La texture flipbook può avere un layout di frame di 2×2, 4×4, 8×8 o personalizzato. Ad esempio, la seguente immagine 1024×1024 ha un layout 8×8, quindi è adatta per un'animazione a 64 frame.

Una volta specificata una texture flipbook valida texture per la proprietà Texture dell'emittente, la proprietà FlipbookLayout determina il layout della texture. Può essere qualsiasi valore dell'enumerazione Enum.ParticleFlipbookLayout:
- None — Disabilita le funzionalità flipbook e utilizza la texture come una singola texture statica durante la durata della particella.
- Grid2x2 — 2×2 frame per un'animazione a 4 frame.
- Grid4x4 — 4×4 frame per un'animazione a 16 frame.
- Grid8x8 — 8×8 frame per un'animazione a 64 frame.
Per personalizzare ulteriormente il comportamento del flipbook, puoi regolare le seguenti proprietà:
La proprietà FlipbookFramerate determina quanto velocemente la texture flipbook si anima in frame al secondo. Come Lifetime, puoi impostare un intervallo minimo e massimo per randomizzare il frame rate del flipbook, con un massimo di 30 frame al secondo.
Altre proprietà
Per personalizzare ulteriormente le particelle, considera le seguenti proprietà dell'emittente e clicca per ulteriori dettagli sulla pagina di riferimento ParticleEmitter.
Le seguenti proprietà di aspetto si aggiungono a colore, emissione di luce, orientamento, dimensione, texture, trasparenza, schiacciamento e flipbook.
| Proprietà | Descrizione |
|---|---|
| LightInfluence | Determina quanto la luce ambientale influisce sul colore delle singole particelle. |
| Brightness | Scala la luce emessa dall'emittente quando LightInfluence è 0. |
| ZOffset | Determina la posizione di rendering avanti-indietro delle particelle, in stud, senza cambiare la loro dimensione sullo schermo. Questo consente di sovrapporre più emittenti o di rendere le particelle davanti o dietro l'oggetto genitore. |
Simulare la pioggia
Simulare ogni goccia di pioggia non è pratico, ma gli emittenti di particelle possono creare un'illusione convincente di pioggia in un mondo 3D:
Inserisci un Part sopra l'area in cui vuoi che cada la pioggia. Ancoralo, imposta la sua Transparency a 1 e disabilita CanCollide.
Inserisci un ParticleEmitter nel pezzo e imposta la sua EmissionDirection su Bottom. Un singolo emittente può creare un numero limitato di particelle al secondo (vedi Frequenza), quindi una pioggia più intensa o un'area più grande richiede molti pezzi con emittenti disposti in una griglia sopra l'area desiderata.
Imposta Squash su un valore positivo, come 3, per allungare ogni particella in una striscia. Valori più alti rendono le particelle più sottili, quindi potresti dover aumentare anche la dimensione.
Scurire Color, aumentare LightInfluence in modo che la pioggia reagisca all'illuminazione circostante, aumentare Speed e diminuire Lifetime in modo che le particelle scompaiano vicino al suolo.
Per inclinare la pioggia, imposta una piccola Rotation o abilita WindAffectsDrag in modo che le particelle seguano il vento globale. Drag rallenta la caduta oltre ad applicare il vento, quindi potresti dover aumentare l'Acceleration verso il basso per mantenere la pioggia che cade rapidamente.
Per mostrare la pioggia che atterra, posiziona parti trasparenti a terra con emittenti la cui EmissionDirection è Top. Le particelle di schizzo non sono allungate come la pioggia che cade, quindi di solito necessitano di una texture personalizzata e di una sequenza di trasparenza che fa apparire ogni schizzo come se si dissipasse. Gli schizzi sembrano giusti solo su superfici dove le hai posizionate con attenzione. Se non puoi posizionarli a mano, la nebbia bassa è molto più indulgente.
Gestire i limiti delle particelle
La pioggia che copre una grande area raggiunge rapidamente i limiti delle particelle, e i dispositivi mobili hanno limiti molto più bassi rispetto ai desktop. Se le particelle lampeggiano in lontananza, riduci il numero di particelle sullo schermo contemporaneamente:
- Posiziona i pezzi emittenti più in basso nell'aria e accorcia Lifetime per adattarli.
- Diminuisci Rate per trasformare un acquazzone in una leggera pioggia.
- Copri un'area più piccola con meno pezzi emittenti.
Esempi di pioggia
- Per un esempio costruito a mano, vedere Il Mistero di Duvall Drive. Utilizza emittenti per pioggia, nebbia, schizzi e acqua che gocciola dai cornicioni.
- Per un esempio scriptato, vedere il progetto weather-island. Pianifica tempeste, transizioni nuvole e vento, genera emittenti di pioggia e nebbia e esegue il rilevamento dei tetti.





