Komponenty

Komponenty są używane, żeby nadać obiektom gry konkretne właściwości i funkcjonalności, takie jak reprezentacja graficzna, dźwiękowa czy logika gry. Komponenty muszą należeć do obiektu gry i są afektowane przez zmiany jego pozycji, orientacji i skali:

Wiele komponentów ma specyficzne właściwości, które mogą być modyfikowane. Istnieją trzy specyficzne funkcje do interakcji z nimi w trakcie działania programu:

-- disable the can "body" sprite
msg.post("can#body", "disable")

-- play "hoohoo" sound on "bean" in 1 second
sound.play("bean#hoohoo", { delay = 1, gain = 0.5 } )

Komponenty są dodawane do obiektów gry z poziomu Edytora jako ich nowe komponenty lub referencje do istniejących plików komponentów:

Naciśnij prawym przyciskiem myszki na obiekcie gry w panelu Outline i wybierz Add Component (nowy komponent) lub Add Component File (jako referencja do pliku).

W większości przypadków sens ma tworzenie nowych komponentów specyficznych dla danego obiektu, ale często możesz też wykorzystywać wspólne komponenty dla wielu obiektów, a niektóre z nich nie mogą być utworzone inaczej niż przez stworzenie wcześniej pliku:

• Skrypty
• komponenty GUI
• Efekty cząsteczkowe (Particle FX)
• Mapy kafelków (Tile maps)

Typy komponentów

Defold wspiera następujące typy komponentów:

• Collection factory - Fabryka kolekcji do tworzenia kolekcji
• Collection proxy - Pełnomocnik kolekcji do ładowania i zwalniania kolekcji
• Collision object - Obiekt kolizji do fizyki 2D i 3D
• Camera - Kamera zmieniająca rzutnię i projekcję świata gry
• Factory - Fabryka do tworzenia obiektów gry
• GUI - Graficzny interfejs użytkownika
• Label - Etykieta tekstu
• Mesh - Siatka 3D z możliwością tworzenia i modyfikowania w czasie działania gry
• Model - Model 3D z opcjonalnymi animacjami
• Particle FX - Emitowanie cząsteczek
• Script - Dodawanie logiki gry
• Sound - Odtwarzanie dźwięku lub muzyki
• Sprite - Obraz 2D z opcjonalną animacją flipbook
• Tilemap - Wyświetlanie siatki kafelków

Dodatkowe komponenty można dodać przez rozszerzenia:

• Rive model - Renderowanie animacji Rive
• Spine model - Renderowanie animacji Spine

Aktywowanie i dezaktywowanie komponentów

Komponenty obiektu gry są aktywne od chwili utworzenia tego obiektu. Jeśli chcesz wyłączyć komponent, wyślij do niego wiadomość disable:

-- wyłączenie komponentu o identyfikatorze 'weapon' na tym samym obiekcie gry, co ten skrypt
msg.post("#weapon", "disable")

-- wyłączenie komponentu o identyfikatorze 'shield' na obiekcie gry 'enemy'
msg.post("enemy#shield", "disable")

-- wyłączenie wszystkich komponentów na bieżącym obiekcie gry
msg.post(".", "disable")

-- wyłączenie wszystkich komponentów na obiekcie gry 'enemy'
msg.post("enemy", "disable")

Aby ponownie włączyć komponent, wyślij do niego wiadomość enable:

-- włączenie komponentu o identyfikatorze 'weapon'
msg.post("#weapon", "enable")

Właściwości komponentów

Typy komponentów w Defoldzie mają różne właściwości. Panel Properties w edytorze pokazuje właściwości aktualnie zaznaczonego komponentu w panelu Outline. Więcej informacji o dostępnych właściwościach znajdziesz w instrukcjach poszczególnych typów komponentów.

Położenie, obrót i skala komponentów

Komponenty wizualne zwykle mają właściwość położenia i obrotu, a najczęściej także skalę. Właściwości te można zmieniać w edytorze, ale w niemal wszystkich przypadkach nie da się ich zmienić w czasie działania gry. Wyjątkiem jest skala komponentów sprite i label, którą można zmieniać także w trakcie działania.

