Obsługa różnych formatów i rozmiarów ekranów

Urządzenia z Androidem są dostępne w różnych formatach i rozmiarach ekranu. Typowe kategorie:

  • Telefony komórkowe
  • Urządzenia składane
  • Tablety
  • telewizory i dekodery,
  • Laptopy ze środowiskiem wykonawczym Androida w Chrome

Ta różnorodność oznacza, że gra musi obsługiwać różne rozdzielczości ekranu, często o różnych formatach obrazu. Przykład:

  • Telefon w orientacji poziomej o formacie obrazu 19:9 (2280 x 1080)
  • Inny telefon w orientacji poziomej o formacie obrazu 20:9 (3200 x 1400)
  • rozkładany wewnętrzny wyświetlacz o formacie obrazu 1:1 (2106 × 2106) lub 4:3 (2688 × 2016);
  • telewizor HD 1080p o formacie obrazu 16:9 (1920 x 1080),
  • tablet o formacie obrazu 4:3 (2048 x 1536),

Projekt gry powinien uwzględniać te różnice, aby zapewnić prawidłowe wyświetlanie niezależnie od rozdzielczości ekranu i formatu obrazu urządzenia.

Tryby projekcji Defold

Projekt Defold ma konfigurowalną rozdzielczość podstawową. Rozdzielczość jest ustawiana w pliku game.project za pomocą pól Width (Szerokość) i Height (Wysokość) w kategorii Display (Wyświetlacz).

Ustawienia wyświetlania projektu Defold
Rysunek 1. Ustawienia projektu Wyświetlacz

Domyślnie Defold renderuje obraz w rozdzielczości podstawowej, a następnie skaluje go do rzeczywistej rozdzielczości urządzenia docelowego. W Defold ten tryb jest nazywany projekcją rozciągniętą. Projekcja rozciągnięta nie zachowuje oryginalnego formatu obrazu. W przypadku niektórych gier ta domyślna wartość może być wizualnie akceptowalna. Standardowy skrypt renderowania Defold zawiera 2 dodatkowe opcje projekcji, które zachowują podstawowy format obrazu: projekcję ze stałym dopasowaniem i projekcję stałą.

Poniższy przykład pokazuje przykładowy projekt zaprojektowany wokół podstawowej rozdzielczości 480 x 272, wyświetlany w edytorze Defold.

W tym przykładzie:

  • Obiekt mapy kafelkowej służy do rysowania ramki wokół granic rozdzielczości podstawowej.
  • W granicach rozdzielczości podstawowej znajdują się 2 obiekty sprite i obiekt tekstowy.
  • Istnieją 4 obiekty sprite umieszczone poza granicami rozdzielczości podstawowej – odpowiednio powyżej, poniżej, po lewej i po prawej stronie.
Przykładowy układ obiektu projektu
Rysunek 2. Przykładowy układ obiektu projektu

Po uruchomieniu w rozdzielczości 960 x 544, czyli dokładnie 2 razy większej niż rozdzielczość podstawowa, projekt wyświetla się w ten sposób:

Przykładowy projekt w rozdzielczości 2x bazowej z użyciem domyślnej projekcji rozciągniętej
Rysunek 3. Przykładowy projekt w rozdzielczości 2x podstawowej, z użyciem domyślnej projekcji rozciągniętej

Rozciągnięcie

Poniższe przykłady pokazują wyniki zmiany rozmiaru okna z domyślną projekcją rozciągniętą, w której format obrazu nie jest zachowywany:

Przykładowy projekt ściśnięty w poziomie przy użyciu projekcji rozciągniętej
Rysunek 4. Przykładowy projekt ściśnięty w poziomie podczas korzystania z projekcji rozciągniętej
Przykładowy projekt rozciągnięty w poziomie za pomocą projekcji rozciągniętej
Rysunek 5. Przykładowy projekt rozciągnięty w poziomie przy użyciu projekcji rozciągniętej

Projekcja o stałym dopasowaniu

Tryb projekcji fixed-fit zachowuje format obrazu rozdzielczości podstawowej. Format obrazu jest zachowywany, więc na ekranie będzie dodatkowy obszar, który nie jest objęty skalowaną rozdzielczością podstawową. W zależności od głównej osi różnicy formatu obrazu ten dodatkowy obszar znajduje się u góry i u dołu lub po lewej i prawej stronie rozdzielczości podstawowej. Projekcja o stałym dopasowaniu modyfikuje rozdzielczość podstawową, aby uwzględnić ten obszar. Ta modyfikacja powoduje renderowanie dodatkowych obszarów sceny gry poza regionem rozdzielczości podstawowej. Następnie obraz jest skalowany do rozdzielczości wyświetlacza.

Poniższe przykłady pokazują renderowanie projekcji ze stałym dopasowaniem do rozdzielczości wyświetlacza o innym formacie obrazu niż rozdzielczość podstawowa 480 x 272:

