SurfaceGui

Mostrar obsoleto

*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

SurfaceGui permite la renderización de objetos de interfaz de usuario en la superficie de una parte en el mundo 3D mientras también permite que producirsela interacción básica del usuario.Similar a y , los objetos de interfaz de usuario como y están asociados a una cara del mismo dirección que la superficie en la que se encuentran, editables a través de la propiedad .

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

Tenga en cuenta que los elementos de interfaz de usuario interactivos como ImageButtons y TextButtons dentro de un SurfaceGui solo recibirán la entrada del usuario si se les asigna como padres al PlayerGui , generalmente colocando el SurfaceGui dentro de StarterGui .La propiedad Adornee se puede usar para dirigir una parte en el mundo 3D mientras que la propia SurfaceGui permanece en el PlayerGui.

Vea Interfaz de usuario en experiencia para obtener una guía sobre cómo trabajar con SurfaceGui contenedores.

Comportamiento de caché

Para ayudar a mejorar el ejecución, la apariencia de un SurfaceGui se cacha hasta que ocurra uno de los siguientes, después de lo cual su apariencia se recalculará en el próximo marco de renderizado.

  • Se agrega o se elimina un descendiente del SurfaceGui.
  • Una propiedad de un descendiente de los cambios de SurfaceGui .
  • Una propiedad del propio SurfaceGui cambia.

Resumen

Propiedades

Propiedades heredados de SurfaceGuiBasePropiedades heredados de LayerCollectorPropiedades heredados de GuiBase2d

Eventos

Eventos heredados de GuiBase2d

Propiedades

AlwaysOnTop

Leer paralelo

Esta propiedad determina si el SurfaceGui siempre se renderizará encima de otros objetos 3D.

Cuando se establece en false (predeterminado), el SurfaceGui se renderiza como otro contenido 3D y se oculta por otros objetos 3D.Cuando se establece en true , el SurfaceGui siempre se renderiza encima del contenido 3D y los cambios de apariencia son significativos:

  • Los colores coinciden con la forma en que aparecen dentro de un ScreenGui .
  • El texto puede aparecer más nítido en dispositivos de alto DPI.
  • LightInfluence se trata como si fuera 0 .
  • Brightness no tiene efecto.

Brightness

Leer paralelo

Esta propiedad determina el factor por el cual la luz del contenedor SurfaceGui se escala cuando LightInfluence es 0.Por defecto, esta propiedad es 1 y se puede establecer a cualquier número entre 0 y 1000 .Al modificar esta propiedad, el brillo aparente de un SurfaceGui puede ser mejor ajustado a su entorno, ambiente.Por instancia, una pantalla de video se puede iluminar dentro de una habitación oscura al aumentar Brightness a 10 .

Tenga en cuenta que Brightness no es accesible en Studio y no tiene efecto cuando LightInfluence es 1 o AlwaysOnTop es true .

CanvasSize

Leer paralelo

El tamaño de una "pantalla virtual" en "píxeles virtuales" que hace que SurfaceGuis píxel a píxel sea compatible con ScreenGuis .

ClipsDescendants

Leer paralelo

Cuando se establece en true (predeterminado), las porciones de GuiObjects que caigan fuera de los bordes del lienzo de SurfaceGui no se dibujarán.

Incluso cuando esta propiedad es false , GuiObjects que están completamente fuera del lienzo no se Renderizar.

LightInfluence

Leer paralelo

Controla cuánto el SurfaceGui es influenciado por la iluminación ambiental, en un rango de 0 a 1 .Establecer esto en 1 significa que la iluminación circundante tiene control completo sobre la aspecto, look, mientras que establecerlo en 0 significa que la iluminación no tiene efecto.

MaxDistance

Leer paralelo

Esta propiedad controla qué tan lejos de la cámara se mostrará el SurfaceGui antes de que deje de renderizar.Un valor de 0 significa que no hay límite y se renderizará infinitamente lejos.El valor predeterminado de 1000 funciona bien para la mayoría de los casos.

Para SurfaceGuis que aparecen al aire libre, se recomienda que MaxDistance sea lo suficientemente alto como para garantizar que la interfaz de usuario del contenedor sea lo suficientemente pequeña en la pantalla cuando aparece o desaparece, minimizando el efecto de aparición repentina/desaparición.

PixelsPerStud

Leer paralelo

Esta propiedad determina la densidad de píxeles utilizados para cada pestillo de espacio mundial para renderizar el contenido del SurfaceGui .Los valores más altos harán que los varios GuiObjects dentro parezcan más pequeños si se mantienen del mismo tamaño.Al contrario, los valores más bajos harán que los objetos parezcan más grandes.Sin embargo, si los GuiObjects se escalan proporcionalmente a través del uso de UIScale , GuiObject.Size , TextLabel.TextSize o similar, esta propiedad permite que se use una definición más alta.

Es importante seleccionar un valor en función de qué tan lejos esperas que un jugador vea el SurfaceGui .Tenga en cuenta también que una gran densidad de píxeles podría afectar negativamente el rendimiento si el rostro de la parte adornada es lo suficientemente grande.

Leer paralelo

Cuando se establece en Enum.SurfaceGuiSizingMode.PixelsPerStud (predeterminado), el SurfaceGui se renderiza con un tamaño variable basado en PixelsPerStud y el tamaño de la superficie en studs.

Cuando se establece en Enum.SurfaceGuiSizingMode.FixedSize , el SurfaceGui se renderiza con un tamaño fijo establecido a través de CanvasSize .

ToolPunchThroughDistance

Leer paralelo

Establece la distancia en la que el clic izquierdo empieza a actuar en el SurfaceGui en lugar de en el Tool mantenido.Si un personaje está dentro de esta distancia de la SurfaceGui, el Tool no se activará al hacer hcer clic.

ZOffset

Leer paralelo

Coloca esto SurfaceGui en relación con otros en la misma cara (cambiar esto no levanta o hunde visualmente un SurfaceGui de la superficie).

Métodos

Eventos