SurfaceGui
*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.
Consente di rendere gli elementi GUI sulla superficie di una parte nel Mondo3D, mentre consente per l'interazione dell'utente di base per Si verificano. SurfaceGuis deve essere discendenti di PlayerGui per conoscere quale giocatore interagisce con esso.
Caching UI statica per miglioramenti di performance
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à
Determina se la SurfaceGui sarà sempre rendersi sopra altri oggetti 3D.
Determina il fattore con cui viene ridimensionata la luce della GUI or Intefaccia grafica utentequando LightInfluence è 0.
La dimensione di uno 'schermo virtuale', in 'Pixel virtuali', che rende SurfaceGuis pixel-to- pixel compatibile con ScreenGuis.
Quando impostato su true, le parti di GuiObjects che cadono al di fuori dei confini della SurfaceGui non saranno disegnate.
Controlla quanto la SurfaceGUI sia influenzata dalla luce nel Mondodi gioco.
Controlla quanto lontano può essere visualizzato SurfaceGui prima di interrompere il render.
Determina il numero di pixel di spazio di schermo per il mondo-spazio usato per rendere i contenuti della SurfaceGui.
Determina se SurfaceGui renderà all'interno di un certo raggio o scala con le sue dimensioni in studs.
Imposta la distanza di avvio cliccando a sinistra invece della distanza tenuta dalla strumento.
Offsetta la SurfaceGui rispetto alla normalità della superficie a cui è allegata.
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à
AlwaysOnTop
Determina se la SurfaceGui renderà sopra il 3D o sarà oscurata da esso.
Quando impostato su false, il SurfaceGui 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.
- SurfaceGui.LightInfluence viene trattato come se fosse 0.
- SurfaceGui.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.
CanvasSize
La dimensione di uno 'schermo virtuale', in 'Pixel virtuali', che rende SurfaceGuis pixel-to- pixel compatibile con ScreenGuis.
ClipsDescendants
Quando impostato su true, le parti di GuiObjects che cadono al di fuori dei confini della SurfaceGui non saranno disegnate.
Anche quando questa proprietà è falsa, gli oggetti che sono completamente al di fuori della canvas della SurfaceGui non Renderizzare.
MaxDistance
Controlla quanto lontano può essere visualizzato il SurfaceGui prima di interrompere il render. Un valore di 0 significa che non c'è limite, e renderà infinitamente lontano.
Per le esperienze con molti SurfaceGuis, è consigliato impostare questo su un valore appropriato per ciascun SurfaceGui. Il valore predefinito quando si inserisce un SurfaceGui in Studio è 1000, che dovrebbe essere ok per la maggior parte degli usi.
Per le interfacce utente che sono all'aperto, dovresti impostare la distanza massima abbastanza lontana in modo che l'interfaccia utente sia piccola sullo schermo quando viene visualizzata, circa 10 pixel a livello. Ciò rende meno visibile quando viene visualizzata o fuori.
Puoi ridurre ulteriormente il pop-up aggiungendo uno stesso stile di decal sotto la SurfaceGui, o cambiando il colore della parte per corrispondere al colore di sfondo della tua UI.
Per gli spazi interni, la distanza massima dovrebbe essere impostata leggermente più grande della dimensione della stanza, in modo che l'interfaccia utente non si renda quando il giocatore è in una stanza diversa.
PixelsPerStud
PixelPerStud determina la densità dei pixel utilizzati per ciascun stud per mondi per rendere i contenuti della SurfaceGui.
I valori più elevati faranno si che i singoli GuiObject all'interno appariranno più piccoli se vengono mantenuti della stessa dimens
SizingMode
Quando impostato su Enum.SurfaceGuiSizingMode.FixedSize, SurfaceGui rende con un set di dimensioni fisse usando SurfaceGui.CanvasSize .
Quando impostato su Enum.SurfaceGuiSizingMode.PixelsPerStud, SurfaceGui rende con un'area di pixel basata sulla variabile dimensione in SurfaceGui.PixelsPerStud e la dimensione di SurfaceGui in studs.
ToolPunchThroughDistance
Imposta la distanza rimanente cliccando inizia ad agire sulla guida della superficie invece della tool. Se un personaggio è in questa distanza della guida della superficie, allora lo strumento non si attiverà al clic.