Przykładowy projekt w szerszym formacie obrazu z projekcją o stałym dopasowaniu
Rysunek 6. Przykładowy projekt na wyświetlaczu o formacie obrazu wyższym niż podstawowy format obrazu przy użyciu projekcji ze stałym dopasowaniem
Przykładowy projekt w wyższym formacie obrazu z użyciem projekcji dopasowanej do stałego rozmiaru
Rysunek 7. Przykładowy projekt na wyświetlaczu o szerszym formacie obrazu niż podstawowy format obrazu przy użyciu projekcji ze stałym dopasowaniem

Stała prognoza

Tryb stałej projekcji zachowuje format obrazu rozdzielczości podstawowej i skaluje rozdzielczość podstawową o określony współczynnik powiększenia. W zależności od rozdzielczości wyświetlacza i współczynnika powiększenia może być wyświetlany podzbiór lub nadzbiór obszaru rozdzielczości podstawowej.

Poniższe przykłady pokazują tryb stałej projekcji przy rozdzielczości ekranu 644 x 408 z powiększeniem odpowiednio 1x i 2x:

Przykładowy projekt o wymiarach 644 x 408 z powiększeniem 1x i stałą projekcją
Rysunek 8. Przykładowy projekt w rozdzielczości 644 × 408 przy użyciu stałej projekcji z powiększeniem 1×
Przykładowy projekt o wymiarach 644 × 408 z powiększeniem 2x i stałą projekcją
Rysunek 9. Przykładowy projekt w rozdzielczości 644 x 408 z użyciem stałej projekcji i powiększenia 2x

Zmiana trybów projekcji

Aktywny tryb projekcji można przełączyć w czasie działania, wysyłając odpowiedni komunikat do mechanizmu renderowania. Te wiadomości są wysyłane przy użyciu standardowego systemu wiadomości Defold. Wszystkie komunikaty trybu projekcji zawierają parametry określające wartości Z płaszczyzny bliskiej i dalekiej.

-- Change to stretch projection mode
msg.post("@render:", "use_stretch_projection", { near = -1, far = 1 })

-- Change to fixed fit projection mode
msg.post("@render:", "use_fixed_fit_projection", { near = -1, far = 1 })

-- Change to fixed projection mode
msg.post("@render:", "use_fixed_projection", { near = -1, far = 1, zoom = 2 })

Skrypty renderowania Defold

Sposób renderowania w Defoldzie jest kontrolowany przez specjalny plik skryptu nazywany skryptem renderowania. Podobnie jak inne skrypty Defold Engine, skrypt renderowania jest napisany w języku programowania Lua. Domyślny skrypt renderowania jest dołączany podczas tworzenia projektu, ale możesz go zastąpić skryptem renderowania niestandardowego.

Domyślny skrypt renderowania udostępnia tryby projekcji: rozciągnięty, dopasowany i stały. W każdym trybie skrypt generuje dwuwymiarową ortograficzną macierz projekcji skonfigurowaną dla tego trybu, aby renderować obiekty gry.

Możesz użyć niestandardowego skryptu renderowania, aby rozszerzyć lub zmienić konfigurację macierzy projekcji. Funkcje nieobsługiwane przez skrypt domyślny, takie jak pasy u góry i u dołu ekranu lub po bokach w przypadku różnych formatów obrazu, można też implementować za pomocą niestandardowych skryptów renderowania.

Deweloperzy open source utworzyli skrypt renderowania i pakiety aparatu, które oferują więcej funkcji niż domyślne skrypty Defold. Dwa powszechnie używane pakiety to RenderCam i Defold-Orthographic.

System GUI Defold

Defold zawiera system GUI oparty na koncepcji plików scen GUI. Pliki scen GUI zawierają obiekty nazywane węzłami, które definiują poszczególne elementy interfejsu, takie jak obrazy czy tekst.

Pliki scen GUI można dodawać jako komponent do obiektu gry Defold. Sceny GUI i zawarte w nich węzły są renderowane oddzielnie i działają nieco inaczej niż zwykłe obiekty gry. Z powodu tych różnic obsługa wielu rozdzielczości wyświetlania w scenach GUI wymaga dodatkowych działań związanych ze współrzędnymi systemu GUI oraz punktami obrotu i zakotwiczenia węzłów GUI.

Współrzędne systemu GUI

Normalne obiekty gry Defold określają swoje współrzędne w przestrzeni świata. Obiekt kamery przekłada przestrzeń świata na przestrzeń ekranu i wyświetla obiekty gry, które znajdują się w bieżącym widoku wirtualnym kamery. System GUI używa własnej, osobnej kamery. Węzły należące do sceny GUI używają współrzędnych przestrzeni ekranu zamiast współrzędnych przestrzeni świata. Gdy rozdzielczość wyświetlacza różni się od podstawowej rozdzielczości projektu używanej do układania węzłów GUI, może to spowodować, że węzły będą miały różne marginesy względem krawędzi ekranu lub krawędzi węzła nadrzędnego. Defold ma kilka opcji dostosowywania układu GUI do różnych rozdzielczości wyświetlacza.

Punkt obrotu i kotwice węzła GUI

