BillboardGui

Pokaż przestarzałe

*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

BillboardGui jest kontenerem dla obiektów interfejsu, które pojawiają się w przestrzeni 3D, ale zawsze patrzą na kamerę.Pozycja kontenera jest względna do rodzica BasePart lub Attachment (lub Adornee ).Dla BaseParts używa się właściwości Position, a dla Attachments używa się właściwości WorldPosition.

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

Właściwość billboardu Size działa nieco inaczej niż GuiObject.Size .Podczas gdy komponenty offsetu działają tak samo, komponenty skali są używane jako rozmiary śrub w przestrzeni 3D.

Podczas tworzenia skalowanego rozmiarem BillboardGui, który zawiera TextLabel, przydatne jest włączenie właściwości etykiety TextScaled, aby jej tekst skalował się wraz z płótnem billboarda, gdy zmienia się odległość kamery.

Zauważ, że interaktywne elementy UI, takie jak ImageButtons i TextButtons wewnątrz BillboardGui otrzymają tylko wejście użytkownika, jeśli są powiązane z PlayerGui, zwykle poprzez umieszczenie BillboardGui wewnątrz StarterGui.Właściwość Adornee może być użyta do ukierunkowania części lub załącznika w świecie 3D, podczas gdy sama BillboardGui pozostaje w PlayerGui.

Zobacz Interfejs użytkownika w doświadczeniu dla przewodnika dotyczącego pracy z BillboardGui.

Zachowanie przechowywania

Aby pomóc poprawić wykonywanie, wygląd BillboardGui jest przechowywany do czasu, gdy wystąpi jedna z poniższych sytuacji, po których jego wygląd zostanie ponownie obliczony na następnym ramie renderowania.

Podsumowanie

Właściwości

Właściwości odziedziczeni z: LayerCollectorWłaściwości odziedziczeni z: GuiBase2d

Zdarzenia

Zdarzenia odziedziczeni z: GuiBase2d

Właściwości

Active

Odczyt równoległy

Kontroluje, czy potomkowie otrzymają wydarzenia wejściowe.Jeśli zawiera , przycisk ten stanie się klikalny tylko wtedy, gdy zostanie ustawiony na na obu i przyciskach.

Zauważ, że interaktywne elementy UI, takie jak ImageButtons i TextButtons wewnątrz BillboardGui otrzymają tylko wejście użytkownika, jeśli są powiązane z PlayerGui, zwykle poprzez umieszczenie BillboardGui wewnątrz StarterGui.Właściwość Adornee może być użyta do ukierunkowania części lub załącznika w świecie 3D, podczas gdy sama BillboardGui pozostaje w PlayerGui.

Adornee

Odczyt równoległy

Ustawia cel BasePart lub Attachment, do którego BillboardGui jest położony względem rodzica lub załącznika.

AlwaysOnTop

Odczyt równoległy

Właściwość ta określa, czy BillboardGui zawsze będzie renderowany nad innymi obiektami 3D.

Gdy ustawiono na false (domyślnie), BillboardGui renderuje się jak inne treści 3D i jest ukrywany przez inne obiekty 3D.Gdy ustawiono na true , BillboardGui zawsze renderuje się na górze treści 3D i zmiany wyglądu są znaczne:

  • Kolory pasują do tego, jak wyglądają wewnątrz ScreenGui .
  • Tekst może wyglądać ostrojszy na urządzeniach o wysokiej rozdzielczości DPI.
  • LightInfluence jest traktowany tak, jakby był 0 .
  • Brightness nie ma żadnego wpływu.

Brightness

Odczyt równoległy

Właściwość ta określa czynnik, przy którym światło kontenera BillboardGui jest skalowane, gdy LightInfluence jest 0.Domyślnie właściwość ta jest 1 i może być ustawiona na dowolną liczbę pomiędzy 0 i 1000.Poprzez zmianę tej właściwości jasność widoczna BillboardGui może być lepiej dostosowana do jej środowisko.Na instancjabillboard wideo może być rozjaśniony w ciemnym pokoju poprzez zwiększenie Brightness do 10.

Zauważ, że Brightness nie jest dostępne w Studio i nie ma wpływu, gdy LightInfluence jest 1 lub AlwaysOnTop jest true.

ClipsDescendants

Odczyt równoległy

Gdy ustawiono na true (domyślnie), części GuiObjects spadające poza granice płótna BillboardGui nie zostaną narysowane.

Nawet gdy ta właściwość jest false, GuiObjects które są całkowicie poza płótnem nie zostaną wyrenderowane.

CurrentDistance

Tylko do odczytu
Bez replikacji
Odczyt równoległy

Obecna odległość w szpilkach, z której BillboardGui pochodzi kamera gracza.Zmienione wydarzenie nie strzela dla tej właściwości, chyba że DistanceStep jest większe niż 0.

DistanceLowerLimit

Odczyt równoległy

Określa odległość w szpilkach, przy której BillboardGui przestanie skalować się większych rozmiarów w stosunku do obecnej kamery gracza, z domyślnym 0 .Jeśli CurrentDistance z BillboardGui jest poniżej tej wartości, nie będzie skalować większej niż przy tej odległości DistanceLowerLimit.

DistanceStep

Odczyt równoległy

Określa rozmiar CurrentDistance wzrostów i zmniejszeń w szpilkach, gdy kamera gracza zbliża się i oddala od BillboardGui .Właściwość domyślnie ustawia się na 0 i zaokrągla od DistanceLowerLimit.

