BillboardGui
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
BillboardGui è un container per gli oggetti UI da apparire nello spazio 3D ma sempre di fronte alla Telecamera.La posizione del container è relativa al genitore BasePart o Attachment (o al Adornee ).Per BaseParts , viene utilizzata la proprietà Position , mentre per Attachments , viene utilizzata la proprietà WorldPosition.

La proprietà di un cartellone pubblicitario Size funziona leggermente in modo diverso da GuiObject.Size .Mentre i componenti di offset lavorano allo stesso modo, i componenti di scala vengono utilizzati come dimensioni degli studs nello Spazio3D.
Quando si crea una dimensione scala BillboardGui che contiene un TextLabel , è utile abilitare la proprietà del EtichettaTextScaled in modo che il suo testo scala insieme alla canvas del billboard come la distanza della fotocamera cambia.
Nota che gli elementi interattivi dell'interfaccia utente come ImageButtons e TextButtons all'interno di un BillboardGui riceveranno solo l'input dell'utente se sono parentedati al PlayerGui , tipicamente posizionando il BillboardGui all'interno di StarterGui .La proprietà Adornee può essere utilizzata per mirare a una parte o un allegato nel mondo 3D mentre la BillboardGui stessa rimane nel PlayerGui .
Vedi Interfaccia utente in-experience per una guida su come lavorare con BillboardGui.
Comportamento di cacheggiatura
Per aiutare a migliorare le Prestazione, l'aspetto di un BillboardGui viene memorizzato fino a quando uno dei seguenti eventi non si verifica, dopo di cui il suo aspetto verrà ricomputato sul prossimo frame di rendering.
- Un discendente viene aggiunto o rimosso dal BillboardGui .
- Una proprietà di un discendente delle modifiche di BillboardGui .
- Una proprietà del BillboardGui stesso cambia.
Sommario
Proprietà
Controlla se i discendenti riceveranno eventi di input.
Imposta la parte o l'allegato target a cui la BillboardGui è posizionata rispetto.
Determina se il BillboardGui sarà sempre reso in cima ad altri oggetti 3D.
Determina il fattore con cui la luce del contenitore BillboardGui viene scala quando LightInfluence è 0 .
Se saranno disegnate porzioni di GuiObjects che cadono al di fuori dei confini della tela BillboardGui .
La distanza attuale in studs da cui il BillboardGui è dalla Telecameradel Giocatore.
Determina la distanza in studs in cui il BillboardGui smetterà di ridimensionare più grande.
Determina gli incrementi di dimensioni CurrentDistance e diminuzioni in studs mentre la fotocamera del Giocatoresi avvicina e allontana ulteriormente dal BillboardGui.
Determina la distanza in studs in cui il BillboardGui smetterà di ridimensionare più piccolo.
Determina come il BillboardGui è spostato dal suo Adornee , rispetto all'orientamento Camera , in unità a metà delle dimensioni della Quadro di selezionedi confine modello Camera allineata.
Determina come il BillboardGui è spostato dal suo Adornee , rispetto agli assi globali, in unità a metà delle dimensioni della Quadro di selezionedi confine allineata sull'asse del modello.
Controlla quanto il BillboardGui è influenzato dalla luce ambientale.
Controlla quanto lontano il BillboardGui può essere visualizzato prima di smettere di rendere.
Utilizzato dagli script per nascondere il BillboardGui da un Giocatorespecifico.
Controlla la dimensione che il BillboardGui avrà sullo schermo.
Un offset 2D in unità relative alla dimensione che funge da punto di ancoraggio.
Determina come il BillboardGui viene spostato dal suo Adornee in studs, rispetto all'orientamento Camera.
Determina come il BillboardGui è spostato dal suo Adornee in studs, rispetto agli assi globali.
Attiva/disattiva la visibilità di questo LayerCollector .
Determina se le LayerCollector resets (si auto-elimina e si replica nel personaggio del giocatore PlayerGui ) ogni volta che il personaggio del Giocatorerespawna.
Controlla come GuiObject.ZIndex si comporta su tutti i discendenti di questo LayerCollector .
Descrive la posizione effettiva dello schermo di un elemento GuiBase2d in pixel.
Descrive la rotazione effettiva dello schermo di un elemento GuiBase2d in gradi.
Descrive la dimensione effettiva dello schermo di un elemento GuiBase2d , in pixel.
Quando è impostato su true , la localizzazione verrà applicata a questo GuiBase2d e ai suoi discendenti.
Un riferimento a un LocalizationTable da utilizzare per applicare la localizzazione automatizzata a questo GuiBase2d e ai suoi discendenti.
Personalizza il comportamento di selezione del gamepad nella direzione down.
Personalizza il comportamento di selezione del gamepad nella direzione sinistra.
Personalizza il comportamento di selezione del gamepad nella direzione giusta.
Personalizza il comportamento di selezione del gamepad nella direzione up.
Consente la personalizzazione del movimento di selezione del gamepad.
Metodi
Eventi
Eventi provenienti da GuiBase2d- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Si accende quando la selezione del gamepad si sposta, lascia o cambia all'interno del connesso GuiBase2d o di qualsiasi discendente GuiObjects .
Proprietà
Active
Controlla se i discendenti riceveranno eventi di input.Se il contiene un , quel pulsante diventerà cliccabile solo se è impostato su su entrambi il pulsante e il pulsante.
Nota che gli elementi interattivi dell'interfaccia utente come ImageButtons e TextButtons all'interno di un BillboardGui riceveranno solo l'input dell'utente se sono parentedati al PlayerGui , tipicamente posizionando il BillboardGui all'interno di StarterGui .La proprietà Adornee può essere utilizzata per mirare a una parte o un allegato nel mondo 3D mentre la BillboardGui stessa rimane nel PlayerGui .
Adornee
Imposta l'obiettivo BasePart o Attachment che il BillboardGui è posizionato rispetto al quale, sostituendo la parte o l'allegato padre.
AlwaysOnTop
Questa proprietà determina se il BillboardGui renderizzerà sempre sopra gli altri oggetti 3D.
Quando è impostato su false (predefinito), il BillboardGui rende come altri contenuti 3D e viene occluso da altri oggetti 3D.Quando è impostato su true , il BillboardGui rende sempre sopra il contenuto 3D e le modifiche dell'aspetto cambiano notevolmente:
- I colori corrispondono a come appaiono all'interno di un ScreenGui .
- Il testo può apparire più nitido su dispositivi DPI elevati.
- LightInfluence viene trattato come se fosse 0 .
- Brightness non ha alcun effetto.
Brightness
Questa proprietà determina il fattore con cui la luce del contenitore BillboardGui viene ridimensionata quando LightInfluence è 0.Per impostazione predefinita, questa proprietà è 1 e può essere impostata a qualsiasi numero tra 0 e 1000.Modificando questa Proprietà, l'apparente luminosità di un BillboardGui può essere meglio abbinata al suo Ambiente.Ad esempio, un video billboard può essere illuminato all'interno di una stanza buia aumentando Brightness a 10 .
Nota che Brightness non è accessibile in Studio e non ha alcun effetto quando LightInfluence è 1 o AlwaysOnTop è true .
ClipsDescendants
Quando è impostato su true (predefinito), le porzioni di GuiObjects che cadono al di fuori dei confini della tela BillboardGui non verranno disegnate.
Anche quando questa proprietà è false , GuiObjects quelle che sono completamente fuori dalla tela non verranno Renderizzare.
CurrentDistance
La distanza attuale in studs da cui il BillboardGui è dalla Telecameradel Giocatore.Un evento modificato non si attiva per questa proprietà a meno che DistanceStep non sia più di 0.
DistanceLowerLimit
Determina la distanza in studs in cui il BillboardGui smetterà di ridimensionare più grande rispetto alla Telecameraattuale del Giocatore, con un valore predefinito di 0 .Se il CurrentDistance del BillboardGui è al di sotto di questo valore, non si scalerà più grande di quanto sarebbe a questa distanza DistanceLowerLimit.
DistanceStep
Determina gli incrementi di dimensioni CurrentDistance e diminuzioni in studs mentre la fotocamera del Giocatoresi avvicina e allontana ulteriormente dal BillboardGui.La proprietà predefinita è 0 e arrotonda a partire da DistanceLowerLimit .
DistanceUpperLimit
Determina la distanza in studs in cui il BillboardGui smetterà di ridimensionare più piccolo rispetto alla Telecameraattuale del Giocatore.Se il CurrentDistance del BillboardGui è superiore a questo valore, non si ridimensionerà in modo minore di quanto lo sarebbe a questa distanza DistanceUpperLimit.
Questa proprietà viene ignorata se il valore è inferiore a 0 . Il valore predefinito è -1 , il che significa che la proprietà viene ignorata per impostazione predefinita.
ExtentsOffset
Questa proprietà determina come il BillboardGui sia spostato dal suo Adornee , rispetto all'orientamento Camera , in unità a metà delle dimensioni della Quadro di selezionedi confine modello Camera allineata.
Vedi anche StudsOffset che funziona in modo simile ma utilizza unità di stud, o ExtentsOffsetWorldSpace che funziona in modo simile ma l'orientamento di spostamento è relativo agli assi globali.
ExtentsOffsetWorldSpace
Questa proprietà determina come il BillboardGui venga spostato dal suo Adornee , rispetto agli assi globali, in unità a metà delle dimensioni della Quadro di selezionedi confine allineata sull'asse del modello.
Vedi anche che funziona in modo simile ma utilizza unità di stud, o che funziona in modo simile ma l'orientamento di spostamento è relativo al ].
LightInfluence
Controlla quanto il BillboardGui è influenzato dalla luce ambientale, in un intervallo da 0 a 1 .Impostare questo a 1 significa che la luce circostante ha il completo controllo sull'aspetto, mentre impostarlo a 0 significa che la luce non ha alcun effetto.
MaxDistance
Questa proprietà controlla quanto lontano dalla fotocamera verrà visualizzato BillboardGui prima che smetta di rendere.Un valore di 0 o inf (predefinito) significa che non c'è alcun limite e si renderà infinitamente lontano.
Per BillboardGuis quelli che appaiono all'aperto, è consigliato che MaxDistance sia abbastanza alto per garantire che l'interfaccia utente del contenitore sia sufficientemente piccola sullo schermo quando appare o scompare, minimizzando l'effetto pop-in/out improvviso.
PlayerToHideFrom
Utilizzato dagli script per nascondere il BillboardGui da un Giocatorespecifico.
Per nascondere un BillboardGui da più di un Giocatore, posizionalo in StarterGui e usa uno script per impostare la proprietà Enabled in base a se il LocalPlayer dovrebbe essere in grado di vederlo.La proprietà Adornee può essere utilizzata per attaccare il BillboardGui a un BasePart o Attachment nel Workspace , invece di genitorializzarlo.
Size
Controlla la dimensione che il BillboardGui avrà sullo schermo.A differenza di GuiObject.Size , i componenti scala di questo set di proprietà impostano la dimensione degli stud della billboard nello Spazio3D.
SizeOffset
Un offset 2D in unità relative alla dimensione che funge da punto di ancoraggio.Questo può essere utilizzato in modo simile alla ProprietàGuiObject.AnchorPoint, ma i valori sono diversi.
<tbody><tr><td><code>0, 0</code></td><td>Il predefinito in cui l'interfaccia utente sarà ancorata al suo centro.</td></tr><tr><td><code>0.5, 0.5</code></td><td>L'interfaccia utente si ancorerà in basso a sinistra.</td></tr><tr><td><code>0.5, -0.5</code></td><td>L'interfaccia utente si ancorerà in alto a sinistra.</td></tr><tr><td><code>-0.5, 0.5</code></td><td>L'interfaccia utente si ancorerà in alto a destra.</td></tr><tr><td><code>-0.5, -0.5</code></td><td>L'interfaccia utente si ancorerà in basso a destra.</td></tr></tbody>
Offset di dimensione | Spiegazione |
---|
Vedi anche StudsOffset , StudsOffsetWorldSpace , ExtentsOffset e ExtentsOffsetWorldSpace , che sono proprietà di compensazione che funzionano nello spazio 3D invece.
StudsOffset
Questa proprietà determina come il BillboardGui venga spostato dal suo Adornee in studs, rispetto all'orientamento Camera.
Vedi anche StudsOffsetWorldSpace che funziona in modo simile, tranne che l'orientamento di spostamento è relativo agli assi globali.
StudsOffsetWorldSpace
Questa proprietà determina come il BillboardGui viene spostato dal suo Adornee in studs, rispetto agli assi globali.
Vedi anche StudsOffset che funziona in modo simile, tranne che l'orientamento di spostamento è relativo al Camera .