SurfaceGui

Visualizza obsoleti

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

SurfaceGui on a 3D part in the place with an ImageLabel child to depict a screen console.

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à

Proprietà provenienti da SurfaceGuiBaseProprietà provenienti da LayerCollectorProprietà provenienti da GuiBase2d

Eventi

Eventi provenienti da GuiBase2d

Proprietà

AlwaysOnTop

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

La dimensione di uno "schermo virtuale" in "pixels virtuali" che rende SurfaceGuis pixel-to-pixel compatibile con ScreenGuis .

ClipsDescendants

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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.

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

Posiziona questo SurfaceGui in relazione agli altri sullo stesso volto (modificare questo non "levanta" o "affonda" visivamente un SurfaceGui dalla superficie).

Metodi

Eventi