WaylandCompositor QML Type (Uncreatable)
Gestiona el servidor de pantalla Wayland. Más...
| Import Statement: | import QtWayland.Compositor |
| In C++: | QWaylandCompositor |
Nota: Se trata de un tipo no creable. No se puede instanciar en QML.
Propiedades
- additionalShmFormats : list<enum>
(since 6.0) - created : bool
- defaultOutput : WaylandOutput
- defaultSeat : WaylandSeat
- extensions : list
- retainedSelection : bool
- socketName : string
- useHardwareIntegrationExtension : bool
Señales
- void surfaceCreated(WaylandSurface surface)
- void surfaceRequested(WaylandClient client, int id, int version)
Métodos
- void addSocketDescriptor(fd)
- void destroyClient(client)
- void destroyClientForSurface(surface)
Descripción detallada
WaylandCompositor gestiona las conexiones con los clientes, así como las diferentes outputs y seats.
Normalmente, una aplicación compositora tendrá una única instancia de WaylandCompositor, que puede tener varias salidas como elementos hijos. Cuando un cliente solicita al compositor que cree una superficie, la solicitud es gestionada por el controlador onSurfaceRequested.
Las extensiones compatibles con el compositor deben instanciarse y añadirse a la propiedad «extensions» o, simplemente, como elementos hijos directos de WaylandCompositor.
Documentación de la propiedad
additionalShmFormats : list<enum> [since 6.0]
Esta propiedad contiene la lista de formatos wl_shm adicionales que el compositor indica que admite.
Por defecto, solo aparecen en la lista los formatos obligatorios ShmFormat_ARGB8888 y ShmFormat_XRGB8888, por lo que esta lista estará vacía. Los formatos adicionales pueden requerir una conversión interna y, por lo tanto, afectar al rendimiento.
Esta propiedad debe configurarse antes de que se complete el componente compositor. Los cambios posteriores no tendrán ningún efecto.
Esta propiedad se introdujo en Qt 6.0.
created : bool [read-only]
Esta propiedad es verdadera si se ha inicializado « WaylandCompositor »; en caso contrario, es falsa.
defaultOutput : WaylandOutput
Esta propiedad contiene la primera salida de la lista añadida a « WaylandCompositor », o el valor nulo si no se ha añadido ninguna salida.
Al establecer una nueva salida predeterminada, esta se añade al principio de la lista de salidas, convirtiéndose en la nueva predeterminada, pero la salida predeterminada anterior no se elimina de la lista.
defaultSeat : WaylandSeat [read-only]
Esta propiedad contiene el asiento predeterminado para este WaylandCompositor.
extensions : list
Una lista de extensiones que el compositor pone a disposición de sus clientes. Para cualquier extensión de Wayland que el compositor deba admitir, debe instanciar su componente y añadirlo a la lista de extensiones. Sin embargo, por lo general no es necesario hacer referencia a esta propiedad, ya que todos los elementos hijos directos se le asignan automáticamente.
Por ejemplo, el siguiente código permitiría a los clientes solicitar superficies « xdg_shell » en el compositor mediante la interfaz « xdg_shell ».
import QtWayland.Compositor
import QtWayland.Compositor.XdgShell
WaylandCompositor {
XdgShell {
// ...
}
}retainedSelection : bool [default: false]
Esta propiedad controla si el compositor conserva una copia de los datos seleccionados en el portapapeles. Cuando l true, el compositor lee de forma proactiva y almacena en caché todos los datos del portapapeles procedentes del cliente propietario. Esto supone un coste de rendimiento.
socketName : string
Esta propiedad contiene el nombre del socket que utiliza WaylandCompositor para comunicarse con los clientes. Debe configurarse antes de que el componente se complete.
Si «socketName» está vacío (valor por defecto), se utiliza en su lugar el contenido del argumento «start» de « --wayland-socket-name ». Si no se establece dicho argumento, el compositor intenta encontrar un nombre de socket, que por defecto es « wayland-0 ».
useHardwareIntegrationExtension : bool [default: true]
Esta propiedad determina si se debe habilitar la extensión de integración de hardware para este WaylandCompositor.
Esta propiedad debe configurarse antes de que se complete el componente compositor.
Documentación de Signal
void surfaceCreated(WaylandSurface surface)
Esta señal se emite cuando se ha creado una nueva instancia de ` WaylandSurface ` surface.
Nota: El controlador correspondiente es onSurfaceCreated.
void surfaceRequested(WaylandClient client, int id, int version)
Esta señal se emite cuando un objeto ` client ` ha creado una superficie con el identificador ` id`. También está disponible la interfaz ` version `.
La ranura conectada a esta señal puede crear e inicializar una instancia de WaylandSurface dentro del ámbito de la ranura. De lo contrario, se crea una superficie por defecto.
Nota: El controlador correspondiente es onSurfaceRequested.
Documentación del método
void addSocketDescriptor(fd)
Escucha las conexiones de los clientes en un descriptor de archivo, fd, que hace referencia a un socket de servidor ya vinculado y en modo de escucha.
No toma posesión del descriptor de archivo; debe cerrarse explícitamente si es necesario.
Nota: Este método solo está disponible con libwayland 1.10.0 o posterior. Si se compila con un tiempo de ejecución de libwayland anterior, este método no realiza ninguna acción.
void destroyClient(client)
Desde el lado del compositor, elimina el WaylandClient client indicado al desconectarse de él.
void destroyClientForSurface(surface)
Desde el compositor, elimina el cliente al que pertenece WaylandSurface surface desconectándose de él.
© 2026 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.