BillboardGui
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
BillboardGuis sono container per GuiObjects che appaiono nello Spazio3D. BillboardGuis si affronta sempre con la Telecamera, e può cambiare la dimensione con la distanza o rimanere la stessa dimensione sullo schermo in base alla proprietà BillboardGui.Size .
La loro posizione è relativa alla BillboardGui.Adornee . Se nessun Adornee è Impostare, allora il padre del BillboardGui sarà utilizzato come adornee. Per BaseParts , la proprietà Position
La proprietà Size di un BillboardGui funziona leggermente diversamente da GuiObject.Size . La parte Offset funziona allo stesso modo, ma la parte Scale viene utilizzata come dimensione in studs nello Spazio3D.
Un'area di UDim2.fromScale(4, 5) ha 4x5 studs, e ingrandisce l'interfaccia utente più grande e più piccola a seconda della distanza dalla Telecamera. Un'area di UDim2.fromOffset(200, 100) ha sempre 200x100 sullo schermo, e
Durante la creazione di BillboardGuis, è importante assicurarsi che tutti gli oggetti UI all'interno stiano usando Scale sizing e che tutto il testo abbia TextLabel.TextScaled abilitato, per garantire lo scalaggio corretto.
La proprietà AbsolutePosition di un BillboardGui e tutti i suoi discendenti è relativa all'angolo in alto a sinistra del suo canvas, e quindi è sempre 0, 0 per l'esempioBillboardGui.
Caching UI Statico per le prestazioni
L'aspetto di un Gui viene memorizzato fino a quando uno dei seguenti eventi non si verifica:
- Un discendente viene aggiunto alla Gui.
- Un discendente viene rimosso dalla Gui.
- Una proprietà di un discendente della Gui cambia.
- Una proprietà della Gui cambia.
Se uno qualsiasi di questi eventi si Si verificano, l'aspetto della Gui sarà recomputato nel prossimo frame in cui viene visualizzata.
Sommario
Proprietà
Controlla se i discendenti riceveranno eventi di input.
Imposta la parte o l'accessorio target a cui il BillboardGui è posizionato rispetto.
Determina se la BillboardGui renderà davanti al contenuto 3D o dietro di esso.
Determina il fattore con cui viene ridimensionata la luce della GUI or Intefaccia grafica utentequando LightInfluence è 0.
Quando impostato su true, le parti di GuiObjects che cadono al di fuori dei confini della tela BillboardGui non saranno disegnate.
La distanza attuale in studs che il BillboardGui è dalla Telecameradel Giocatore.
Determina la distanza in studs che un BillboardGui smetterà di ridimensionare più grande.
La distanza sarà arrotondata per gli incrementi di questo valore.
Determina la distanza in studs che un BillboardGui smetterà di ridimensionare più piccolo.
Determina il modo in cui il BillboardGui è offset dal suo Adornee , rispetto all'orientamento e alle unità Camera -allineate, sono la metà delle dimensioni del modello's Camera Quadro di selezionediagonale.
Determina il modo in cui il BillboardGui è offset dal suo Adornee , rispetto alle globali assi e unità sono la metà delle dimensioni della Quadro di selezionedi limitazione dell'asse allineato del modello.
Controlla quanto il BillboardGui è influenzato dalla luce Ambiente.
Imposta la distanza massima che un bilboard può essere dalla fotocamera e essere ancora disegnato.
Utilizzato dagli script per nascondere il BillboardGui da un Giocatorespecifico.
Controlla la dimensione che la BillboardGui avrà sullo schermo.
Un offset 2D in unità di dimensioni che agisce come punto di ancoraggio.
Determina il modo in cui il BillboardGui è offset dal suo Adornee , rispetto all'orientamento e alle unità in studs.
Determina il modo in cui il BillboardGui è offset dal suo Adornee , rispetto agli assi e alle unità globali in studs.
Attiva/disattiva la visibilità di questo LayerCollector .
Determina se il LayerCollector resets (deletes itself and re-clones into the Giocatore's PlayerGui ) ogni volta che il personaggio del Giocatorerespawna.
Controlla il modo in cui GuiObject.ZIndex si comporta su tutti i discendenti di questo LayerCollector .
Descrive la posizione reale dello schermo di un elemento UI, in pixel.
Descrive la rotazione dell'interfaccia utente reale, in gradi.
Descrive la dimensione reale dello schermo di un elemento UI, in pixel.
Quando impostato su true, la localizzazione sarà applicata a questo GuiBase2d e ai suoi discendenti.
Un riferimento a un LocalizationTable per essere utilizzato per applicare la localizzazione automatica a questo GuiBase2d e ai suoi discendenti.
Personalizza il comportamento della selezione del gamepad nella direzione in cui si muove verso il basso.
Personalizza il comportamento di selezione del gamepad nella direzione di sinistra.
Personalizza il comportamento della selezione del gamepad nella direzione giusta.
Personalizza il comportamento della selezione del gamepad nell'area di direzione up.
Consente la personalizzazione della selezione del gamepad.
Metodi
Eventi
Eventi provenienti da GuiBase2d- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Si attiva quando la selezione del gamepad si muove, si lascia o cambia all'interno della GuiBase2d connessa o di qualsiasi altro GuiObjects.
Proprietà
Active
Controlla se i discendenti riceveranno eventi di input. Se l'interfaccia utente contiene un GuiButton allora quel pulsante diventerà cliccabile solo se Active è impostato su true sia sul BillboardGui che sul pulsante.
BillboardGuis riceverà solo l'input dell'utente se è parented al PlayerGui. La proprietà BillboardGui.Adornee può essere utilizzata per mirare a una parte nell'area di lavoro mentre l'interfaccia utente stessa è in PlayerGui .
Adornee
Imposta la parte o l'accessorio target a cui il BillboardGui è posizionato rispetto. Se nessun Adornee è Impostare, allora il Parent viene utilizzato invece.
AlwaysOnTop
Determina se la BillboardGui renderà sopra il 3D content, o sarà oscurata da esso.
Quando impostato su false, il BillboardGui renderà come altri contenuti 3D e sarà occluso da altri oggetti 3D.
Quando impostato su true, si rende sempre sopra il 3D content, e l'aspetto cambia notevolmente:
- I colori corrispondono a come appaiono all'interno di un ScreenGui .
- Il testo potrebbe apparire più tagliente su dispositivi DPI ad alta risoluzione.
- BillboardGui.LightInfluence è trattato come se fosse 0.
- BillboardGui.Brightness non ha effetto.
Brightness
Luminosità determina il fattore con cui la luce emessa dalla GUI or Intefaccia grafica utenteviene ridimensionata. Per impostazione predefinita, questa proprietà è 1 e può essere impostata su qualsiasi numero sulla gamma [0, 1000].
Modificando questa Proprietà, la luce apparente di un'interfaccia utente può essere meglio abbinata al suo Ambiente. Ad esempio, un video billboard come quelli trovati in Times Square può essere reso più luminoso per essere chiaramente visibile in un giorno soleggiato.
Questa proprietà non produrrà alcun effetto nei seguenti scenari in cui la GUI non emette luce.:
- Quando AlwaysOnTop è vero, il colore di ciascun pixel è il colore mostrato sullo schermo.
- Quando LightInfluence è 1, tutta la luce dalla GUI viene riflessa dall'ambiente invece di essere emessa.
ClipsDescendants
Quando impostato su true, le parti di GuiObjects che cadono al di fuori dei confini della tela BillboardGui non saranno disegnate.
Anche quando questa proprietà è falsa, gli oggetti che sono completamente al di fuori della tela della BillboardGui non saranno Renderizzare.
CurrentDistance
La distanza attuale in studs che il BillboardGui è dalla Telecameradel Giocatore. Un evento cambiato non viene attivato per questa proprietà a meno che il gui's BillboardGui.DistanceStep non sia più di 0.
DistanceLowerLimit
Determina la distanza in studs che un BillboardGui smetterà di ridimensionare in dimensioni rispetto alla Telecameraattuale del Giocatore. Se la distanza del gui è inferiore a questo valore, non sarà ridimensionata più di quanto sarebbe in questa distanza. Il valore di questa proprietà predefinito è 0 studs.
DistanceStep
Determina gli incrementi e i diminui BillboardGui.CurrentDistance dei studs man mano che la fotocamera del Giocatoresi avvicina e si allontana dalla BillboardGui . La proprietà predefinita è 0 e arrotonda a partire dal BillboardGui.DistanceLowerLimit .
Ad esempio, se questa proprietà è impostata su 0,5 e la fotocamera del Giocatoresi sta allontanando dalla gui inizialmente da 0 allora CurrentDistance aumenterà 0 -> 0,5 -> 1 -> 1,5 -> ... e così via.
DistanceUpperLimit
Determina la distanza in studs che un BillboardGui fermerà l'aggiustamento in dimensioni minori rispetto alla Telecameraattuale del Giocatore. Se la distanza del gui è superiore a questo valore, non sarà aggiustata in dimensioni minori di quanto sarebbe in questa distanza.
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
ExtentsOffset determina il modo in cui il BillboardGui è偏移 dal suo Adornee , rispetto all'orientamento e alle unità Camera -allineata la Quadro di selezionedi limitazione del modello.
Vedi anche:
- ExtentsOffsetWorldSpace , che funziona in modo simile ad eccezione dell'orientamento dell'Offset WorldSpace
- StudsOffset , che funziona allo stesso modo tranne le unità sono studs
ExtentsOffsetWorldSpace
ExtentsOffsetWorldSpace determina il modo in cui il BillboardGui è偏移 dal suo Adornee , rispetto agli assi e alle unità globali, sono la metà delle dimensioni del modello's axis-aligned bounding Quadro di selezione.
Vedi anche:
- ExtentsOffset , che funziona in modo simile, tranne che l'orientamento dell'Offset è relativo alla Camera
- StudsOffsetWorldSpace , che funziona allo stesso modo a meno che le unità non siano studs
LightInfluence
Controlla quanto il BillboardGui è influenzato dalla luce Ambiente.
Quando impostato su 0, l'interfaccia utente si comporta in modo simile a uno schermo LCD, agendo come sua fonte di luce e apparendo lo stesso indipendentemente dalla luce ambientale.
Quando impostato su 1, l'interfaccia utente si comporta in modo simile a un pezzo di carta, riflettendo solo la luce da un'altra Sorgente.
MaxDistance
La proprietà MaxDistance di un BillboardGui imposta la distanza in cui il cartello può essere dalla fotocamera e essere ancora tratto. Se la fotocamera e il cartello sono spostati più lontano di quanto sia la distanza massima, allora il cartello non sarà visibile indipendentemente da qualsiasi altra proprietà del cartello o oggetto GUI. Il valore predefinito di questa proprietà è l'infinito
Se questo valore è impostato su meno o uguale a 0, la distanza massima sarà trattata come infinita e la pubblicità sarà sempre trascinabile.
Esempio
-- Aspetta che gli script della telecamera/controllo predefiniti si Caricaretask.wait(5)-- Dichiarare e inizializzare gli oggettilocal camera = workspace.CurrentCameralocal part = Instance.new("Part")local billboard = Instance.new("BillboardGui")local label = Instance.new("TextLabel")-- Imposta il tipo di inserisci / scrivicamera.CameraType = Enum.CameraType.Scriptable-- Imposta la posizione della parte e blocca in Postopart.CFrame = CFrame.new(0, 10, 0)part.Anchored = true-- Imposta il tabellonebillboard.MaxDistance = 10billboard.Adornee = partbillboard.AlwaysOnTop = truebillboard.Size = UDim2.fromOffset(50, 50)-- Configura l'Etichettalabel.Size = UDim2.fromScale(1, 1)-- Imposta i genitori degli oggettilabel.Parent = billboardbillboard.Parent = partpart.Parent = workspace-- Sposta la telecamera vicino alla parte. Attendere un po 'e poi spostare la Telecameralocal cameraPosition0 = part.Position + Vector3.new(0, 0, 10)local cameraPosition1 = part.Position + Vector3.new(0, 0, 20)camera.CFrame = CFrame.lookAt(cameraPosition0, part.Position)-- I contenuti del tabellone saranno visibili quitask.wait(2)camera.CFrame = CFrame.lookAt(cameraPosition1, part.Position)-- Contents of billboard will no longer be visible (outside MaxDistance)
PlayerToHideFrom
Utilizzato dagli script per nascondere il BillboardGui da un Giocatorespecifico.
Per nascondere l'interfaccia utente da più di un Giocatore, posiziona il BillboardGui in StarterGui e usa uno script per impostare la proprietà Class.BillboardGui
Size
Controlla la dimensione che la BillboardGui avrà sullo schermo.
Il componente Scale della dimensione viene interpretato come una dimensione in studs, e l'interfaccia utente si adatta automaticamente con la distanza se vengono utilizzati i valori di scala.
Le parti della scala e dell'Offset vengono aggiuntee insieme e possono essere utilizzate allo stesso tempo.
SizeOffset
Un offset 2D in unità di dimensioni relative che agisce come punto di ancoraggio. Questo può essere utilizzato in modo simile alla ProprietàGuiObject.AnchorPoint, ma i valori sono diversi.
Valori Comuni
| SizeOffset | Spiegazione | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | |
Vedi anche:
- StudsOffset , StudsOffsetWorldSpace , ExtentsOffset , 0> Class.ToolbarGui.ExtentsOffsetWorldSpace|ExtentsOffsetWorldSpace0> , che sono tutte altre proprietà di offset che funzionano nello spazio 3D
StudsOffset
StudsOffset determina il modo in cui il BillboardGui è偏り dal suo Adornee , rispetto all'orientamento con gli unità in studs.
Vedi anche:
- StudsOffsetWorldSpace , che funziona in modo simile ad eccezione dell'orientamento dell'Offset che è relativo agli assi globali
- ExtentsOffset , che funziona allo stesso modo se le unità sono metà delle dimensioni della Quadro di selezionediagonia della modello Camera allineata
StudsOffsetWorldSpace
StudsOffsetWorldSpace determina il modo in cui il BillboardGui è偏移 dal suo Adornee , rispetto agli assi globali con unità in studs.
Vedi anche:
- StudsOffset , che funziona allo stesso modo a meno che l'orientamento dell'Offset non sia relativo alla Camera
- ExtentsOffsetWorldSpace , che funziona allo stesso modo sebbene le unità siano metà delle dimensioni della scatola di fusione del modello