BillboardGui
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
BillboardGui es un contenedor para que los objetos de la interfaz de usuario aparezcan en el espacio 3D pero siempre se enfrenten a la cámara.La posición del contenedor es relativa a la posición del padre BasePart o Attachment (o el Adornee ).Para BaseParts , se utiliza la propiedad Position , mientras que para Attachments , se utiliza la propiedad WorldPosition.

La propiedad de una valla publicitaria Size funciona de manera ligeramente diferente a GuiObject.Size .Mientras que los componentes de desplazamiento trabajan de la misma manera, los componentes de escala se utilizan como tamaños de perno en el espacio 3D.
Al crear un tamaño escalado BillboardGui que contiene un TextLabel , es útil habilitar la propiedad de etiqueta TextScaled para que su texto se escalone junto con el lienzo de anuncio a medida que cambia la distancia de la cámara.
Tenga en cuenta que los elementos de interfaz de usuario interactivos como ImageButtons y TextButtons dentro de un BillboardGui solo recibirán la entrada del usuario si se les asigna como padres al PlayerGui , generalmente colocando el BillboardGui dentro de StarterGui .La propiedad Adornee se puede usar para dirigir una parte o un accesorio en el mundo 3D mientras el BillboardGui mismo permanece en el PlayerGui .
Vea Interfaz de usuario en experiencia para obtener una guía sobre cómo trabajar con BillboardGui contenedores.
Comportamiento de caché
Para ayudar a mejorar el ejecución, la apariencia de un BillboardGui 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 BillboardGui.
- Una propiedad de un descendiente de los cambios de BillboardGui .
- Una propiedad del propio BillboardGui cambia.
Resumen
Propiedades
Controla si los descendientes recibirán eventos de entrada.
Establece la pieza o adjunto objetivo a la que se posiciona el BillboardGui.
Determina si el BillboardGui siempre se renderizará encima de otros objetos 3D.
Determina el factor por el cual la luz del contenedor BillboardGui se escala cuando LightInfluence es 0 .
Si se dibujarán partes de GuiObjects que estén fuera de los límites del lienzo BillboardGui.
La distancia actual en píxeles que el BillboardGui está desde la cámara del jugador.
Determina la distancia en studs en la que el BillboardGui dejará de escalar en tamaño más grande.
Determina los aumentos y disminuciones de tamaño CurrentDistance en studs a medida que la cámara del jugador se mueve más cerca y más lejos del BillboardGui.
Determina la distancia en studs en la que el BillboardGui dejará de escalar en tamaño más pequeño.
Determina cómo el BillboardGui se desplaza de su Adornee , en relación con la orientación Camera , en unidades que son la mitad de las dimensiones de la caja delimitadorade contención alineada de aplicación de modeladoCamera.
Determina cómo el BillboardGui se desplaza de su Adornee , en relación con los ejes globales, en unidades de mitad de las dimensiones del caja delimitadoraalineado con el eje del aplicación de modelado.
Controla cuánto el BillboardGui es influenciado por la iluminación ambiental.
Controla qué tan lejos se puede mostrar el BillboardGui antes de que se detenga el renderizado.
Utilizado por los scripts para ocultar el BillboardGui de un jugador específico.
Controla el tamaño que el BillboardGui tendrá en la pantalla.
Un desplazamiento de 2D en unidades relativas a tamaño que actúa como un punto de anclaje.
Determina cómo el BillboardGui se desplaza de su Adornee en studs, en relación con la orientación Camera.
Determina cómo se desplaza el BillboardGui de su Adornee en studs, en relación con los ejes globales.
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
Active
Controla si los descendientes recibirán eventos de entrada.Si el BillboardGui contiene un GuiButton , ese botón solo será clicable si Active está configurado como true en ambos BillboardGui y botón.
Tenga en cuenta que los elementos de interfaz de usuario interactivos como ImageButtons y TextButtons dentro de un BillboardGui solo recibirán la entrada del usuario si se les asigna como padres al PlayerGui , generalmente colocando el BillboardGui dentro de StarterGui .La propiedad Adornee se puede usar para dirigir una parte o un accesorio en el mundo 3D mientras el BillboardGui mismo permanece en el PlayerGui .
Adornee
Establece el objetivo BasePart o Attachment que el BillboardGui está posicionado relativo a, reemplazando la parte o el conexiónpadre.
AlwaysOnTop
Esta propiedad determina si el BillboardGui siempre se renderizará encima de otros objetos 3D.
Cuando se establece en false (predeterminado), el BillboardGui se renderiza como otro contenido 3D y se oculta por otros objetos 3D.Cuando se establece en true , el BillboardGui 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 BillboardGui 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 BillboardGui 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 .
ClipsDescendants
Cuando se establece en true (predeterminado), las porciones de GuiObjects que caigan fuera de los bordes del lienzo de BillboardGui no se dibujarán.
Incluso cuando esta propiedad es false , GuiObjects que están completamente fuera del lienzo no se Renderizar.
CurrentDistance
La distancia actual en píxeles que el BillboardGui está desde la cámara del jugador.Un evento cambiado no se activa para esta propiedad a menos que DistanceStep sea mayor que 0.
DistanceLowerLimit
Determina la distancia en studs en la que el BillboardGui dejará de escalar en tamaño mayor en relación con la cámara actual del jugador, con un valor predeterminado de 0 .Si el CurrentDistance de la BillboardGui no está por encima de este valor, no se escalará más grande de lo que sería a esta distancia DistanceLowerLimit.
DistanceStep
Determina los aumentos y disminuciones de tamaño CurrentDistance en studs a medida que la cámara del jugador se mueve más cerca y más lejos del BillboardGui.La propiedad se restablece a 0 y se redondea a partir de DistanceLowerLimit .
DistanceUpperLimit
Determina la distancia en studs en la que el BillboardGui dejará de escalar en tamaño más pequeño en relación con la cámara actual del jugador.Si el CurrentDistance de la BillboardGui está por encima de este valor, no se reducirá más pequeño de lo que sería a esta distancia DistanceUpperLimit.
Esta propiedad se ignora si el valor es inferior a 0 . El valor predeterminado es -1 , lo que significa que la propiedad se ignora por defecto.
ExtentsOffset
Esta propiedad determina cómo el BillboardGui se desplaza de su Adornee , con respecto a la orientación Camera , en unidades que son la mitad de las dimensiones de la caja delimitadorade contención alineada con el aplicación de modeladode Camera .
Vea también StudsOffset que funciona de manera similar pero usa unidades de estudio, o ExtentsOffsetWorldSpace que funciona de manera similar excepto que la orientación de desplazamiento es relativa a los ejes globales.
ExtentsOffsetWorldSpace
Esta propiedad determina cómo el BillboardGui se desplaza de su Adornee , con respecto a los ejes globales, en unidades de mitad de las dimensiones de la caja delimitadorade contención alineada con el eje del aplicación de modelado.
Vea también StudsOffset que funciona de manera similar pero usa unidades de estudio, o ExtentsOffset que funciona de manera similar excepto que la orientación de desplazamiento es relativa al Camera.
LightInfluence
Controla cuánto el BillboardGui 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 BillboardGui antes de que deje de renderizar.Un valor de 0 o inf (predeterminado) significa que no hay límite y se renderizará infinitamente lejos.
Para BillboardGuis 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.
PlayerToHideFrom
Utilizado por los scripts para ocultar el BillboardGui de un jugador específico.
Para ocultar un BillboardGui de más de un jugador, colócalo en StarterGui y usa un script para establecer la propiedad Enabled de acuerdo con si el LocalPlayer debería poder verla.La propiedad Adornee se puede usar para unir el BillboardGui a un BasePart o Attachment en el Workspace , en lugar de criarlo.
Size
Controla el tamaño que el BillboardGui tendrá en la pantalla.A diferencia de , los componentes de escala de este conjunto de propiedades establecen el tamaño de los estudios de la valla publicitaria en el espacio 3D.
SizeOffset
Un desplazamiento de 2D en unidades relativas a tamaño que actúa como un punto de anclaje.Esto se puede usar de manera similar a la propiedad GuiObject.AnchorPoint, pero los valores son diferentes.
<tbody><tr><td><code>0, 0</code></td><td>El predeterminado en el que la interfaz se anclará en su centro.</td></tr><tr><td><code>0.5, 0.5</code></td><td>La interfaz se anclará en la parte inferior izquierda.</td></tr><tr><td><code>0.5, -0.5</code></td><td>La interfaz se anclará en la parte superior izquierda.</td></tr><tr><td><code>-0.5, 0.5</code></td><td>La interfaz se anclará en la parte superior derecha.</td></tr><tr><td><code>-0.5, -0.5</code></td><td>La interfaz se anclará en la parte inferior derecha.</td></tr></tbody>
Desplazamiento de tamaño | Explicación |
---|
Vea también StudsOffset , StudsOffsetWorldSpace , ExtentsOffset , y ExtentsOffsetWorldSpace que son propiedades desplazadas que funcionan en el espacio 3D en lugar de eso.
StudsOffset
Esta propiedad determina cómo el BillboardGui se desplaza de su Adornee en studs, en relación con la orientación Camera.
Vea también StudsOffsetWorldSpace que funciona de manera similar excepto que la orientación de desplazamiento es relativa a los ejes globales.
StudsOffsetWorldSpace
Esta propiedad determina cómo se desplaza el BillboardGui de su Adornee en studs, en relación con los ejes globales.
Vea también StudsOffset que funciona de manera similar excepto que la orientación de desplazamiento es relativa al Camera.