BillboardGui

Mostrar obsoleto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

BillboardGuis son contenedores para GuiObjects que aparecen en el espacio 3D. BillboardGuis siempre se enfrenta a la cámara, y puede cambiar el tamaño con la distancia o mantener el tamaño en la pantalla según la propiedad BillboardGui.Size .

Su posición es relativa a la BillboardGui.Adornee . Si no se establecerningún Adornee, entonces el padre del BillboardGui se usará como el adornee. Para BaseParts , la propiedad Position se

La propiedad Size de un BillboardGui funciona un poco diferente que GuiObject.Size. La parte Offset funciona igual, pero la parte Scale se usa como un tamaño en studs en el espacio 3D.

Un tamaño de UDim2.fromScale(4, 5) es 4x5 studs, y escala la interfaz de usuario más grande y más pequeña dependiendo de la distancia de la cámara. Un tamaño de UDim2.fromOffset(200, 100) siempre es 200x100 en la pantalla

Al crear BillboardGuis de tamaño, es importante asegurarse de que todos los objetos de la interfaz de usuario dentro estén usando escalado de tamaño y todo el texto tiene TextLabel.TextScaled habilitado, para asegurar un escalado correcto.

La propiedad AbsolutePosition de un BillboardGui y todos sus descendientes está relativa a la esquina superior izquierda de su lienzo, y por lo tanto siempre es 0, 0 para la instancia de BillboardGui.

Cachando UI Estática para un Rendimiento

La apariencia de un Gui se guarda hasta que ocurra uno de los siguientes eventos:

  • Se agrega un descendiente a la Gui.
  • Un descendiente se elimina de la Gui.
  • Una propiedad de un descendiente de la Gui cambia.
  • Una propiedad del Gui cambia.

Si producirsecualquiera de estos eventos, la apariencia del Gui se recontará en el próximo marco en que se renderice.

Resumo

Propriedades

  • Ler Parallel

    Controla si los descendientes recibirán eventos de entrada.

  • Ler Parallel

    Establece la parte o accesorio objetivo en el que se posicionará el BillboardGui.

  • Ler Parallel

    Determina si el BillboardGui renderizará frente a 3D o detrás de él.

  • Ler Parallel

    Determina el factor por el cual se escala la luz de la Interfaz gráfica (o GUI)cuando LightInfluence es 0.

  • Cuando establecido como cierto, no se dibujarán las partes de GuiObjects que caen fuera de los límites del lienzo de BillboardGui.

  • Somente leitura
    Não replicado
    Ler Parallel

    La distancia actual en studs que el BillboardGui está de la cámara del jugador.

  • Determina la distancia en studs que un BillboardGui dejará de escalar en tamaño en.

  • Ler Parallel

    La distancia se redondeará a incrementos de este valor.

  • Determina la distancia en studs que un BillboardGui dejará de escalar más pequeño en tamaño.

  • Determina cómo el BillboardGui está desplazado de su Adornee , relativamente a la orientación y unidades de la unidad de orientación y unidades de la unidad de orientación y unidades de la unidad de orientación y unidades de la unidad de orientación y unidades de la unidad de orientación y unidades de la unidad de orientación y unidades de la unidad de orientación y unidades de la unidad de orientación y unidades de la unidad de orientación y unidades de la unidad de orientación y unidades de la unidad de orientación y

  • Determina cómo el BillboardGui está desplazado de su Adornee , en relación con los ejes y unidades globales, son la mitad de las dimensiones de la caja delimitadorade enfoque de aplicación de modeladoalineada con los ejes.

  • Controla la cantidad que el BillboardGui está influenciado por la iluminación en el entorno, ambiente.

  • Ler Parallel

    Establece la distancia máxima que un letrero puede estar de la cámara y aún así dibujado.

  • Usado por los scripts para ocultar el BillboardGui de un jugador específico.

  • Ler Parallel

    Controla el tamaño que tendrá el BillboardGui en la pantalla.

  • Ler Parallel

    Un desplazamiento de 2D en unidades de tamaño relativo que actúa como un punto de anclaje.

  • Ler Parallel

    Determina cómo el BillboardGui está desplazado de su Adornee , relativo a la orientación y unidades en studs.

  • Determina cómo el BillboardGui está desviado de su Adornee , en relación con los ejes y unidades globales en studs.

Propriedades herdados de LayerCollectorPropriedades herdados de GuiBase2d

Eventos

Eventos herdados de GuiBase2d

Propriedades

Active

Ler Parallel

