I contenitori UI in gioco ospitano GuiObjects che desideri visualizzare all'interno del mondo 3D del tuo gioco.
- Un SurfaceGui consente il rendering di oggetti UI sulla superficie di un oggetto nel mondo 3D, permettendo anche l'interazione di base da parte dell'utente.
- Un BillboardGui è un contenitore per oggetti UI che appaiono nello spazio 3D ma che affrontano sempre la telecamera.
UI Superficiale
Simile a Decals e Textures, gli oggetti UI come TextLabels e ImageLabels parentati a un SurfaceGui affrontano la stessa direzione della superficie su cui si trovano, modificabile tramite la proprietà SurfaceGui.Face.
Per applicare un SurfaceGui a un BasePart in gioco, basta parentarlo a quell'oggetto e impostare la proprietà SurfaceGui.Face. Gli oggetti UI figli appariranno quindi su quel lato dell'oggetto genitore.
In alternativa, puoi posizionare il SurfaceGui all'interno di un contenitore come StarterGui e poi impostare la sua proprietà Adornee su qualsiasi BasePart, così come il target Face. Impostare Adornee sovrascrive l'associazione diretta al genitore, consentendo maggiore flessibilità nel posizionamento poiché può essere impostato da uno script durante il runtime.
Elementi UI interattivi come ImageButtons e TextButtons all'interno di un SurfaceGui riceveranno input dall'utente solo se sono parentati al PlayerGui del giocatore, tipicamente posizionando il SurfaceGui all'interno di StarterGui come indicato sopra. Inoltre, la proprietà CanQuery dell'oggetto deve essere true affinché l'elemento UI interattivo riceva input.
Per aiutarti a scegliere il lato corretto per un SurfaceGui, fai clic destro sull'oggetto target e seleziona Mostra Indicatore di Orientamento. Questo visualizza un cerchio blu con una F e una linea attaccata al lato Front dell'oggetto, e una freccia verde che punta nella direzione del lato Top dell'oggetto.
Dimensione e posizione
Il "canvas" di un SurfaceGui occupa l'intero Face dell'oggetto genitore o dell'oggetto Adornee. Come prassi consigliata, è raccomandato utilizzare valori di scala per la dimensione e la posizione degli oggetti UI figli come ImageLabels. Puoi anche applicare un UIAspectRatioConstraint ai figli del SurfaceGui per mantenere il loro rapporto d'aspetto desiderato indipendentemente dalla dimensione del lato.
Modalità di occlusione
La proprietà AlwaysOnTop determina se il SurfaceGui verrà visualizzato sopra il contenuto 3D o sarà occluso da esso. Quando impostato su false (predefinito), il SurfaceGui si comporta come altro contenuto 3D ed è occluso da altri oggetti 3D. Quando impostato su true, viene sempre visualizzato sopra il contenuto 3D e non è influenzato dalla luminosità/luce nell'ambiente 3D.
Influenza della luminosità e della luce
Brightness e LightInfluence lavorano insieme per determinare come la luce ambientale influisce sul contenuto UI del SurfaceGui.
Brightness determina il fattore con cui la luce emessa è scalata in un intervallo di 0 a 1000, permettendoti di abbinare il SurfaceGui al suo ambiente. Ad esempio, un cartellone video può essere illuminato all'interno di una stanza buia aumentando Brightness a 10.
LightInfluence controlla quanto il SurfaceGui è influenzato dall'illuminazione nel luogo, in un intervallo da 0 a 1. Impostarlo a 1 significa che l'illuminazione circostante ha il controllo completo sull'aspetto, mentre impostarlo a 0 significa che l'illuminazione non ha alcun effetto.
Nota che Brightness non è accessibile in Studio e non ha effetto quando LightInfluence è 1 o AlwaysOnTop è true.
Visibilità della distanza
MaxDistance controlla quanto lontano dalla telecamera il SurfaceGui verrà visualizzato prima di smettere di renderizzare. Un valore di 0 significa che non c'è limite e verrà renderizzato all'infinito. Il valore predefinito di 1000 funziona bene per la maggior parte dei casi.
Per i SurfaceGuis che appaiono all'aperto, è consigliato che MaxDistance sia sufficientemente alto per garantire che l'UI del contenitore sia sufficientemente piccola sullo schermo quando appare o scompare, minimizzando l'effetto di apparizione/scomparsa improvvisa.
Ordine di visualizzazione
Se esistono più contenitori SurfaceGui sulla stessa faccia, puoi sovrapporli tramite l'indice Z attraverso la loro proprietà ZOffset (cambiare questo non "solleva" o "affonda" visivamente il contenitore dalla superficie).
UI Billboard
Il contenitore BillboardGui visualizza oggetti UI nello spazio 3D ma, a differenza del SurfaceGui, i figli di un BillboardGui affrontano sempre la telecamera. Questo contenitore è utile per visualizzare informazioni frontali sopra oggetti di gioco come misuratori di salute o nomi sopra i personaggi dei giocatori, marcatori per guidare i giocatori verso un oggetto nel mondo 3D e altro ancora.
Per collegare un BillboardGui a un BasePart o Attachment in gioco, basta parentarlo a quell'oggetto o attacco e, se desiderato, regolare la sua dimensione/posizione.
In alternativa, puoi posizionare il BillboardGui all'interno di un contenitore come StarterGui e poi impostare la sua proprietà Adornee su qualsiasi BasePart o Attachment. Questo metodo offre maggiore flessibilità nel posizionamento poiché Adornee può essere impostato da uno script durante il runtime, ad esempio per posizionare un BillboardGui sopra la testa dei personaggi dei giocatori durante il runtime.
Elementi UI interattivi come ImageButtons e TextButtons all'interno di un BillboardGui riceveranno input dall'utente solo se sono parentati al PlayerGui del giocatore, tipicamente posizionando il BillboardGui all'interno di StarterGui come indicato sopra.
Dimensione e posizione
Per la dimensione del billboard, i componenti di scala della proprietà Size impostano la dimensione del billboard in stud nello spazio 3D. Ad esempio, un'impostazione di {10, 0},{2, 0} (UDim2.fromScale(10, 2)) forma un billboard con un rapporto d'aspetto di 10:2 che scala più grande o più piccolo a seconda della sua distanza dalla telecamera.
Per il posizionamento, la proprietà StudsOffset sposta il canvas del billboard sull'asse X (sinistra/destra), asse Y (su/giù) e asse Z (avanti/indietro) rispetto alla telecamera.
Quando crei un BillboardGui scalato in dimensione che contiene un TextLabel, è utile abilitare la proprietà TextScaled dell'etichetta in modo che il suo testo si scaldi insieme al canvas del billboard mentre cambia la distanza dalla telecamera.
Modalità di occlusione
La proprietà AlwaysOnTop determina se il BillboardGui verrà visualizzato sopra il contenuto 3D o sarà occluso da esso. Quando impostato su false (predefinito), il BillboardGui si comporta come altro contenuto 3D ed è occluso da altri oggetti 3D. Quando impostato su true, viene sempre visualizzato sopra il contenuto 3D e non è influenzato dalla luminosità/luce nell'ambiente 3D.
Influenza della luminosità e della luce
Brightness e LightInfluence lavorano insieme per determinare come la luce ambientale influisce sul contenuto UI del BillboardGui.
Brightness determina il fattore con cui la luce emessa è scalata in un intervallo di 0 a 1000, permettendoti di abbinare il BillboardGui al suo ambiente. Ad esempio, un cartellone video può essere illuminato all'interno di una stanza buia aumentando Brightness a 10.
LightInfluence controlla quanto il BillboardGui è influenzato dall'illuminazione nel luogo, in un intervallo da 0 a 1. Impostarlo a 1 significa che l'illuminazione circostante ha il controllo completo sull'aspetto, mentre impostarlo a 0 significa che l'illuminazione non ha alcun effetto.
Nota che Brightness non è accessibile in Studio e non ha effetto quando LightInfluence è 1 o AlwaysOnTop è true.
Visibilità della distanza
MaxDistance controlla quanto lontano dalla telecamera il BillboardGui verrà visualizzato prima di smettere di renderizzare. Un valore di 0 o inf (predefinito) significa che non c'è limite e verrà renderizzato all'infinito.