Godot-Control-Layout: Festlegen, wer Position und Grösse bestimmt

Zuständigkeit für die Platzierung festlegen

Ein Control beschreibt ein rechteckiges UI-Element. Sein Layout hängt vom Parent, von Anchors, Offsets und Grössenbeschränkungen ab. Ein direktes Kind eines Containers überlässt die Platzierung diesem Container; eine manuelle Verschiebung kann beim nächsten Layoutvorgang wieder überschrieben werden. Bevor im Inspector Zahlenwerte geändert werden, ist zu klären, ob das Element frei positioniert oder von einem Parent angeordnet wird. [1][3]

Anchors und Offsets als Rechnung lesen

Anchors legen Referenzpunkte relativ zum Rechteck des Parents fest. Offsets verschieben anschliessend die zugehörigen Kanten ausgehend von diesen Referenzpunkten. Gleiche horizontale Anchors binden beide Kanten an denselben horizontalen Referenzpunkt; unterschiedliche Anchors erlauben, dass sich die Breite mit dem Parent ändert. [2]

Beispielhaft für ein rechtsbündiges Statuspanel: anchor_left und anchor_right auf 1, offset_left auf -240 und offset_right auf -20 setzen. In einem unskalierten Koordinatenraum des Parents mit der Breite 1000 liegen die Kanten bei 760 und 980. Das Panel ist dann 220 Einheiten breit und hat rechts einen Rand von 20 Einheiten. Bei einer Parent-Breite von 1200 liegen die Kanten bei 960 und 1180. Die vertikale Platzierung ist eine separate Entscheidung. Die Rechnung setzt voraus, dass weder ein Container noch eine Grössenbeschränkung das Rechteck überschreibt.

Beziehungen durch Container ausdrücken

Für eine Zeile dient ein HBoxContainer, für eine Spalte ein VBoxContainer. Ein MarginContainer sorgt über Theme-Konstanten für Innenabstände. Diese Container lassen sich verschachteln, wenn die Beziehung zwischen den Kindern wichtiger ist als die absolute Position jedes einzelnen. [3]

Auch die Grössenoptionen der Container sind zu unterscheiden: Fill sorgt dafür, dass ein Control den ihm zugewiesenen Bereich ausfüllt, Expand fordert in einer unterstützten Richtung verfügbaren Platz an. Die Wirkung hängt vom Containertyp ab. Bei einer Einstellungszeile sollten Label und Wert bewusst angeordnet werden, statt den Wert per Skript jedes Mal zu verschieben, wenn sich das Label ändert. [3]

Minimalgrösse als Information über den Inhalt behandeln

Das interne Minimum eines Controls kann von Text, Texturen und den StyleBoxes des Themes abhängen. custom_minimum_size steuert ein zusätzliches angefordertes Minimum bei; es ist nicht einfach ein Befehl, ein festes Rechteck zu erzwingen. Die zitierte Control-API dokumentiert zudem Beschränkungen der Maximalgrösse, die Vorrang vor Minima haben können. Bei überraschenden Ergebnissen sind alle aktiven Beschränkungen gemeinsam zu prüfen. [1]

Bei einem lokalisierten Einstellungsbildschirm empfiehlt es sich, sinnvollen Platz zu reservieren, aber längere Labels das Design mitbestimmen zu lassen. Wenn Inhalte nicht passen, kommen Umbruch, Scrollen oder eine andere Anordnung in Frage. Kleine, erzwungene Koordinaten beseitigen den Platzbedarf des Textes nicht, und wer jedes Minimum vergrössert, erhält in einem kleinen Fenster unter Umständen kein mögliches Layout mehr.

Grössenänderungen und Zuständigkeitswechsel prüfen

Statuspanel und Einstellungszeilen sind bei schmalen und breiten Parent-Grössen zu prüfen, mit längeren übersetzten Texten und veränderten Theme-Abmessungen. Bevor ein Anchor-Preset verantwortlich gemacht wird, ist der tatsächlich steuernde Parent zu untersuchen. Wird ein frei platziertes Control in einen Container verschoben (Reparenting), ist sein Layoutvertrag neu zu überdenken; die bisherigen manuellen Offsets bestimmen das Ergebnis womöglich nicht mehr. [2][3]

Layoutkorrekturen gehören an die Stelle, die für die jeweilige Beziehung zuständig ist. Es handelt sich hier um vorgeschlagene Prüffälle und Rechenbeispiele, nicht um die Behauptung, die Oberfläche sei auf bestimmten Geräten getestet worden.

Quellen

1. Control — Godot Engine contributors.
2. Size and anchors — Godot Engine contributors.
3. Using Containers — Godot Engine contributors.