Wayland 1.25: Protokoll-Updates und Protokolle

Wayland 1.25: Wichtige Protokoll-Updates und Erweiterungen

Am 19. März 2026 wurde Version 1.25 des Wayland-Protokolls veröffentlicht – ein Grafikprotokoll, das Interprozesskommunikation und Bibliotheken für Compositoren bereitstellt. Das Update ist auf API- und ABI-Ebene abwärtskompatibel zu vorherigen 1.x-Releases. Der Hauptfokus liegt auf Bugfixes, Verbesserungen der Dokumentation und dem Hinzufügen gezielter Protokollfunktionen. Die MIT-Lizenz wird für alle Komponenten beibehalten.

Der Referenz-Compositor Weston entwickelt sich weiterhin separat und bietet Beispiele für die Wayland-Integration in Desktops und eingebetteten Systemen.

Änderungen im Kernprotokoll

Die Entwickler haben die Dokumentation überarbeitet: Das DocBook-Format wurde durch mdBook auf Basis von Markdown ersetzt. Es deckt vollständig den Wayland-XML-Dialekt, das Content-Update-Modell und das Farbmanagement ab.

Neue Elemente hinzugefügt:

• Das frozen-Attribut für Interfaces mit mehreren Parents – vereinfacht die Zustandsverwaltung in komplexen Hierarchien.
• Die Anfrage wl_surface.get_release – erzeugt eine Benachrichtigung zum Freigeben des über wl_surface.attach angehängten Buffers. Im Gegensatz zu wl_buffer.release ist das Event an einen spezifischen Renderzyklus gebunden und verbessert so die Vorhersagbarkeit beim Rendering.
• Die Funktion wl_display_dispatch_pending_single() – holt und verarbeitet genau ein Event aus der Queue, im Gegensatz zu wl_display_dispatch_pending(), die die gesamte Queue entleert.

Die WAYLAND_DEBUG-Debug-Ausgabe unterstützt nun Farbmarkierungen für bessere Lesbarkeit der Logs.

Neue und verfeinerte Wayland-Protokolle

Seit der Veröffentlichung wurden Erweiterungen hinzugefügt, die das Kernprotokoll ergänzen. Sie werden separat verteilt und konzentrieren sich auf Text-Eingabe und Farbmanagement.

Protokolle für Text-Eingabe

• xx-input-method: Ermöglicht Anwendungen, Text für Compositoren zu bilden. Verwendet in virtuellen Tastaturen und IME (Eingabemethode-Editor). Clients erzeugen Eingabe-Events, und der Server aggregiert sie.

• xx-text-input: Der Server sendet Text an Anwendungen. Es standardisiert:

- Text-Eingabeübertragung.

- Handhabung des Eingabefokus.

- Sprache, Auswahl und Feldtyp (Passwort, Mehrzeilig usw.).

Farbmanagement

Die Protokolle color-management-v1 und color-representation-v1 wurden verfeinert:

• HDR-Unterstützung.
• Definieren des Farbraums für Wayland-Surfaces.
• Integration mit Buffern für genaue Übertragung von Farbprofilen.

Diese Erweiterungen vereinfachen die Implementierung in Compositoren wie Weston oder Mutter.

Praktischer Nutzen für Entwickler

Die Updates richten sich an Entwickler auf Mittel- und Senior-Niveau, die mit benutzerdefinierten Compositoren arbeiten. Das neue frozen-Attribut ist nützlich in Szenarien mit dynamischen Parents, wie Overlay-Managern.

Die Funktion wl_display_dispatch_pending_single() löst Probleme in ereignisgesteuerten Architekturen, wo das vollständige Verarbeiten der Queue die Benutzeroberfläche blockieren kann.

Für die IME-Entwicklung standardisieren die Protokolle xx-input-method und xx-text-input die Interaktionen und minimieren herstellerspezifische Hacks.

Beispiel für die Integration von wl_surface.get_release in einem Client (Pseudocode):

wl_surface_add_listener(surface, &surface_listener, data);

static void surface_release(void *data, struct wl_surface *surface, uint32_t serial) {
    // Buffer released after commit
    buffer_pool_release(buffer);
}

Dies gewährleistet eine rechtzeitige Bereinigung der Ressourcen ohne Race Conditions.

Wichtige Punkte

• mdBook-Dokumentation und vollständige XML-/Farbabdeckung beschleunigen das Onboarding für neue Entwickler.
• wl_surface.get_release bindet Events an Frames und verbessert die Rendering-Genauigkeit.
• wl_display_dispatch_pending_single() bietet granulare Kontrolle über Events.
• Neue Eingabeprotokolle standardisieren IME für Kompatibilität über Compositoren hinweg.
• Verfeinerungen im Farbmanagement stärken die HDR-Unterstützung im Wayland-Ökosystem.

— Editorial Team