BillboardGui

Visualizza obsoleti

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

  • Lettura Parallela

    Controlla se i discendenti riceveranno eventi di input.

  • Lettura Parallela

    Imposta la parte o l'accessorio target a cui il BillboardGui è posizionato rispetto.

  • Lettura Parallela

    Determina se la BillboardGui renderà davanti al contenuto 3D o dietro di esso.

  • Lettura Parallela

    Determina il fattore con cui viene ridimensionata la luce della GUI or Intefaccia grafica utentequando LightInfluence è 0.

  • Lettura Parallela

    Quando impostato su true, le parti di GuiObjects che cadono al di fuori dei confini della tela BillboardGui non saranno disegnate.

  • Sola Lettura
    Non Replicato
    Lettura Parallela

    La distanza attuale in studs che il BillboardGui è dalla Telecameradel Giocatore.

  • Lettura Parallela

    Determina la distanza in studs che un BillboardGui smetterà di ridimensionare più grande.

  • Lettura Parallela

    La distanza sarà arrotondata per gli incrementi di questo valore.

  • Lettura Parallela

    Determina la distanza in studs che un BillboardGui smetterà di ridimensionare più piccolo.

  • Lettura Parallela

    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.

  • Lettura Parallela

    Controlla quanto il BillboardGui è influenzato dalla luce Ambiente.

  • Lettura Parallela

    Imposta la distanza massima che un bilboard può essere dalla fotocamera e essere ancora disegnato.

  • Lettura Parallela

    Utilizzato dagli script per nascondere il BillboardGui da un Giocatorespecifico.

  • Lettura Parallela

    Controlla la dimensione che la BillboardGui avrà sullo schermo.

  • Lettura Parallela

    Un offset 2D in unità di dimensioni che agisce come punto di ancoraggio.

  • Lettura Parallela

    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.

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

Lettura Parallela

Imposta la parte o l'accessorio target a cui il BillboardGui è posizionato rispetto. Se nessun Adornee è Impostare, allora il Parent viene utilizzato invece.

AlwaysOnTop

Lettura Parallela

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:

Brightness

Lettura Parallela

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

Lettura Parallela

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

Sola Lettura
Non Replicato
Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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:

LightInfluence

Lettura Parallela

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

Lettura Parallela

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 Caricare
task.wait(5)
-- Dichiarare e inizializzare gli oggetti
local camera = workspace.CurrentCamera
local part = Instance.new("Part")
local billboard = Instance.new("BillboardGui")
local label = Instance.new("TextLabel")
-- Imposta il tipo di inserisci / scrivi
camera.CameraType = Enum.CameraType.Scriptable
-- Imposta la posizione della parte e blocca in Posto
part.CFrame = CFrame.new(0, 10, 0)
part.Anchored = true
-- Imposta il tabellone
billboard.MaxDistance = 10
billboard.Adornee = part
billboard.AlwaysOnTop = true
billboard.Size = UDim2.fromOffset(50, 50)
-- Configura l'Etichetta
label.Size = UDim2.fromScale(1, 1)
-- Imposta i genitori degli oggetti
label.Parent = billboard
billboard.Parent = part
part.Parent = workspace
-- Sposta la telecamera vicino alla parte. Attendere un po 'e poi spostare la Telecamera
local 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 qui
task.wait(2)
camera.CFrame = CFrame.lookAt(cameraPosition1, part.Position)
-- Contents of billboard will no longer be visible (outside MaxDistance)

PlayerToHideFrom

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Metodi

Eventi