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

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
Determina si el SurfaceGui siempre se renderizará encima de otros objetos 3D.
Determina el factor por el cual la luz del contenedor SurfaceGui se escala cuando LightInfluence es 0 .
El tamaño de una "pantalla virtual" en "píxeles virtuales" que hace que SurfaceGuis píxel a píxel sea compatible con ScreenGuis .
Si se dibujarán partes de GuiObjects que estén fuera de los límites del lienzo SurfaceGui.
Controla cuánto el SurfaceGui es influenciado por la iluminación ambiental.
Controla qué tan lejos se puede mostrar el SurfaceGui antes de que se detenga el renderizado.
Determina la densidad de píxeles utilizados para cada pestillo de espacio mundial para renderizar el contenido del SurfaceGui .
Determina si el SurfaceGui renderizará a un tamaño fijo o a escala con su tamaño en studs.
Establece la distancia en la que el clic izquierdo empieza a actuar en el SurfaceGui en lugar de en el Tool mantenido.
Coloca esto SurfaceGui en relación con otros SurfaceGuis en la misma cara.
BasePart en el que aplicar el SurfaceGui , reemplazando la asociación padre predeterminada.
Enum.NormalId cara sobre la cual aplicar el SurfaceGui .
Alterna la visibilidad de este LayerCollector .
Determina si los LayerCollector reinicios (se elimina a sí mismo y se reclona en el personaje del jugador PlayerGui) cada vez que el personaje del jugador reaparece.
Controla cómo GuiObject.ZIndex se comporta en todos los descendientes de este LayerCollector .
Describe la posición actual de la pantalla de un elemento GuiBase2d , en píxeles.
Describe la rotación de la pantalla actual de un elemento GuiBase2d en grados.
Describe el tamaño de la pantalla actual de un elemento GuiBase2d , en píxeles.
Cuando se establece en true, la localización se aplicará a este GuiBase2d y a sus descendientes.
Una referencia a un LocalizationTable para usar para aplicar localización automatizada a este GuiBase2d y sus descendientes.
Personaliza el comportamiento de selección del gamepad en la dirección de abajo.
Personaliza el comportamiento de selección del gamepad en la dirección izquierda.
Personaliza el comportamiento de selección del gamepad en la dirección correcta.
Personaliza el comportamiento de selección del gamepad en la dirección de arriba.
Permite la personalización del movimiento de selección del gamepad.
Eventos
Eventos heredados de GuiBase2d- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Se enciende cuando la selección del gamepad se mueve a, deja o cambia dentro del conectado GuiBase2d o cualquier descendiente GuiObjects .
Propiedades
AlwaysOnTop
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
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
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
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
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
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
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.
SizingMode
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
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
Coloca esto SurfaceGui en relación con otros en la misma cara (cambiar esto no levanta o hunde visualmente un SurfaceGui de la superficie).