BillboardGui
*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.

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.
- Potomek jest dodany do lub usunięty z BillboardGui.
- Własność potomka zmian BillboardGui .
- Właściwość własna BillboardGui sama zmienia się.
Podsumowanie
Właściwości
Kontroluje, czy potomkowie otrzymają wydarzenia wejściowe.
Ustawia część docelową lub załącznik, do którego BillboardGui jest położony względem.
Określa, czy BillboardGui zawsze będzie renderowany nad innymi obiektami 3D.
Określa czynnik, który skaluje światło kontenera BillboardGui, gdy LightInfluence jest 0.
Czy części GuiObjects będą rysowane poza granicami płótna BillboardGui, czy nie
Obecna odległość w szpilkach, z której BillboardGui pochodzi kamera gracza.
Określa odległość w szpilkach, przy której BillboardGui przestanie skalować się większych rozmiarów.
Określa rozmiar CurrentDistance wzrostów i zmniejszeń w szpilkach, gdy kamera gracza zbliża się i oddala od BillboardGui .
Określa odległość w szpilkach, w której BillboardGui przestanie skalować się mniejszych rozmiarów.
Określa, w jaki sposób BillboardGui jest przesunięty od swojego Adornee względem orientacji Camera w jednostkach o połowę wymiarów pudełka ograniczającego modelu Camera -uzgodnionego.
Określa, w jaki sposób BillboardGui jest przesunięty względem swojego Adornee w odniesieniu do globalnych osi, w jednostkach o połowę większych wymiarów przylegającego do osi modelu pudełka granicznego.
Kontroluje, jak dużo BillboardGui jest wpływanych przez oświetlenie środowiskowe.
Kontroluje, jak daleko można wyświetlić BillboardGui przed zatrzymaniem renderowania.
Używany przez skrypty do ukrycia BillboardGui od określonego gracza.
Kontroluje rozmiar, jaki BillboardGui będzie miał na ekranie.
Odległość 2D w jednostkach względnych rozmiaru, które działają jak punkt odniesienia.
Określa, w jaki sposób BillboardGui jest przesunięty od swojego Adornee w szpilkach względem orientacji Camera.
Określa, w jaki sposób BillboardGui jest przesunięty od swojego Adornee w szpilkach względem globalnych osi.
Przełącza widoczność tego LayerCollector .
Określa, czy odnowienia LayerCollector (samodzielnie się resetuje i klonuje do postaci gracza PlayerGui) następują za każdym razem, gdy postać gracza się odrodzi.
Kontroluje, jak GuiObject.ZIndex zachowuje się na wszystkich potomkach tego LayerCollector .
Opisuje rzeczywistą pozycję ekranu elementu GuiBase2d w pikselach.
Opisuje rzeczywitą rotację ekranu elementu GuiBase2d w stopniach.
Opisuje rzeczywistą rozdzielczość ekranu elementu GuiBase2d w pikselach.
Gdy ustawiono na true, lokalizacja zostanie zastosowana do tego GuiBase2d i jego potomków.
Odwołanie do LocalizationTable , które ma być użyte do zastosowania automatyzowanej lokalizacji do tego GuiBase2d i jego potomków.
Dostosowuje zachowanie wyboru pada w dół w grze.
Dostosowuje zachowanie wyboru gamepada w lewo.
Dostosowuje zachowanie wyboru gamepada w prawnym kierunku.
Dostosowuje zachowanie wyboru gamepada w kierunku góry.
Umożliwia dostosowanie ruchu wyboru gamepada.
Zdarzenia
Zdarzenia odziedziczeni z: GuiBase2d- SelectionChanged(amISelected : boolean,previousSelection : GuiObject,newSelection : GuiObject):RBXScriptSignal
Wybucha, gdy wybór gamepada przenosi się do, opuszcza lub zmienia w ramach połączonego GuiBase2d lub dowolnego potomka GuiObjects.
Właściwości
Active
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
Ustawia cel BasePart lub Attachment, do którego BillboardGui jest położony względem rodzica lub załącznika.
AlwaysOnTop
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
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
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
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
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
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
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
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
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
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
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
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
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
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ść rozmiaru | Wyjaś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
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
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.