SurfaceGui
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
SurfaceGui consente il rendering di oggetti UI sulla superficie di una parte nel mondo 3D mentre consente anche che si Si verificanol'interazione utente di base.Simile a e , gli oggetti dell'interfaccia utente come e sono parenti con una superficie, modificabili attraverso la Proprietà.

Si noti che gli elementi dell'interfaccia utente interattiva come ImageButtons e TextButtons all'interno di un SurfaceGui riceveranno solo l'input dell'utente se sono parentedati al PlayerGui , tipicamente posizionando il SurfaceGui all'interno di StarterGui (la proprietà Adornee può essere utilizzata per targetare una parte nel mondo 3D mentre il SurfaceGui stesso rimane nel PlayerGui ).Inoltre, la proprietà della parte CanQuery deve essere true per l'elemento interattivo dell'interfaccia utente di ricevere l'input.
Vedi Interfaccia utente in-experience per una guida su come lavorare con SurfaceGui.
Comportamento di cacheggiatura
Per aiutare a migliorare le Prestazione, l'aspetto di un SurfaceGui 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 SurfaceGui .
- Una proprietà di un discendente delle modifiche di SurfaceGui .
- Una proprietà del SurfaceGui stesso cambia.
Sommario
Proprietà
Determina se il SurfaceGui sarà sempre reso in cima ad altri oggetti 3D.
Determina il fattore con cui la luce del contenitore SurfaceGui viene scala quando LightInfluence è 0 .
La dimensione di uno "schermo virtuale" in "pixels virtuali" che rende SurfaceGuis pixel-to-pixel compatibile con ScreenGuis .
Se saranno disegnate porzioni di GuiObjects che cadono al di fuori dei confini della tela SurfaceGui .
Controlla quanto il SurfaceGui è influenzato dalla luce ambientale.
Controlla quanto lontano il SurfaceGui può essere visualizzato prima di smettere di rendere.
Determina la densità dei pixel utilizzati per ogni stud spaziale del mondo per rendere i contenuti del SurfaceGui .
Determina se il SurfaceGui renderizzerà a una dimensione fissa o a una scala con la sua dimensione in studs.
Imposta la distanza in cui il clic sinistro inizia ad agire sul SurfaceGui invece di per il tenuto Tool .
Strati questo SurfaceGui in relazione ad altri SurfaceGuis sulla stessa faccia.
BasePart su cui applicare il SurfaceGui , sostituendo l'associazione genitrice predefinita.
Enum.NormalId faccia su cui applicare il SurfaceGui.
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à
AlwaysOnTop
Questa proprietà determina se il SurfaceGui renderizzerà sempre sopra gli altri oggetti 3D.
Quando è impostato su false (predefinito), il SurfaceGui rende come altri contenuti 3D e viene occluso da altri oggetti 3D.Quando è impostato su true , il SurfaceGui 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 SurfaceGui 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 SurfaceGui 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 .
CanvasSize
La dimensione di uno "schermo virtuale" in "pixels virtuali" che rende SurfaceGuis pixel-to-pixel compatibile con ScreenGuis .
ClipsDescendants
Quando è impostato su true (predefinito), le porzioni di GuiObjects che cadono al di fuori dei confini della tela SurfaceGui non verranno disegnate.
Anche quando questa proprietà è false , GuiObjects quelle che sono completamente fuori dalla tela non verranno Renderizzare.
LightInfluence
Controlla quanto il SurfaceGui è 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 SurfaceGui prima che smetta di rendere.Un valore di 0 significa che non c'è alcun limite e si renderà infinitamente lontano.Il valore predefinito di 1000 funziona bene per la maggior parte dei casi.
Per SurfaceGuis 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.
PixelsPerStud
Questa proprietà determina la densità dei pixel utilizzati per ogni stud spaziale del mondo per rendere i contenuti del SurfaceGui .I valori più elevati faranno apparire più piccoli i vari GuiObjects all'interno se vengono mantenuti della stessa dimensione.Al contrario, valori più bassi faranno apparire gli oggetti più grandi.Tuttavia, se i GuiObjects sono scagliati proporzionalmente attraverso l'uso di UIScale , GuiObject.Size , TextLabel.TextSize , o simili, questa proprietà consente di utilizzare una definizione superiore.
È importante selezionare un valore in base a quanto distante si prevede che un giocatore veda il SurfaceGui .Si tenga presente inoltre che una grande densità di pixel potrebbe influenzare negativamente le prestazioni se la faccia della parte adornata è abbastanza grande.
SizingMode
Quando è impostato su Enum.SurfaceGuiSizingMode.PixelsPerStud (predefinito), il SurfaceGui rende con una dimensione variabile in base a PixelsPerStud e alla dimensione della superficie in studs.
Quando è impostato su Enum.SurfaceGuiSizingMode.FixedSize , il SurfaceGui rende con una dimensione fissa impostata attraverso CanvasSize .
ToolPunchThroughDistance
Imposta la distanza in cui il clic sinistro inizia ad agire sul SurfaceGui invece di per il tenuto Tool .Se un personaggio è all'interno di questa distanza di SurfaceGui , il Tool non si attiverà al clic.
ZOffset
Posiziona questo SurfaceGui in relazione agli altri sullo stesso volto (modificare questo non "levanta" o "affonda" visivamente un SurfaceGui dalla superficie).