Jeśli musisz zmienić położenie, obrót albo skalę komponentu w czasie działania gry, zmień zamiast tego położenie, obrót albo skalę obiektu gry, do którego ten komponent należy. Ma to jednak taki skutek uboczny, że wpłynie na wszystkie komponenty na tym obiekcie gry. Jeśli chcesz sterować tylko jednym komponentem spośród wielu przypisanych do obiektu gry, zaleca się przenieść ten komponent do osobnego obiektu gry i dodać go jako obiekt potomny do obiektu gry, do którego pierwotnie należał.

Kolejność rysowania komponentów

Kolejność rysowania komponentów wizualnych zależy od dwóch rzeczy:

Predykaty skryptu do renderowania

Każdemu komponentowi przypisany jest material, a każdy material ma jeden lub więcej tagów. Z kolei skrypt do renderowania definiuje zestaw predykatów, a każdy z nich dopasowuje jeden lub więcej tagów materiału. Predykaty są rysowane jeden po drugim w funkcji update() skryptu do renderowania, a następnie rysowane są komponenty pasujące do tagów zdefiniowanych w każdym predykacie. Domyślny skrypt do renderowania najpierw rysuje sprite’y i tilemapy w jednym przebiegu, potem efekty cząsteczkowe w drugim przebiegu, oba w przestrzeni świata. Następnie przechodzi do rysowania komponentów GUI w osobnym przebiegu w przestrzeni ekranu.

Wartość Z komponentu

Wszystkie obiekty gry i komponenty są umieszczone w przestrzeni 3D, a ich pozycje są wyrażane jako obiekty vector3. Gdy oglądasz grafikę swojej gry w 2D, wartości X i Y określają położenie obiektu na osiach szerokości i wysokości, a pozycja Z określa położenie na osi głębokości. Pozycja Z pozwala kontrolować widoczność nakładających się obiektów: sprite z wartością Z równą 1 pojawi się przed sprite’em na pozycji Z równej 0. Domyślnie Defold używa układu współrzędnych, w którym wartości Z mieszczą się w zakresie od -1 do 1:

Komponenty pasujące do predykatu renderowania są rysowane razem, a kolejność ich rysowania zależy od końcowej wartości Z komponentu. Końcowa wartość Z komponentu jest sumą wartości Z samego komponentu, obiektu gry, do którego należy, oraz wartości Z wszystkich nadrzędnych obiektów gry.

Przykład: Dwa obiekty gry A i B. B jest obiektem potomnym A. B ma komponent sprite.

W powyższej hierarchii końcowa wartość Z komponentu sprite na obiekcie B wynosi 2 + 1 + 0.5 = 3.5.

Optymalizacja limitów liczby komponentów

Plik ustawień game.project zawiera wiele wartości określających maksymalną liczbę danego zasobu, który może istnieć jednocześnie, zwykle w przeliczeniu na załadowaną kolekcję, nazywaną też światem (ang. world). Silnik Defold używa tych wartości do wstępnej alokacji pamięci, aby ograniczyć dynamiczne alokacje i fragmentację pamięci podczas działania gry.

Struktury danych Defold używane do reprezentowania komponentów i innych zasobów są zoptymalizowane pod kątem jak najmniejszego zużycia pamięci, ale przy ustawianiu tych wartości nadal trzeba zachować ostrożność, aby nie przydzielać więcej pamięci, niż naprawdę potrzeba.

Aby dodatkowo zoptymalizować zużycie pamięci, proces budowania w Defold analizuje zawartość gry i nadpisuje wartości maksymalne tam, gdzie można z całkowitą pewnością określić dokładną liczbę:

• Jeśli kolekcja nie zawiera żadnych komponentów Factory, zostanie zaalokowana dokładna liczba każdego komponentu i obiektu gry, a wartości maksymalne zostaną zignorowane.
• Jeśli kolekcja zawiera komponent Factory, obiekty tworzone przez tę fabrykę zostaną przeanalizowane, a dla komponentów możliwych do utworzenia przez Factory oraz dla obiektów gry zostaną użyte wartości maksymalne.
• Jeśli kolekcja zawiera komponent Factory albo Collection factory z włączoną opcją Dynamic Prototype, ta kolekcja będzie używać liczników maksymalnych.