Unterstützung mehrerer Formfaktoren und Bildschirmgrößen

Android-Geräte sind in verschiedenen Formfaktoren und Displaygrößen verfügbar. Zu den gängigen Kategorien gehören:

  • Smartphones
  • Faltbare Geräte
  • Tablets
  • Fernseher und Set-Top-Boxen
  • Laptops mit Android Runtime für Chrome

Diese Vielfalt bedeutet, dass dein Spiel auf eine Reihe verschiedener Bildschirmauflösungen trifft, oft mit unterschiedlichen Seitenverhältnissen. Beispiel:

  • Ein Smartphone im Querformat mit einem Seitenverhältnis von 19:9 (2280 × 1080)
  • Ein anderes Smartphone im Querformat mit einem Seitenverhältnis von 20:9 (3200 × 1400)
  • Ein aufgeklapptes inneres Display eines faltbaren Geräts mit einem Seitenverhältnis von 1:1 (2106 × 2106) oder 4:3 (2688 × 2016)
  • Ein 1080p-HD-Fernseher mit einem Seitenverhältnis von 16:9 (1920 × 1080)
  • Tablet mit einem Seitenverhältnis von 4:3 (2048 × 1536)

Das Design deines Spiels sollte diese Unterschiede berücksichtigen, damit es unabhängig von der Bildschirmauflösung und dem Seitenverhältnis des Geräts korrekt dargestellt wird.

Defold-Projektionsmodi

Ein Defold-Projekt hat eine konfigurierbare Basisauflösung. Diese Auflösung wird in der Datei game.project mit den Feldern Breite und Höhe in der Kategorie Anzeige festgelegt.

Anzeigeeinstellungen für Defold-Projekte
Abbildung 1. Die Projekteinstellungen für Display

Standardmäßig wird in Defold mit der Basisauflösung gerendert und das resultierende Bild dann auf die tatsächliche Auflösung des Zielgeräts skaliert. Defold bezeichnet diesen Modus als Stretch-Projektion. Bei der Stretch-Projektion wird das ursprüngliche Seitenverhältnis nicht beibehalten. Bei einigen Spielen ist diese Standardeinstellung visuell akzeptabel. Das Standard-Defold-Renderskript enthält zwei zusätzliche Projektionsoptionen, die das Basis-Seitenverhältnis beibehalten: Fixed-Fit-Projektion und Fixed-Projektion.

Das folgende Beispiel zeigt ein Beispielprojekt, das für eine Basisauflösung von 480 × 272 entwickelt wurde und im Defold-Editor angezeigt wird.

In diesem Fall gilt Folgendes:

  • Ein Tilemap-Objekt wird verwendet, um einen Rahmen um die Grenzen der Basisauflösung zu zeichnen.
  • Zwei Sprite-Objekte und ein Textobjekt befinden sich innerhalb der Grenzen der Basisauflösung.
  • Es gibt vier Sprite-Objekte, die sich außerhalb der Grenzen der Basisauflösung befinden, jeweils oben, unten, links und rechts.
Beispiel für ein Projektobjekt-Layout
Abbildung 2. Beispiel für das Layout des Projektobjekts

Bei einer Bildschirmauflösung von 960 × 544, also genau dem Doppelten der Basisauflösung, wird das Projekt so angezeigt:

Beispielprojekt mit doppelter Basisauflösung und Standard-Streckungsprojektion
Abbildung 3. Das Beispielprojekt mit der doppelten Basisauflösung und der Standardprojektion „Strecken“

Projektion strecken

Die folgenden Beispiele zeigen die Ergebnisse der Größenänderung des Fensters mit der Standardprojektion „stretch“, bei der das Seitenverhältnis nicht beibehalten wird:

Beispielprojekt, das mit der Streckungsprojektion horizontal gestaucht wurde
Abbildung 4. Das Beispielprojekt wurde horizontal gestaucht, während die Streckungsprojektion verwendet wurde
Beispielprojekt, das mit der Streckungsprojektion horizontal gestreckt wurde
Abbildung 5. Das Beispielprojekt wurde horizontal gestreckt, während die Streckungsprojektion verwendet wurde