Controla si los descendientes recibirán eventos de entrada. Si la interfaz de usuario contiene un GuiButton , entonces ese botón solo se volverá hableable si se ha establecido Active en true en ambos el BillboardGui y el botón.

BillboardGuis solo recibirá la entrada del usuario si están relacionados con el PlayerGui. La propiedad BillboardGui.Adornee se puede usar para apuntar a una parte en el espacio de trabajo mientras que la interfaz de usuario misma está en el PlayerGui .

Adornee

Ler Parallel

Establece la parte o accesorio objetivo en relación con el BillboardGui. Si no se establecerningún Adornee, entonces se usa el Parent en su lugar.

AlwaysOnTop

Ler Parallel

Determina si el BillboardGui renderizará por encima del contenido 3D, o estará oculto por él.

Cuando establecido como falso, el BillboardGui se renderizará como otro contenido 3D y estará oculto por otros objetos 3D.

Cuando está configurado como verdadero, siempre se renderiza por encima del contenido 3D, y los cambios de apariencia son significativos:

Brightness

Ler Parallel

Brillo determina el factor por el cual se escala la luz emitida por la Interfaz gráfica (o GUI). Por defecto, esta propiedad es 1 y se puede establecer a cualquier número en el rango [0, 1000].

Al modificar esta propiedad, la aparente brillo de un GUI puede ser mejor combinado con su entorno, ambiente. Por instancia, una pantalla de video como las encontradas en Times Square se puede hacer más brillante para ser claramente visible en un día soleado.

Esta propiedad no producirá ningún efecto en los siguientes escenarios en los que el GUI no emite luz.:

  • Cuando AlwaysOnTop es cierto, el color de cada píxel es el color mostrado en la pantalla.
  • Cuando LightInfluence es 1, toda la luz de la GUI se refleja desde el entorno en lugar de ser emitida.

ClipsDescendants

Ler Parallel

Cuando establecido como cierto, no se dibujarán las partes de GuiObjects que caen fuera de los límites del lienzo de BillboardGui.

Incluso cuando esta propiedad esté falsa, los objetos que están completamente fuera del lienzo del BillboardGui no se Renderizar.

CurrentDistance

Somente leitura
Não replicado
Ler Parallel

La distancia actual en studs que el BillboardGui está de la cámara del jugador. Un evento cambiado no se activa para esta propiedad a menos que el gui's BillboardGui.DistanceStep sea más de 0.

DistanceLowerLimit

Ler Parallel

Determina la distancia en studs que un BillboardGui dejará de escalar en tamaño en relación con la cámara actual del jugador. Si la distancia del gui estuviera por debajo de este valor, no se escalará más grande que en esta distancia. El valor de esta propiedad predeterminado es 0 studs.

DistanceStep

Ler Parallel

Determina los tamaños de aumento y disminución de tamaño en studs a medida que la cámara del jugador se acerca y aleja de la BillboardGui.CurrentDistance . La propiedad predeterminada es 0, y redondea desde BillboardGui .

Por ejemplo, si esta propiedad se establece a 0.5 y la cámara del jugador se está moviendo lejos de la interfaz de usuario desde 0, entonces CurrentDistance aumentará 0 -> 0.5 -> 1 -> 1.5 -> ... y así sucesivamente.

DistanceUpperLimit

Ler Parallel

Determina la distancia en studs que un BillboardGui dejará de escalar más pequeño en tamaño en relación con la cámara actual del jugador. Si la distancia del gui está por encima de este valor, no se escalará más pequeño que sería en esta distancia.

Esta propiedad se ignora si el valor es menor que 0. El valor predeterminado es -1, lo que significa que la propiedad se ignora por defecto.

ExtentsOffset

Ler Parallel

ExtentsOffset determina cómo el BillboardGui está desplazado de su Adornee , relativo a la orientación y unidades de la Camera -alineada caja delimitadorade enfoque.

Véase también:

  • ExtentsOffsetWorldSpace , que funciona de forma similar excepto que la orientación de desplazamiento es relativa a los ejes globales
  • StudsOffset , que funciona similarmente excepto que las unidades son studs

ExtentsOffsetWorldSpace

Ler Parallel

ExtentsOffsetWorldSpace determina cómo la BillboardGui está desplazada de su Adornee , relativa a los ejes y unidades globales, son la mitad de las dimensiones de la caja delimitadorade enfoque alineada de la aplicación de modelado.

Véase también:

  • ExtentsOffset , que funciona similarmente excepto que la orientación de desplazamiento es relativa a la Camera
  • StudsOffsetWorldSpace , que funciona de forma similar excepto que las unidades son studs

LightInfluence

Ler Parallel

