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.

BillboardGuis są kontenerami dla GuiObjects , które pojawiają się w przestrzeni 3D. BillboardGuis zawsze stoi oblicze kamery i może albo zmienić rozmiar z dala od siebie lub pozostać taki sam rozmiar na ekranie w oparciu o właściwość BillboardGui.Size.

Ich pozycja jest względna do BillboardGui.Adornee. Jeśli Adornee nie jest ustawiać, to rodzic BillboardGui będzie używany jako adornee. Dla BaseParts , właściwość Class.BasePart.Position

Właściwość Size tabliczki reklamowej działa nieco inaczej niż GuiObject.Size. Część Offset działa taka sama, ale część Skalowa jest używana jako rozmiar w studsach w przestrzeni 3D.

Rozmiar UDim2.fromScale(4, 5) jest 4x5 studs, a skala interfejsu większa i mniejsza w zależności od odległości od kamery. Rozmiar UDim2.fromOffset(200, 100) jest zawsze 200x100 na ekranie,

Podczas tworzenia rozmiarowo skalowanego BillboardGuis ważne jest, aby upewnić się, że wszystkie obiekty UI wewnątrz używają skalowania rozmiarowego i wszystkiе teksty mają TextLabel.TextScaled włączone, aby zapewnić poprawne skalowanie.

Właściwość AbsolutePosition bilboardu i wszystkich jego potomnych jest względna do lewego górego rogu swojego płótna, a więc zawsze jest 0, 0 dla instancjabilboardu.

Przechowywanie statycznej interfejsu użytkownika dla wydajności

Wygląd Gui'ego jest zapamiętywany do czasu pojawienia się jednego z następujących wydarzeń:

  • Dodany jest potomny do Gui.
  • Potomstwo jest usuwane z Gui.
  • Własność potomstwa Gui zmienia się.
  • Własność Gui zmienia się.

Jeśli jedno z tych wydarzeń się występować, wygląd Gui zostanie ponownie wyliczony w następnym klatce, w której zostanie renderowane.

Podsumowanie

Właściwości

  • Odczyt równoległy

    Kontroluje, czy potomstwo otrzyma wydarzenia wejścia.

  • Odczyt równoległy

    Określa część lub załącznik docelowy, na którym BillboardGui jest umieszczony w stosunku do.

  • Odczyt równoległy

    Określa, czy BillboardGui będzie renderować przed 3D lub za nim.

  • Odczyt równoległy

    Określa czynnik, w jaki sposób światło GUI jest skalowane, gdy LightInfluence ma 0.

  • Odczyt równoległy

    Ustawione na prawdę, części GuiObjects, które spadają poza ramy BillboardGui, nie będą rysowane.

  • Tylko do odczytu
    Bez replikacji
    Odczyt równoległy

    Obecna odległość w milimetrach, z której BillboardGui pochodzi z kamery gracza.

  • Odczyt równoległy

    Określa odległość w milimetrach, w których BillboardGui przestanie skalować większe w rozmiarze.

  • Odczyt równoległy

    Odległość zostanie zaokrąglona do zwiększeń tej wartości.

  • Odczyt równoległy

    Określa odległość w milimetrach, w których BillboardGui przestanie skalować mniejsze w rozmiarze.

  • Odczyt równoległy

    Określa, jak BillboardGui jest odchyleniem od jego Adornee , w odniesieniu do orientacji i jednostek Camera - północnej krawędzi obszaru modelu.

  • Odczyt równoległy

    Określa, jak BillboardGui jest odchylenie od swojego Adornee , w odniesieniu do globalnych osi i jednostek jest pół rozmiarów kształtującego się pudełka granicznego modelu.

  • Odczyt równoległy

    Kontroluje, jak bardzo BillboardGui jest wpływany przez oświetlenie w środowisko.

  • Odczyt równoległy

    Ustawia maksymalną odległość, jaką bilboard może mieć od kamery i nadal być rysowany.

  • Odczyt równoległy

    Używany przez skrypcity, aby ukryć BillboardGui od określonego gracza.

  • Odczyt równoległy

    Kontroluje rozmiar, który BillboardGui będzie miał na ekranie.

  • Odczyt równoległy

    Odległość 2D w jednostkach wielkości ujemnej, która działa jak punkt ancorujący.

  • Odczyt równoległy

    Określa, jak BillboardGui jest odchyleniem od jego Adornee , w odniesieniu do orientacji i jednostek Camera w studs.

  • Odczyt równoległy

    Określa, jak BillboardGui jest odchylenie od swojego Adornee , w odniesieniu do globalnych osi i jednostek w studs.

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 potomstwo otrzyma wydarzenia wejścia. Jeśli interfejs użytkownika zawiera GuiButton , to ten przycisk stanie się przyciskiem klikalnym tylko wtedy, gdy Ustawiono Aktywne na obu BillboardGui i przycisku.