Projektion mit fester Passform

Im Projektionsmodus fixed-fit wird das Seitenverhältnis der Basisauflösung beibehalten. Da das Seitenverhältnis beibehalten wird, gibt es einen zusätzlichen Bildschirmbereich, der nicht von der skalierten Basisauflösung abgedeckt wird. Je nach Hauptachse des Seitenverhältnisunterschieds befindet sich dieser zusätzliche Bereich entweder oben und unten oder links und rechts von der Basisauflösung. Bei der Fixed-Fit-Projektion wird die Basisauflösung geändert, um diesen Bereich zu berücksichtigen. Diese Änderung führt dazu, dass zusätzliche Bereiche der Spielszene außerhalb des Bereichs mit der Basisauflösung gerendert werden. Das resultierende Bild wird dann auf die Bildschirmauflösung skaliert.

Die folgenden Beispiele zeigen das Rendern einer Projektion mit fester Anpassung auf eine Displayauflösung mit einem anderen Seitenverhältnis als die Basisauflösung von 480 × 272:

Beispielprojekt in einem breiteren Seitenverhältnis mit fester Projektion
Abbildung 6. Das Beispielprojekt auf einem Display mit einem höheren Seitenverhältnis als dem Basis-Seitenverhältnis bei Verwendung der Projektion „Anpassen“
Beispielprojekt mit einem höheren Seitenverhältnis und der Projektion „Anpassen“
Abbildung 7. Das Beispielprojekt auf einem Display mit einem breiteren Seitenverhältnis als dem Basis-Seitenverhältnis bei Verwendung der Projektion „Anpassen“

Feste Projektion

Im Modus Feste Projektion wird das Seitenverhältnis der Basisauflösung beibehalten und die Basisauflösung um einen angegebenen Zoomfaktor skaliert. Je nach Bildschirmauflösung und Zoomfaktor wird möglicherweise eine Teilmenge oder Obermenge des Basisauflösungsbereichs angezeigt.

In den folgenden Beispielen wird der feste Projektionsmodus mit einer Bildschirmauflösung von 644 × 408 und einem Zoomfaktor von 1x bzw. 2x verwendet:

Beispielprojekt mit 644 × 408 Pixeln und 1-fachem Zoom mit fester Projektion
Abbildung 8. Das Beispielprojekt mit einer Displayauflösung von 644 × 408 bei Verwendung einer festen Projektion mit einem Zoomfaktor von 1
Beispielprojekt mit 644 x 408 Pixeln und 2-fachem Zoom mit fester Projektion
Abbildung 9. Beispielprojekt mit einer Displayauflösung von 644 × 408 und fester Projektion mit einem 2-fachen Zoomfaktor

Projektionsmodi ändern

Der aktive Projektionsmodus kann zur Laufzeit geändert werden, indem die entsprechende Nachricht an den Renderer gesendet wird. Diese Nachrichten werden über das Standard-Nachrichtensystem von Defold gesendet. Alle Nachrichten im Projektionsmodus enthalten Parameter, die die Z-Werte für die vordere und hintere Ebene angeben.

-- 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 })

Defold-Renderskripts

Das Rendering-Verhalten von Defold wird durch eine spezielle Skriptdatei gesteuert, die als Render-Skript bezeichnet wird. Wie andere Defold Engine-Skripts ist das Rendering-Skript in der Programmiersprache Lua geschrieben. Beim Erstellen des Projekts wird ein Standard-Renderskript eingefügt. Sie können es aber auch durch ein benutzerdefiniertes Renderskript ersetzen.

Das Standard-Renderskript bietet die Projektionsmodi „Strecken“, „Feste Anpassung“ und „Fest“. In jedem Modus generiert das Skript eine 2D-orthografische Projektionsmatrix, die für diesen Modus konfiguriert ist, um Spielobjekte zu rendern.