Węzły GUI można zakotwiczyć do krawędzi pionowych, poziomych lub obu za pomocą właściwości Kotwica X i Kotwica Y.

  • Jeśli węzeł ma węzeł nadrzędny, kotwica jest przypięta do krawędzi węzła nadrzędnego.
  • Jeśli węzeł nie ma węzła nadrzędnego, kotwica jest przypięta do krawędzi ekranu.

Poniżej przedstawiono przykładową scenę z 2 węzłami GUI, ikonami kontrolera w lewym dolnym i prawym górnym rogu. W obu węzłach właściwości Kotwica X i Kotwica Y są ustawione na None:

Przykładowa scena z elementami GUI
Rysunek 10. Przykładowa scena z elementami GUI

Gdy rozmiar wyświetlacza zostanie zmieniony bez kotwicy, ikony kontrolera zachowają swoje pozycje względem rozdzielczości podstawowej:

Przykładowa scena o zmienionym rozmiarze z elementami GUI, które mają kotwice ustawione na „brak”
Rysunek 11. Przykładowa scena po zmianie rozmiaru z elementami GUI, których kotwice są ustawione na None

Gdy kotwica Y węzła w lewym dolnym rogu jest ustawiona na Bottom, a kotwica Y węzła w prawym górnym rogu jest ustawiona na Top, węzły GUI zostaną zakotwiczone do odpowiednich krawędzi ekranu:

Przykładowa scena o zmienionym rozmiarze z elementami GUI, których kotwice są ustawione na krawędzie
Rysunek 12. Przykładowa scena po zmianie rozmiaru z elementami GUI, których kotwice są ustawione na Edges

Właściwość Pivot węzła GUI określa punkt na prostokącie granic węzła, który odpowiada właściwości Position współrzędnej przestrzeni ekranu. Węzły GUI domyślnie mają ustawienie Center, które umieszcza punkt Pozycja w samym środku prostokąta ograniczającego. Inne możliwe ustawienia obrotu obejmują 4 główne kierunki i 4 kierunki pośrednie. Właściwość Pivot (Punkt obrotu) może uprościć określanie marginesów, gdy jest używana w połączeniu z właściwościami X Anchor (Punkt zakotwiczenia X) i Y Anchor (Punkt zakotwiczenia Y).

W przykładzie poniżej węzeł GUI ikony kontrolera w lewym dolnym rogu ma pozycję 0,0 i punkt obrotu ustawiony na Center.

Węzeł GUI z punktem obrotu ustawionym na środek
Rysunek 13. Węzeł GUI z punktem obrotu ustawionym na Center

Zmiana Pivot na South West powoduje następującą korektę:

Węzeł GUI z punktem obrotu ustawionym na południowy zachód
Rysunek 14. Węzeł GUI z punktem obrotu ustawionym na South West

Tryby dostosowywania węzłów GUI

Rozmiar węzłów GUI może się zmienić, gdy rozdzielczość wyświetlacza różni się od podstawowej rozdzielczości projektu. Właściwość Tryb dostosowania kontroluje zachowanie skalowania zawartości węzła. Tryb dostosowania ma 3 ustawienia: Fit, Zoom i Stretch.

Dopasuj

Ustawienie Fit zachowuje format obrazu zawartości węzła. Treść jest skalowana, aby dopasować ją do szerokości lub wysokości prostokąta ograniczającego węzła o zmienionym rozmiarze. Wybrana oś to ta, na której różnica jest mniejsza. Dzięki temu treść mieści się w prostokącie ograniczającym z zachowaniem oryginalnego formatu obrazu.

Zoom

Ustawienie Zoom zachowuje też format obrazu zawartości węzła. Podobnie jak ustawienie Fit, Zoom skaluje zawartość, aby dopasować ją do szerokości lub wysokości prostokąta o zmienionym rozmiarze węzła. W przeciwieństwie do Fit Zoom używa osi z większą różnicą od oryginalnego rozmiaru jako celu dopasowania. Oznacza to, że przeskalowana treść może wykraczać poza prostokąt ograniczający.

Poniżej pokazujemy przykład 2 węzłów GUI z różnymi ustawieniami trybu dostosowania. Ikona kontrolera w lewym dolnym rogu ma tryb dostosowania Fit, a ikona kontrolera w prawym górnym rogu ma tryb dostosowania Zoom.

Dwa węzły GUI z różnymi ustawieniami trybu dostosowania
Rysunek 15. Dwa węzły GUI z różnymi ustawieniami trybu dostosowania

Rozciągnij

Ustawienie Stretch skaluje zawartość węzła, aby dokładnie pasowała do prostokąta o zmienionym rozmiarze. Oryginalny format obrazu nie zostanie zachowany.

Układy GUI

Defold ma alternatywną metodę dostosowywania układów GUI do różnych rozdzielczości ekranu: układy. Układy można dodawać do sceny GUI, aby zastąpić domyślne właściwości węzła GUI. Układ jest powiązany z konkretną rozdzielczością ekranu. Jeśli dostępnych jest kilka układów, Defold wybierze ten, który najbardziej odpowiada rzeczywistej rozdzielczości ekranu. Domyślne położenie, rozmiar, skalę lub zasób graficzny używany przez węzeł GUI można zastąpić układem.

Dodatkowe materiały