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í.
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.
Resumen
Propiedades
Controla si los descendientes recibirán eventos de entrada.
Establece la parte o accesorio objetivo en el que se posicionará el BillboardGui.
Determina si el BillboardGui renderizará frente a 3D o detrás de él.
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.
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.
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.
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.
Controla el tamaño que tendrá el BillboardGui en la pantalla.
Un desplazamiento de 2D en unidades de tamaño relativo que actúa como un punto de anclaje.
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.
Alterna la visibilidad de este LayerCollector .
Determina si el LayerCollector se reinicia (se elimina a sí mismo y se clona en el jugador's PlayerGui ) cada vez que el personaje del jugador reaparece.
Controla cómo se comporta GuiObject.ZIndex en todos los descendientes de este LayerCollector .
Describe la posición de pantalla actual de un elemento de UI, en píxeles.
Describe la rotación de pantalla actual de un elemento de UI, en grados.
Describe el tamaño de pantalla actual de un elemento de UI, en píxeles.
Cuando esté configurado como verdadero, la localización se aplicará a este GuiBase2d y sus descendientes.
Una referencia a un LocalizationTable para ser usado para aplicar la localización automatizada a este GuiBase2d y sus descendientes.
Personaliza el comportamiento de la selección del gamepad en la dirección de abajo.
Personaliza el comportamiento de la selección del gamepad en la dirección de la izquierda.
Personaliza el comportamiento de la selección del gamepad en la dirección correcta.
Personaliza el comportamiento de la selección del gamepad en la dirección de arriba.
Permite la personalización del movimiento de la plataforma de juego.
Eventos
Eventos heredados de GuiBase2d- SelectionChanged(amISelected : bool,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Se activa cuando la selección del gamepad se mueve, se va o cambia dentro de la GuiBase2d conectada o cualquier descendiente de GuiObjetos.
Propiedades
Active
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
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
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:
- Los colores coinciden con cómo aparecen dentro de un ScreenGui .
- El texto puede parecer más corto en dispositivos de mayor DPI.
- BillboardGui.LightInfluence se trata como si fuera 0.
- BillboardGui.Brightness no tiene ningún efecto.
Brightness
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
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
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
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
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
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
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
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
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
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 cargartask.wait(5)-- Declarar y inicializar objetoslocal camera = workspace.CurrentCameralocal part = Instance.new("Part")local billboard = Instance.new("BillboardGui")local label = Instance.new("TextLabel")-- Configurar el introducirde cámaracamera.CameraType = Enum.CameraType.Scriptable-- Establecer la posición de la parte y bloquear en su lugarpart.CFrame = CFrame.new(0, 10, 0)part.Anchored = true-- Configurar pancartabillboard.MaxDistance = 10billboard.Adornee = partbillboard.AlwaysOnTop = truebillboard.Size = UDim2.fromOffset(50, 50)-- Etiqueta de etiquetalabel.Size = UDim2.fromScale(1, 1)-- Establecer padres de objetoslabel.Parent = billboardbillboard.Parent = partpart.Parent = workspace-- Mueve la cámara junto a la parte. Espera un poco y luego mueve la cámaralocal 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
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
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
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 , StudsOffsetWorldSpace , ExtentsOffset , 0> Class.ToolbarGui.ExtentsOffsetWorldSpace|ExtentsOffset0> , que son todas las propiedades de desplazamiento que funcionan en el espacio 3D en lugar
StudsOffset
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
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