BillboardGuis otrzyma jedynie wpis użytkownika, jeśli jest on powiązany z PlayerGui. Właściwość BillboardGui.Adornee może być używana do celowania części w przestrzeni roboczej, podczas gdy sam interfejs użytkownika jest w PlayerGui .

Adornee

Odczyt równoległy

Ustawia część lub załącznik docelowy, do którego umieszczony jest BillboardGui w odniesieniu do. Jeśli nie jest ustawiaćżaden Adornee, to zamiast tego jest używany Parent.

AlwaysOnTop

Odczyt równoległy

Określa, czy BillboardGui będzie renderować nad 3D content, lub być go zamkniętym.

Gdy ustawiony na fałszywy, BillboardGui będzie renderować się podobnie do innych treści 3D i zostanie zamknięty przez inne obiekty 3D.

Gdy ustawiony na prawdę, zawsze renderuje się na wierzchołku 3D, a zmiany wyglądu znacznie się zmieniają:

Brightness

Odczyt równoległy

Jasność określa czynnik, z którym skaluje się promieniowane światło GUI. Domyślnie wartość ta wynosi 1 i można ją ustawić na dowolną liczbę w zakresie [0, 1000].

Poprzez modyfikację tego właściwości, widoczność GUI może być lepiej dostosowana do jej środowisko. Na instancja, video billboard, takie jak te znalezione w Times Square, można uczynić jaśniejszym, aby być wyraźnie widoczny na jasnym dniu.

To właściwość nie będzie wywierać żadnego efektu w następujących scenariuszach, w których GUI nie emituje światła.:

  • Gdy AlwaysOnTop jest prawdziwy, kolor każdego piksela jest kolorem wyświetlanym na ekranie.
  • Gdy LightInfluence ma 1, cały światło z GUI jest odzwierciedlane z środowiska zamiast być emitowane.

ClipsDescendants

Odczyt równoległy

Ustawione na prawdę, części GuiObjects, które spadają poza ramy BillboardGui, nie będą rysowane.

Nawet gdy ta właściwość jest fałszywa, obiekty, które są całkowicie poza płaszczyzną BillboardGui, nie będą się renderować.

CurrentDistance

Tylko do odczytu
Bez replikacji
Odczyt równoległy

Obecna odległość w studsach, z której BillboardGui jest z kamery gracza. Zmienione wydarzenie nie zostanie wywołane dla tej właściwości, chyba że BillboardGui.DistanceStep gui jest większa niż 0.

DistanceLowerLimit

Odczyt równoległy

Określa dystans w milimetrach, w którym BillboardGui przestanie skalować wielkością w stosunku do aktualnej kamery gracza. Jeśli dystans gui jest poniżej tej wartości, nie zostanie on skalowany większa niż była na tej dystansie. Wartość tego właściwości domyślnie wynosi 0 milimetrów.

DistanceStep

Odczyt równoległy

Określa rozmiar BillboardGui.CurrentDistance zwiększeń i ujemnień w studsach, gdy kamera gracza zbliża się i dalej od BillboardGui . Domyślnie wartość ustawiona na 0 i okrądzona od BillboardGui.DistanceLowerLimit .

Na przykład, jeśli ta właściwość jest ustawiona na 0,5 i kamera gracza porusza się od góry 0, to CurrentDistance będzie zwiększony 0 -> 0,5 -> 1 -> 1,5 -> ... i tak dalej.

DistanceUpperLimit

Odczyt równoległy

Określa dystans w milimetrach, w którym BillboardGui przestanie skalować mniejsze w rozmiarze w stosunku do obecnej kamery gracza. Jeśli dystans gui jest powyżej tej wartości, nie zostanie on skalowany mniejszy niż byłby w tym rozmiarze.

Właściwość ta jest ignorowana, jeśli wartość wynosi mniej niż 0. Domyślną wartością jest -1, co oznacza, że właściwość jest ignorowana domyślnie.

ExtentsOffset

Odczyt równoległy

OffsetBillboardGui określa, jak BillboardGui jest odchylony od swojego Adornee w stosunku do orientacji i jednostek Camera - pół wielkości wymiarów modelu 0> Class.Camera0> - dołączonej pudełka wyboru.

Zobacz również:

  • ExtentsOffsetWorldSpace , który działa podobnie, z wyjątkiem tego, że odległość orientacji jest względna względem globalnych osi
  • StudsOffset , który działa podobnie, z wyjątkiem jednostek, które są studs

ExtentsOffsetWorldSpace

Odczyt równoległy

OffsetsWorldSpace określa, jak BillboardGui jest odchylenie od swojego Adornee , w odniesieniu do globalnych osi i jednostek jest pół rozmiarów kształtującego się skrzyni wiązania modelu.

