BillboardGui

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í.

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.

BillboardGui with a TextLabel describing the screen console it floats above.

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.

Resumen

Propiedades

Propiedades heredados de LayerCollectorPropiedades heredados de GuiBase2d

Eventos

Eventos heredados de GuiBase2d

Propiedades

Active

Leer paralelo

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

Leer paralelo

Establece el objetivo BasePart o Attachment que el BillboardGui está posicionado relativo a, reemplazando la parte o el conexiónpadre.

AlwaysOnTop

Leer paralelo

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

Leer paralelo

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

Leer paralelo

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

Solo lectura
No replicado
Leer paralelo

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

Leer paralelo

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

Leer paralelo

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

Leer paralelo

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

Leer paralelo

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

Leer paralelo

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

Leer paralelo

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

Leer paralelo

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

Leer paralelo

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

Leer paralelo

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

Leer paralelo

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ñoExplicación

Vea también StudsOffset , StudsOffsetWorldSpace , ExtentsOffset , y ExtentsOffsetWorldSpace que son propiedades desplazadas que funcionan en el espacio 3D en lugar de eso.

StudsOffset

Leer paralelo

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

Leer paralelo

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.

Métodos

Eventos