WaylandCompositor QML Type

Gestiona el servidor de visualización Wayland. Más...

• Lista de todos los miembros, incluidos los heredados

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

El WaylandCompositor gestiona las conexiones con los clientes, así como los diferentes outputs y seats.

Normalmente, una aplicación de compositor tendrá una única instancia de WaylandCompositor, que puede tener varias salidas como hijos. Cuando un cliente solicita al compositor la creación de una superficie, la solicitud es gestionada por el manejador onSurfaceRequested.

Las extensiones soportadas por el compositor deben ser instanciadas y añadidas a la propiedad extensions.

Documentación de la propiedad

additionalShmFormats : list<enum> [since 6.0]

Esta propiedad contiene la lista de formatos wl_shm adicionales anunciados como soportados por el compositor.

Por defecto, sólo se listan los formatos ShmFormat_ARGB8888 y ShmFormat_XRGB8888 y esta lista estará vacía. Formatos adicionales pueden requerir conversión interna y por tanto afectar al rendimiento.

Esta propiedad debe establecerse antes de que se complete el componente del compositor. Los cambios posteriores no tendrán efecto.

Esta propiedad se introdujo en Qt 6.0.

created : bool [read-only]

Esta propiedad es verdadera si WaylandCompositor ha sido inicializada, en caso contrario es falsa.

defaultOutput : WaylandOutput

Esta propiedad contiene la primera de la lista de salidas añadidas a WaylandCompositor, o null si no se ha añadido ninguna salida.

Al establecer una nueva salida por defecto, se añade a la lista de salidas, convirtiéndola en la nueva salida por defecto, pero la salida por defecto anterior no se elimina de la lista.

defaultSeat : WaylandSeat [read-only]

Esta propiedad contiene el asiento por defecto para este WaylandCompositor.

extensions : list

Una lista de extensiones que el compositor anuncia a sus clientes. Para cualquier extensión Wayland que el compositor deba soportar, instancie su componente y añádalo a la lista de extensiones.

Por ejemplo, el siguiente código permitiría a los clientes solicitar superficies wl_shell en el compositor utilizando la interfaz wl_shell.

import QtWayland.Compositor

WaylandCompositor {
    WlShell {
        // ...
    }
}

retainedSelection : bool

Esta propiedad indica si está activada la selección conservada.

socketName : string

Esta propiedad contiene el nombre del socket utilizado por WaylandCompositor para comunicarse con los clientes. Debe establecerse antes de que se complete el componente.

Si socketName está vacío (por defecto), se utilizará el contenido del argumento de inicio --wayland-socket-name. Si el argumento no está establecido, el compositor intenta encontrar un nombre de socket, que es wayland-0 por defecto.

useHardwareIntegrationExtension : bool

Esta propiedad mantiene si la extensión de integración de hardware debe estar habilitada para este WaylandCompositor.

Esta propiedad debe establecerse antes de completar el componente compositor.

Documentación sobre señales

void surfaceCreated(WaylandSurface surface)

Esta señal se emite cuando se ha creado una nueva instancia WaylandSurface surface .

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

Esta señal se emite cuando un client ha creado una superficie con id id. La interfaz version también está disponible.

La ranura que se conecta a esta señal puede crear e inicializar una instancia de WaylandSurface en el ámbito de la ranura. En caso contrario, se creará una superficie por defecto.

Documentación del método

void addSocketDescriptor(fd)

Escucha conexiones de clientes en un descriptor de archivo, fd, que hace referencia a un socket de servidor ya enlazado y a la escucha.

No toma posesión del descriptor de fichero; debe cerrarse explícitamente si es necesario.

void destroyClient(client)

Destruye la dirección WaylandClient client .

void destroyClientForSurface(surface)

Destruye el cliente para el WaylandSurface surface .