Controla la cantidad que el BillboardGui está influenciado por la iluminación en el entorno, ambiente.

Cuando se establece en 0, la interfaz de usuario se comporta similarmente a una pantalla LCD, actuando como fuente de luz propia y apareciendo igual sin importar la iluminación ambiente.

Cuando se establece en 1, la interfaz de usuario se comporta similarmente a un pedazo de papel, sólo reflejar la luz de otra de origen.

MaxDistance

Ler Parallel

La propiedad MaxDistance de un BillboardGui establece la distancia en pies que puede estar el letrero de la máxima distancia de la cámara y aún se dibuja. Si la cámara y el letrero se mueven más lejos que la distancia máxima, entonces el letrero no será visible independientemente de cualquier otra propiedad del letrero o cualquier objeto GUI que contenga. El valor predeterminado de esta propiedad es infinito

Si este valor se establece para menos o igual que 0, se tratará la distancia máxima como infinita y el cartel siempre se podrá dibujar.

Ejemplo


-- Espere a que se carguen los scripts de cámara/控 de cargar
task.wait(5)
-- Declarar y inicializar objetos
local camera = workspace.CurrentCamera
local part = Instance.new("Part")
local billboard = Instance.new("BillboardGui")
local label = Instance.new("TextLabel")
-- Configurar el introducirde cámara
camera.CameraType = Enum.CameraType.Scriptable
-- Establecer la posición de la parte y bloquear en su lugar
part.CFrame = CFrame.new(0, 10, 0)
part.Anchored = true
-- Configurar pancarta
billboard.MaxDistance = 10
billboard.Adornee = part
billboard.AlwaysOnTop = true
billboard.Size = UDim2.fromOffset(50, 50)
-- Etiqueta de etiqueta
label.Size = UDim2.fromScale(1, 1)
-- Establecer padres de objetos
label.Parent = billboard
billboard.Parent = part
part.Parent = workspace
-- Mueve la cámara junto a la parte. Espera un poco y luego mueve la cámara
local cameraPosition0 = part.Position + Vector3.new(0, 0, 10)
local cameraPosition1 = part.Position + Vector3.new(0, 0, 20)
camera.CFrame = CFrame.lookAt(cameraPosition0, part.Position)
-- El contenido del cartelera estará visible aquí
task.wait(2)
camera.CFrame = CFrame.lookAt(cameraPosition1, part.Position)
-- Contents of billboard will no longer be visible (outside MaxDistance)

PlayerToHideFrom

Ler Parallel

Usado por los scripts para ocultar el BillboardGui de un jugador específico.

Para ocultar la UI de más de un jugador, coloca el BillboardGui en StarterGui y usa un script para configurar la propiedad BillboardGui.Enabled seg

Size

Ler Parallel

Controla el tamaño que tendrá el BillboardGui en la pantalla.

El componente de escala de tamaño se interpreta como un tamaño en espárragos, y la interfaz de usuario escalará automáticamente con la distancia si se usan los valores de escala.

Las partes de escala y desplazamiento se agregan juntas, y se pueden usar al mismo tiempo.

SizeOffset

Ler Parallel

Un desplazamiento de 2D en unidades de tamaño relativo que actúa como un punto de anclaje. Esto se puede usar similarmente a la propiedad GuiObject.AnchorPoint, pero los valores son diferentes.

Valores Comunes

| Desplazamiento de tamaño | Explicación | | : | | | 0.0, 0.0 | El valor predeterminado. La interfaz de usuario se anclará en su centro. | | | | 0.5, 0.5 | El valor predeterminado. La inter

Véase también:

StudsOffset

Ler Parallel

StudsOffset determina cómo la BillboardGui está desplazada de su Adornee , con relación a la orientación de la cámara con unidades en studs.

Véase también:

  • StudsOffsetWorldSpace , que funciona de forma similar excepto que la orientación de desplazamiento es relativa a los ejes globales
  • ExtentsOffset , que funciona similarmente excepto que las unidades son la mitad de las dimensiones de la caja delimitadorade sujeción de la cámara del aplicación de modelado

StudsOffsetWorldSpace

Ler Parallel

StudsOffsetWorldSpace determina cómo la BillboardGui está desplazada de su Adornee , relativa a los ejes globales con unidades en studs.

Véase también:

  • StudsOffset , que funciona similarmente excepto que la orientación de desplazamiento es relativa a la Camera
  • ExtentsOffsetWorldSpace , que funciona de forma similar excepto que las unidades son la mitad de las dimensiones de la caja delimitadorade sujeción del eje del aplicación de modelado

Métodos

Eventos