Sie können ein benutzerdefiniertes Renderskript verwenden, um die Konfiguration der Projektionsmatrix zu erweitern oder zu ändern. Funktionen, die vom Standardscript nicht unterstützt werden, z. B. Letterboxen oder Pillarboxen für verschiedene Seitenverhältnisse, können auch mit benutzerdefinierten Renderscripts implementiert werden.

Open-Source-Entwickler haben Renderskript- und Kamerapakete erstellt, die mehr Funktionen als die Standard-Defold-Skripts bieten. Zwei häufig verwendete Pakete sind RenderCam und Defold-Orthographic.

Defold-GUI-System

Defold enthält ein GUI-System, das auf dem Konzept von GUI-Szenendateien basiert. GUI-Szenendateien enthalten Objekte, die als Knoten bezeichnet werden und einzelne UI-Elemente wie Bilder oder Text definieren.

GUI-Szenendateien können als Komponente zu einem Defold-Spielobjekt hinzugefügt werden. GUI-Szenen und die darin enthaltenen Knoten werden separat gerendert und funktionieren etwas anders als normale Spielobjekte. Aufgrund dieser Unterschiede sind bei der Unterstützung mehrerer Bildschirmauflösungen mit GUI-Szenen zusätzliche Überlegungen zu GUI-Systemkoordinaten und GUI-Knoten-Drehpunkten und -Ankern erforderlich.

GUI-Systemkoordinaten

Normale Defold-Spielobjekte geben ihre Koordinaten im Weltraum an. Ein Kameraobjekt übersetzt den Weltraum in den Bildschirmraum und zeigt die Spielobjekte an, die sich in der aktuellen virtuellen Ansicht der Kamera befinden. Das GUI-System verwendet eine eigene separate Kamera. Knoten, die zu einer GUI-Szene gehören, verwenden Bildschirmkoordinaten anstelle von Weltkoordinaten. Wenn die Bildschirmauflösung von der Basisauflösung des Projekts abweicht, die für das Layout der GUI-Knoten verwendet wird, kann dies dazu führen, dass Knoten unterschiedliche Abstände zu den Bildschirmrändern oder den Rändern eines übergeordneten Knotens haben. Defold bietet mehrere Optionen, um das GUI-Layout an unterschiedliche Bildschirmauflösungen anzupassen.

GUI-Knoten-Drehpunkt und -Anker

GUI-Knoten können mit den Eigenschaften X-Anker und Y-Anker an vertikalen, horizontalen oder beiden Kanten verankert werden.

  • Wenn ein Knoten einen übergeordneten Knoten hat, wird der Anker an den Kanten des übergeordneten Knotens platziert.
  • Wenn ein Knoten keinen übergeordneten Knoten hat, wird er an den Bildschirmrändern verankert.

Das folgende Beispiel zeigt eine Beispielszene mit zwei GUI-Knoten, den Controller-Symbolen in der linken unteren und rechten oberen Ecke. Bei beiden Knoten sind X-Anker und Y-Anker auf None festgelegt:

Eine Beispielszene mit GUI-Elementen
Abbildung 10. Beispielszene mit GUI-Elementen

Wenn die Größe des Displays ohne Anker geändert wird, behalten die Controller-Symbole ihre Positionen relativ zur Basisauflösung bei:

Die Beispielszene mit angepasster Größe und GUI-Elementen, deren Anker auf „Keine“ gesetzt sind
Abbildung 11. Die Beispielszene mit angepasster Größe und GUI-Elementen, deren Anker auf None gesetzt sind

Wenn der Y-Anker des Knotens unten links auf Bottom und der Y-Anker des Knotens oben rechts auf Top gesetzt ist, werden die GUI-Knoten an den entsprechenden Bildschirmrändern verankert:

Die Beispielszene mit angepasster Größe und GUI-Elementen, deren Anker auf Kanten festgelegt sind
Abbildung 12. Die Beispielszene mit angepasster Größe und GUI-Elementen, deren Anker auf Edges gesetzt sind