DistanceUpperLimit

Odczyt równoległy

Określa odległość w szpilkach, w której BillboardGui przestanie skalować się w mniejszym rozmiarze w stosunku do obecnej kamery gracza.Jeśli CurrentDistance z BillboardGui jest powyżej tej wartości, nie będzie skalować mniejszej niż przy tej odległości DistanceUpperLimit.

Ta właściwość jest ignorowana, jeśli wartość jest mniejsza niż 0. Domyślna wartość to -1, co oznacza, że właściwość jest ignorowana domyślnie.

ExtentsOffset

Odczyt równoległy

Właściwość ta określa, w jaki sposób BillboardGui jest przesunięty względem Adornee od jego Camera orientacji, w jednostkach o połowie wymiarów pudełka ograniczającego modelu Camera -zgodnego.

Zobacz także StudsOffset, które działa podobnie, ale używa jednostek łączników, lub ExtentsOffsetWorldSpace, które działa podobnie, z wyjątkiem tego, że orientacja przesunięcia jest względna względem globalnych osi.

ExtentsOffsetWorldSpace

Odczyt równoległy

Właściwość ta określa, w jaki sposób BillboardGui jest przesunięty względem Adornee w stosunku do globalnych osi, w jednostkach o połowę większych wymiarów przylegającego do osi modelu pudełka granicznego.

Zobacz także StudsOffset, które działa podobnie, ale używa jednostek studów, lub ExtentsOffset, które działa podobnie, z wyjątkiem tego, że orientacja przesunięcia jest względna do Camera.

LightInfluence

Odczyt równoległy

Kontroluje, jak dużo BillboardGui jest wpływanych przez oświetlenie środowiskowe, w przedziale od 0 do 1 .Ustawienie tego na 1 oznacza, że otoczenie oświetlenia ma pełną kontrolę nad wyglądem, podczas gdy ustawienie go na 0 oznacza, że oświetlenie nie ma żadnego wpływu.

MaxDistance

Odczyt równoległy

Właściwość ta kontroluje, jak daleko od kamery będzie wyświetlany BillboardGui przed zatrzymaniem renderowania.Wartość 0 lub inf (domyślna) oznacza, że nie ma ograniczenia i będzie renderować się nieskończenie daleko.

Dla BillboardGuis, które pojawiają się na zewnątrz, zaleca się, aby MaxDistance było wystarczająco wysokie, aby zapewnić, że interfejs użytkownika kontenera jest wystarczająco mały na ekranie, gdy pojawia się lub znika, minimalizując efekt nagłego wyskakiwania/znikania.

PlayerToHideFrom

Odczyt równoległy

Używany przez skrypty do ukrycia BillboardGui od określonego gracza.

Aby ukryć BillboardGui od więcej niż jednego gracza, umieść go w StarterGui i użyj skryptu, aby ustawić właściwość Enabled zgodnie z tym, czy LocalPlayer powinien być w stanie ją zobaczyć.Właściwość Adornee może być użyta do przymocowania BillboardGui do BasePart lub Attachment w Workspace, zamiast go rodzić.

Size

Odczyt równoległy

Kontroluje rozmiar, jaki BillboardGui będzie miał na ekranie.W przeciwieństwie do GuiObject.Size składniki skali tej właściwości ustawiają rozmiar szpilki billboardu w przestrzeni 3D.

SizeOffset

Odczyt równoległy

Odległość 2D w jednostkach względnych rozmiaru, które działają jak punkt odniesienia.Można to używać podobnie do właściwości GuiObject.AnchorPoint, ale wartości są inne.


<tbody>
<tr>
<td><code>0, 0</code></td>
<td>Domyślny, przy którym interfejs zostanie zakotwiczone w jego centrum.</td>
</tr>
<tr>
<td><code>0.5, 0.5</code></td>
<td>Interfejs użytkownika zostanie zakotwiczone w lewym dolnym rogu.</td>
</tr>
<tr>
<td><code>0.5, -0.5</code></td>
<td>Interfejs użytkownika zostanie zakotwiczone w górnej lewej części</td>
</tr>
<tr>
<td><code>-0.5, 0.5</code></td>
<td>Interfejs użytkownika zostanie zakotwiczone w prawym górnym rogu.</td>
</tr>
<tr>
<td><code>-0.5, -0.5</code></td>
<td>Interfejs użytkownika zostanie zakotwiczone w prawym dolnym rogu.</td>
</tr>
</tbody>
Odległość rozmiaruWyjaśnienie

Zobacz także StudsOffset , StudsOffsetWorldSpace , ExtentsOffset i ExtentsOffsetWorldSpace , które są właściwościami offsetowymi, które działają w przestrzeni 3D zamiast tego.

StudsOffset

Odczyt równoległy

Właściwość ta określa, w jaki sposób BillboardGui jest przesunięty względem Adornee w szpilkach, w odniesieniu do orientacji Camera.

Zobacz także StudsOffsetWorldSpace, które działa podobnie, z wyjątkiem tego, że orientacja przesunięcia jest względna względem globalnych osi.

StudsOffsetWorldSpace

Odczyt równoległy

Właściwość ta określa, w jaki sposób BillboardGui jest przesunięty względem swojego Adornee w szpilkach w odniesieniu do globalnych osi.

Zobacz także StudsOffset, które działa podobnie, z wyjątkiem tego, że orientacja przesunięcia jest względna wobec Camera.

Metody

Zdarzenia