BillboardGui

Visualizza obsoleti

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

BillboardGui with a TextLabel describing the screen console it floats above.

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.

Sommario

Proprietà

Proprietà provenienti da LayerCollectorProprietà provenienti da GuiBase2d

Eventi

Eventi provenienti da GuiBase2d

Proprietà

Active

Lettura Parallela

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

Lettura Parallela

Imposta l'obiettivo BasePart o Attachment che il BillboardGui è posizionato rispetto al quale, sostituendo la parte o l'allegato padre.

AlwaysOnTop

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Sola Lettura
Non Replicato
Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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 dimensioneSpiegazione

Vedi anche StudsOffset , StudsOffsetWorldSpace , ExtentsOffset e ExtentsOffsetWorldSpace , che sono proprietà di compensazione che funzionano nello spazio 3D invece.

StudsOffset

Lettura Parallela

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

Lettura Parallela

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 .

Metodi

Eventi