WaylandCompositor QML Type (Uncreatable)

Gère le serveur d'affichage Wayland. En savoir plus...

Remarque : il s'agit d'un type non créable. Il ne peut pas être instancié en QML.

• Liste de tous les membres, y compris les membres hérités

Propriétés

• additionalShmFormats : list<enum> (since 6.0)
• created : bool
• defaultOutput : WaylandOutput
• defaultSeat : WaylandSeat
• extensions : list
• retainedSelection : bool
• socketName : string
• useHardwareIntegrationExtension : bool

Signaux

• void surfaceCreated(WaylandSurface surface)
• void surfaceRequested(WaylandClient client, int id, int version)

Méthodes

• void addSocketDescriptor(fd)
• void destroyClient(client)
• void destroyClientForSurface(surface)

Description détaillée

Le WaylandCompositor gère les connexions avec les clients, ainsi que les différentes surfaces de composition ( outputs ) et les surfaces de travail ( seats).

En règle générale, une application compositrice dispose d’une seule instance de WaylandCompositor, qui peut avoir plusieurs sorties en tant qu’enfants. Lorsqu’un client demande au compositeur de créer une surface, la requête est traitée par le gestionnaire onSurfaceRequested.

Les extensions prises en charge par le compositeur doivent être instanciées et ajoutées à la propriété extensions ou simplement en tant qu’enfants directs de WaylandCompositor.

Documentation des propriétés

additionalShmFormats : list<enum> [since 6.0]

Cette propriété contient la liste des formats wl_shm supplémentaires pris en charge par le compositeur.

Par défaut, seuls les formats requis ShmFormat_ARGB8888 et ShmFormat_XRGB8888 sont répertoriés et cette liste est vide. Les formats supplémentaires peuvent nécessiter une conversion en interne et peuvent donc affecter les performances.

Cette propriété doit être définie avant que le compositeur ne soit finalisé. Les modifications ultérieures n'auront aucun effet.

Cette propriété a été introduite dans Qt 6.0.

created : bool [read-only]

Cette propriété est vraie si ` WaylandCompositor ` a été initialisé ; sinon, elle est fausse.

defaultOutput : WaylandOutput

Cette propriété contient la première sortie de la liste ajoutée à l'WaylandCompositor, ou la valeur null si aucune sortie n'a été ajoutée.

La définition d'une nouvelle sortie par défaut la place en tête de la liste des sorties, ce qui en fait la nouvelle sortie par défaut, mais l'ancienne sortie par défaut n'est pas supprimée de la liste.

defaultSeat : WaylandSeat [read-only]

Cette propriété contient le siège par défaut pour cette WaylandCompositor.

extensions : list

Liste des extensions que le compositeur met à la disposition de ses clients. Pour toute extension Wayland que le compositeur doit prendre en charge, il doit instancier son composant et l’ajouter à la liste des extensions. Cependant, il n’est généralement pas nécessaire de faire référence à cette propriété, car tous les éléments enfants directs y sont automatiquement attribués.

Par exemple, le code suivant permettrait aux clients de demander des surfaces « xdg_shell » au compositeur à l’aide de l’interface xdg_shell.

import QtWayland.Compositor
import QtWayland.Compositor.XdgShell

WaylandCompositor {
    XdgShell {
        // ...
    }
}

retainedSelection : bool [default: false]

Cette propriété détermine si le compositeur conserve une copie des données sélectionnées dans le presse-papiers. Lorsque l true, le compositeur lit immédiatement et met en cache toutes les données du presse-papiers provenant du client propriétaire. Cela entraîne une perte de performances.

socketName : string

Cette propriété contient le nom du socket utilisé par WaylandCompositor pour communiquer avec les clients. Elle doit être définie avant que le composant ne soit finalisé.

Si `socketName` est vide (valeur par défaut), le contenu de l'argument `start` de ` --wayland-socket-name ` est utilisé à la place. Si cet argument n'est pas défini, le compositeur tente de trouver un nom de socket, qui est par défaut ` wayland-0 `.

useHardwareIntegrationExtension : bool [default: true]

Cette propriété détermine si l'extension d'intégration matérielle doit être activée pour cette WaylandCompositor.

Cette propriété doit être définie avant que le composant compositeur ne soit finalisé.

Documentation sur les signaux

void surfaceCreated(WaylandSurface surface)

Ce signal est émis lorsqu'une nouvelle instance de ` WaylandSurface ` surface a été créée.

void surfaceRequested(WaylandClient client, int id, int version)

Ce signal est émis lorsqu’un objet ` client ` a créé une surface portant l’identifiant ` id`. L’interface ` version ` est également disponible.

Le slot connecté à ce signal peut créer et initialiser une instance de WaylandSurface dans le périmètre d'action du slot. Dans le cas contraire, une surface par défaut est créée.

Documentation des méthodes

void addSocketDescriptor(fd)

Écoute les connexions des clients sur un descripteur de fichier, fd, en référence à un socket serveur déjà lié et en mode écoute.

Ne prend pas possession du descripteur de fichier ; celui-ci doit être fermé explicitement si nécessaire.

void destroyClient(client)

Du côté du compositeur, détruit l'WaylandClient on indiquée client en se déconnectant de celle-ci.

void destroyClientForSurface(surface)

Du côté du compositeur, détruit le client auquel appartient l'WaylandSurface surface en se déconnectant de celui-ci.