Die Eigenschaft Pivot eines GUI-Knotens gibt den Punkt auf dem Begrenzungsrechteck des Knotens an, der der Eigenschaft Position im Bildschirmbereich entspricht. GUI-Knoten sind standardmäßig auf Center eingestellt, wodurch der Positionspunkt in der Mitte des Begrenzungsrechtecks platziert wird. Weitere mögliche Pivot-Einstellungen sind die vier Himmelsrichtungen und die vier Diagonalen. Die Property Pivot kann die Angabe von Randabständen vereinfachen, wenn sie in Verbindung mit den Properties X-Anker und Y-Anker verwendet wird.

Im folgenden Beispiel hat der GUI-Knoten für das Controller-Symbol unten links die Position 0,0 und den Drehpunkt Center.

Ein GUI-Knoten mit dem Drehpunkt „Mitte“
Abbildung 13. Ein GUI-Knoten, bei dem Pivot auf Center
festgelegt ist

Wenn Sie Pivot in South West ändern, wird die folgende Anpassung vorgenommen:

Ein GUI-Knoten mit dem Drehpunkt „Südwest“
Abbildung 14. Ein GUI-Knoten, bei dem Pivot auf South West
festgelegt ist

GUI-Knotenanpassungsmodi

Die Größe von GUI-Knoten kann geändert werden, wenn die Bildschirmauflösung von der Basisprojekt-Auflösung abweicht. Mit dem Attribut Anpassungsmodus wird das Skalierungsverhalten des Knoteninhalts gesteuert. Der Anpassungsmodus hat drei Einstellungen: Fit, Zoom und Stretch.

Fit

Mit der Einstellung Fit wird das Seitenverhältnis des Knoteninhaltes beibehalten. Der Inhalt wird so skaliert, dass er entweder der Breite oder der Höhe des Rechtecks des Knotens entspricht. Die ausgewählte Achse ist die mit der kleineren Differenz. So wird sichergestellt, dass der Inhalt im ursprünglichen Seitenverhältnis in das Begrenzungsrechteck passt.

Zoom

Mit der Einstellung Zoom wird auch das Seitenverhältnis des Knoteninhalts beibehalten. Wie bei der Einstellung Fit wird der Inhalt bei Zoom so skaliert, dass er entweder der Breite oder der Höhe des Rechtecks des Knotens entspricht, dessen Größe angepasst wurde. Im Gegensatz zu Fit verwendet Zoom die Achse mit dem größeren Unterschied zur Originalgröße als Übereinstimmungsziel. Das bedeutet, dass der skalierte Inhalt über das Begrenzungsrechteck hinausgehen kann.

Im Folgenden sehen Sie ein Beispiel für zwei GUI-Knoten mit unterschiedlichen Einstellungen für den Anpassungsmodus. Das Controller-Symbol unten links hat den Anpassungsmodus Fit, während das Controller-Symbol oben rechts den Anpassungsmodus Zoom hat.

Zwei GUI-Knoten mit unterschiedlichen Einstellungen für den Anpassungsmodus
Abbildung 15. Zwei GUI-Knoten mit unterschiedlichen Einstellungen für den Anpassungsmodus

Strecken

Mit der Einstellung Stretch wird der Knoteninhalt so skaliert, dass er genau in das Rechteck des Knotens passt. Das ursprüngliche Seitenverhältnis wird nicht beibehalten.

GUI-Layouts

Defold bietet eine alternative Methode zum Anpassen von GUI-Layouts an verschiedene Bildschirmauflösungen: Layouts. Layouts können einer GUI-Szene hinzugefügt werden, um die Standardeigenschaften von GUI-Knoten zu überschreiben. Ein Layout ist mit einer bestimmten Bildschirmauflösung verknüpft. Wenn mehrere Layouts verfügbar sind, wählt Defold das Layout aus, das der tatsächlichen Bildschirmauflösung am nächsten kommt. Die Standardposition, -größe, -skalierung oder -grafikressource, die von einem GUI-Knoten verwendet wird, kann durch ein Layout überschrieben werden.

Zusätzliche Ressourcen