SurfaceGui

Visualizza obsoleti

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

  • Lettura Parallela

    Determina se la SurfaceGui sarà sempre rendersi sopra altri oggetti 3D.

  • Lettura Parallela

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

  • Lettura Parallela

    La dimensione di uno 'schermo virtuale', in 'Pixel virtuali', che rende SurfaceGuis pixel-to- pixel compatibile con ScreenGuis.

  • Lettura Parallela

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

  • Lettura Parallela

    Controlla quanto la SurfaceGUI sia influenzata dalla luce nel Mondodi gioco.

  • Lettura Parallela

    Controlla quanto lontano può essere visualizzato SurfaceGui prima di interrompere il render.

  • Lettura Parallela

    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.

  • Lettura Parallela

    Offsetta la SurfaceGui rispetto alla normalità della superficie a cui è allegata.

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

Eventi

Eventi provenienti da GuiBase2d

Proprietà

AlwaysOnTop

Lettura Parallela

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:

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.

CanvasSize

Lettura Parallela

La dimensione di uno 'schermo virtuale', in 'Pixel virtuali', che rende SurfaceGuis pixel-to- pixel compatibile con ScreenGuis.

ClipsDescendants

Lettura Parallela

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.

LightInfluence

Lettura Parallela

Controlla quanto la SurfaceGUI sia influenzata dalla luce nel Mondodi gioco.

MaxDistance

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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

Lettura Parallela

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.

ZOffset

Lettura Parallela

Offsetta la SurfaceGui rispetto alla normalità della superficie a cui è allegata.

Metodi

Eventi