Kontenery UI w doświadczeniu

Kontenery UI w doświadczeniu zawierają GuiObjects, które chcesz wyświetlić w 3D w środowisku twojego doświadczenia.

• SurfaceGui pozwala na renderowanie obiektów UI na powierzchni partu w świecie 3D, jednocześnie umożliwiając podstawową interakcję użytkownika.
• BillboardGui jest kontenerem dla obiektów UI, które pojawiają się w przestrzeni 3D, ale zawsze zwracają się w stronę kamery.

UI powierzchni

Podobnie jak Decals i Textures, obiekty UI, takie jak TextLabels i ImageLabels, będące dziećmi SurfaceGui, zwracają się w tym samym kierunku co powierzchnia, na której się znajdują, co można edytować poprzez właściwość SurfaceGui.Face.

Aby zastosować SurfaceGui do BasePart w doświadczeniu, wystarczy dodać go jako dziecko do tego partu i ustawić właściwość SurfaceGui.Face. Dzieci obiektów UI pojawią się na tej stronie rodzica.

Alternatywnie możesz umieścić SurfaceGui wewnątrz kontenera, takiego jak StarterGui, a następnie ustawić jego właściwość Adornee na dowolny BasePart, jak również na docelowy Face. Ustawienie Adornee nadpisuje bezpośrednie powiązanie rodzica, co pozwala na większą elastyczność w umieszczaniu, ponieważ można je ustawić z poziomu skryptu podczas działania.

Rozmiar i pozycja

"Canvas" SurfaceGui zajmuje całą stronę Face rodzica lub partu Adornee. Jako najlepsza praktyka, zaleca się używanie wartości skali dla rozmiaru i pozycji dzieci obiektów UI, takich jak ImageLabels. Możesz również zastosować UIAspectRatioConstraint do dzieci SurfaceGui, aby zachować pożądany stosunek proporcji niezależnie od rozmiaru strony.

Tryb okluzji

Właściwość AlwaysOnTop określa, czy SurfaceGui będzie renderowany nad treścią 3D, czy też będzie przez nią zasłaniany. Gdy jest ustawiona na false (domyślnie), SurfaceGui renderuje się jak inne treści 3D i jest zasłaniany przez inne obiekty 3D. Gdy jest ustawiona na true, zawsze renderuje nad treścią 3D i nie jest wpływana przez jasność/światło w środowisku 3D.

Wpływ jasności i światła

Brightness oraz LightInfluence działają razem, aby określić, jak światło środowiskowe wpływa na zawartość UI SurfaceGui.

Brightness określa czynnik, w jakim emitowane światło jest skalowane w zakresie od 0 do 1000, pozwalając Ci dopasować SurfaceGui do jego otoczenia. Na przykład, billboard wideo może być rozjaśniony w ciemnym pomieszczeniu przez zwiększenie Brightness do 10.

LightInfluence kontroluje, jak bardzo SurfaceGui jest wpływany przez oświetlenie w miejscu, w zakresie od 0 do 1. Ustawienie tego na 1 oznacza, że otaczające oświetlenie całkowicie kontroluje wygląd, podczas gdy ustawienie na 0 oznacza, że oświetlenie nie ma wpływu.

Widoczność z odległości

MaxDistance kontroluje jak daleko od kamery SurfaceGui będzie wyświetlane, zanim przestanie się renderować. Wartość 0 oznacza brak limitu i będzie renderować się w nieskończoność. Domyślna wartość 1000 działa dobrze w większości przypadków.

Dla SurfaceGuis, które pojawiają się na zewnątrz, zaleca się, aby MaxDistance była wystarczająco wysoka, aby UI kontenera była wystarczająco mała na ekranie, gdy pojawia się lub znika, minimalizując nagły efekt pojawiania się/znikania.

Kolejność wyświetlania

Jeśli wiele kontenerów SurfaceGui istnieje na tej samej stronie, możesz je warstwić przez Z‑index za pomocą właściwości ZOffset (zmiana ta nie wizualnie "podnosi" ani "obniża" kontenera względem powierzchni).

UI billboard

Kontener BillboardGui wyświetla obiekty UI w przestrzeni 3D, ale w przeciwieństwie do SurfaceGui, dzieci BillboardGui zawsze zwracają się w stronę kamery. Ten kontener jest przydatny do wyświetlania informacji zwracających się ku przodowi powyżej obiektów w doświadczeniu, takich jak liczniki zdrowia czy imiona nad postaciami graczy, znaki wskazujące graczom na obiekt w przestrzeni 3D i inne.

Aby połączyć BillboardGui z BasePart lub Attachment w doświadczeniu, wystarczy dodać go jako dziecko do tej części lub przymocowania i, jeśli to konieczne, dostosować jego rozmiar/pozycję.

Alternatywnie możesz umieścić BillboardGui wewnątrz kontenera, takiego jak StarterGui, a następnie ustawić jego właściwość Adornee na dowolny BasePart lub Attachment. Ta metoda oferuje większą elastyczność w umieszczaniu, ponieważ Adornee może być ustawione z poziomu skryptu podczas działania, na przykład, aby umieścić BillboardGui nad głowami postaci graczy podczas działania.

Rozmiar i pozycja

Dla rozmiaru billboardu komponenty skali właściwości Size ustawiają wielkość billboardu w studach w przestrzeni 3D. Na przykład, ustawienie {10, 0},{2, 0} (UDim2.fromScale(10, 2)) tworzy billboard o stosunku proporcji 10:2, który skaluje się w górę lub w dół w zależności od odległości od kamery.

Dla pozycji, właściwość StudsOffset przesuwa ekran billboardu na osi X (lewo/prawo), osi Y (góra/dół) i osi Z (przód/tył) w stosunku do kamery.

Tryb okluzji

Właściwość AlwaysOnTop określa, czy BillboardGui będzie renderowany nad treścią 3D, czy też będzie przez nią zasłaniany. Gdy jest ustawiona na false (domyślnie), BillboardGui renderuje się jak inne treści 3D i jest zasłaniany przez inne obiekty 3D. Gdy jest ustawiona na true, zawsze renderuje się nad treścią 3D i nie jest wpływana przez jasność/light w środowisku 3D.

Wpływ jasności i światła

Brightness oraz LightInfluence działają razem, aby określić, jak światło środowiskowe wpływa na zawartość UI BillboardGui.

Brightness określa czynnik, w jakim emitowane światło jest skalowane w zakresie od 0 do 1000, co pozwala dostosować BillboardGui do jego otoczenia. Na przykład, tablica wideo może być rozjaśniona w ciemnym pomieszczeniu, zwiększając Brightness do 10.

LightInfluence kontroluje, jak bardzo BillboardGui jest wpływany przez oświetlenie w miejscu, w zakresie od 0 do 1. Ustawienie tego na 1 oznacza, że otaczające oświetlenie całkowicie kontroluje wygląd, podczas gdy ustawienie na 0 oznacza, że oświetlenie nie ma wpływu.

Widoczność z odległości

MaxDistance kontroluje, jak daleko od kamery BillboardGui będzie wyświetlane, zanim przestanie się renderować. Wartość 0 lub inf (domyślnie) oznacza brak limitu i będzie renderować się w nieskończoność.