WaylandCompositor QML Type
Verwaltet den Wayland-Anzeigeserver. Mehr...
Import Statement: | import QtWayland.Compositor |
In C++: | QWaylandCompositor |
Eigenschaften
- additionalShmFormats : list<enum>
(since 6.0)
- created : bool
- defaultOutput : WaylandOutput
- defaultSeat : WaylandSeat
- extensions : list
- retainedSelection : bool
- socketName : string
- useHardwareIntegrationExtension : bool
Signale
- void surfaceCreated(WaylandSurface surface)
- void surfaceRequested(WaylandClient client, int id, int version)
Methoden
- addSocketDescriptor(fd)
- destroyClient(client)
- destroyClientForSurface(surface)
Detaillierte Beschreibung
Der WaylandCompositor verwaltet die Verbindungen zu den Clients, sowie die verschiedenen outputs und seats.
Normalerweise hat eine Compositor-Anwendung eine einzige WaylandCompositor-Instanz, die mehrere Ausgaben als Kinder haben kann. Wenn ein Client den Compositor auffordert, eine Oberfläche zu erstellen, wird die Anforderung durch den onSurfaceRequested-Handler bearbeitet.
Erweiterungen, die vom Compositor unterstützt werden, sollten instanziiert und zur Eigenschaft extensions hinzugefügt werden.
Eigenschaft Documentation
additionalShmFormats : list<enum> |
Diese Eigenschaft enthält die Liste der zusätzlichen wl_shm-Formate, die vom Compositor unterstützt werden.
Standardmäßig werden nur die erforderlichen Formate ShmFormat_ARGB8888 und ShmFormat_XRGB8888 aufgelistet und diese Liste ist leer. Zusätzliche Formate erfordern möglicherweise eine interne Konvertierung und können daher die Leistung beeinträchtigen.
Diese Eigenschaft muss gesetzt werden, bevor die Compositor-Komponente fertiggestellt wird. Spätere Änderungen haben keine Auswirkung mehr.
Diese Eigenschaft wurde in Qt 6.0 eingeführt.
created : bool |
Diese Eigenschaft ist wahr, wenn WaylandCompositor initialisiert wurde, andernfalls ist sie falsch.
defaultOutput : WaylandOutput |
Diese Eigenschaft enthält die erste in der Liste der Ausgaben, die zu WaylandCompositor hinzugefügt wurden, oder null, wenn keine Ausgaben hinzugefügt wurden.
Wenn eine neue Standardausgabe gesetzt wird, wird sie der Ausgabeliste vorangestellt, wodurch sie zur neuen Standardausgabe wird, aber die vorherige Standardausgabe wird nicht aus der Liste entfernt.
defaultSeat : WaylandSeat |
Diese Eigenschaft enthält den Standardsitz für diesen WaylandCompositor.
extensions : list |
Eine Liste von Erweiterungen, die der Compositor seinen Clients ankündigt. Für jede Wayland-Erweiterung, die der Compositor unterstützen soll, instanziieren Sie seine Komponente und fügen sie der Liste der Erweiterungen hinzu.
Der folgende Code würde es den Clients zum Beispiel ermöglichen, wl_shell
Oberflächen im Compositor über die Schnittstelle wl_shell
anzufordern.
import QtWayland.Compositor WaylandCompositor { WlShell { // ... } }
retainedSelection : bool |
Diese Eigenschaft gibt an, ob die beibehaltene Auswahl aktiviert ist.
socketName : string |
Diese Eigenschaft enthält den Socket-Namen, der von WaylandCompositor für die Kommunikation mit den Clients verwendet wird. Sie muss festgelegt werden, bevor die Komponente fertiggestellt wird.
Wenn der SocketName leer ist (die Vorgabe), wird stattdessen der Inhalt des Startarguments --wayland-socket-name
verwendet. Wenn das Argument nicht gesetzt ist, versucht der Compositor, einen Socket-Namen zu finden, der standardmäßig wayland-0
lautet.
useHardwareIntegrationExtension : bool |
Diese Eigenschaft legt fest, ob die Hardware-Integrationserweiterung für diesen WaylandCompositor aktiviert werden soll.
Diese Eigenschaft muss gesetzt werden, bevor die Compositor-Komponente abgeschlossen wird.
Signal Dokumentation
void surfaceCreated(WaylandSurface surface) |
Dieses Signal wird ausgegeben, wenn eine neue WaylandSurface Instanz surface erstellt wurde.
Hinweis: Der entsprechende Handler ist onSurfaceCreated
.
void surfaceRequested(WaylandClient client, int id, int version) |
Dieses Signal wird ausgegeben, wenn ein client eine Oberfläche mit der ID id erstellt hat. Die Schnittstelle version ist ebenfalls verfügbar.
Der Slot, der sich mit diesem Signal verbindet, kann eine WaylandSurface Instanz im Bereich des Slots erstellen und initialisieren. Andernfalls wird eine Standardoberfläche erstellt.
Hinweis: Der entsprechende Handler ist onSurfaceRequested
.
Dokumentation der Methode
addSocketDescriptor(fd) |
Lauschen auf Client-Verbindungen zu einem Dateideskriptor, fd, der auf einen bereits gebundenen und lauschenden Server-Socket verweist.
Übernimmt nicht den Besitz des Dateideskriptors; er muss bei Bedarf explizit geschlossen werden.
Hinweis: Diese Methode ist nur mit libwayland 1.10.0 oder neuer verfügbar. Wenn sie gegen eine frühere libwayland-Laufzeitumgebung gebaut wurde, ist diese Methode ein Noop.
destroyClient(client) |
Zerstört die angegebene WaylandClient client .
destroyClientForSurface(surface) |
Zerstört den Client für die WaylandSurface surface .
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.