Zobacz również:

  • ExtentsOffset , który działa podobnie z wyjątkiem tego, że odległość orientacji jest względna wobec Camera
  • StudsOffsetWorldSpace , który działa podobnie, z wyjątkiem jednostek, które są studs

LightInfluence

Odczyt równoległy

Kontroluje, jak bardzo BillboardGui jest wpływany przez oświetlenie w środowisko.

Gdy ustawiony na 0, zachowuje się UI podobnie do ekranu LCD, działając jako jego własne źródło światła i wyświetlając to samo bez względu na otoczenie oświetlenia.

Gdy ustawiony na 1, interfejs zachowuje się podobnie do kawałka papieru, tylko odzwierciedlając światło z innego kod źródłowy.

MaxDistance

Odczyt równoległy

Właściwość MaxDistance c BillboardGui ustawia, jak daleko od kamery może być bilboard i nadal być rysowany. Jeśli kamera i bilboard są przesunięte dalej niż maksymalna odległość, to bilboard nie będzie widoczny, niezależnie od wszystkich innych właściwości bilboardu lub dowolnych obiektów GUI, które zawiera. Domyślną wartość tej właściwości jest nieskończono

Jeśli wartość ta jest ustawiona poniżej lub równa 0, maksymalna odległość będzie traktowana jako nieskończoność, a bilboard zawsze będzie można wyciągnąć.

Przykład


-- Poczekaj na załadowanie domyślnych kamer/skryptów wczytywać
task.wait(5)
-- Oświadczaj i inicjuj obiekty
local camera = workspace.CurrentCamera
local part = Instance.new("Part")
local billboard = Instance.new("BillboardGui")
local label = Instance.new("TextLabel")
-- Ustaw wpisywaćkamery
camera.CameraType = Enum.CameraType.Scriptable
-- Ustaw pozycję części i zablokuj miejsce
part.CFrame = CFrame.new(0, 10, 0)
part.Anchored = true
-- Założ bilboard
billboard.MaxDistance = 10
billboard.Adornee = part
billboard.AlwaysOnTop = true
billboard.Size = UDim2.fromOffset(50, 50)
-- Ustaw etykietę
label.Size = UDim2.fromScale(1, 1)
-- Ustaw rodzice obiektów
label.Parent = billboard
billboard.Parent = part
part.Parent = workspace
-- Przenieś kamerę obok części. Poczekaj chwilę, a następnie przesuń kamerę
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)
-- Treści bilboardu będą tutaj widoczne
task.wait(2)
camera.CFrame = CFrame.lookAt(cameraPosition1, part.Position)
-- Contents of billboard will no longer be visible (outside MaxDistance)

PlayerToHideFrom

Odczyt równoległy

Używany przez skrypcity, aby ukryć BillboardGui od określonego gracza.

Aby ukryć UI od więcej niż jednego gracza, umieść BillboardGui w StarterGui i użyj skryptu, aby ustawić właściwość

Size

Odczyt równoległy

Kontroluje rozmiar, który BillboardGui będzie miał na ekranie.

Komponent Skala wielkości jest interpretowany jako wielkość w studs, a interfejs automatycznie skaluje się z dystansem, jeśli użyto wartości Skala.

Skalne i Offset części rozmiaru są dodane razem i można je używać jednocześnie.

SizeOffset

Odczyt równoległy

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

Zwólęśniaj wartości

| SizeOffset | Explanation | | : | | 0.0, 0.0 | Domyślny. UI będzie przywiązany w centrum. | | 0.5, 0.5 | Domyślny. UI będzie przywiązany w lewym dolnym rogu. | | 0.5, -0.5 | Dom

Zobacz również:

StudsOffset

Odczyt równoległy

StudsOffset określa, jak BillboardGui jest odchylony od swojego Adornee w stosunku do orientacji Camera z jednostkami w studs.

Zobacz również:

  • StudsOffsetWorldSpace , który działa podobnie, z wyjątkiem tego, że odległość orientacji jest względna względem globalnych osi
  • ExtentsOffset , który działa podobnie, z wyjątkiem tego, że jednostki są połową wielkości wymiarów kamery

StudsOffsetWorldSpace

Odczyt równoległy

StudsOffsetWorldSpace określa, jak BillboardGui jest odchylenie od swojego Adornee , w odniesieniu do globalnych osi z jednostkami w studs.

Zobacz również:

  • StudsOffset , który działa podobnie, z wyjątkiem tego, że odległość orientacji jest względna wobec Camera
  • ExtentsOffsetWorldSpace , który działa podobnie, z wyjątkiem tego, że jednostki są połową wielkości wymiarów modelu

Metody

Zdarzenia