Salidas múltiples
«Multi Output» es un ejemplo que muestra un compositor con varias salidas.
Introducción
El ejemplo «Multi Output» muestra cómo visualizar los mismos clientes en diferentes « WaylandOutputs » con distintos tipos de composición. Una salida muestra los clientes en una cuadrícula uniforme, a la misma escala. La otra salida es una ventana de compositor interactiva normal, al estilo de un escritorio.

Para una introducción a los principios básicos de la creación de un Qt Wayland Compositor con Qt, consulta el ejemplo «Minimal Qml».
Salidas múltiples
El ejemplo crea dos ventanas diferentes, una para cada salida. Para la vista en cuadrícula, nos conectamos a la señal « surfaceRequested ». Esta señal se emite cada vez que el cliente crea una superficie. Esto permite a la aplicación anular la respuesta predeterminada a la solicitud y crear un « WaylandSurface » personalizado.
onSurfaceRequested: (client, id, version) => {
var surface = surfaceComponent.createObject(comp, { } );
surface.initialize(comp, client, id, version);
}Al recibir la señal, el ejemplo crea un ` WaylandQuickItem ` como vista de la superficie. Este se puede añadir a la escena ` Qt Quick ` como cualquier otro elemento. En el ejemplo, lo añadimos a un ` GridView`.
Para la ventana de estilo escritorio, utilizamos las funciones de la extensión XdgShell. Una vez creada la superficie, el XdgShell emite una señal toplevelCreated.
XdgShell {
onToplevelCreated: (toplevel, xdgSurface) => {
var item = chromeComponent.createObject(defaultOutput.surfaceArea, { "shellSurface": xdgSurface } );
item.surface.activated.connect(item.raise);
}
}Creamos un ShellSurfaceItem para añadir el XdgToplevel a la segunda salida. Esto permite una interacción de estilo escritorio con la superficie.
Una vez completados estos pasos, el contenido del cliente es visible en ambas ventanas. Los búferes que contienen el contenido del cliente son los mismos para ambas salidas, pero se visualizan de dos formas diferentes y ofrecen al usuario distintas formas de interactuar con ellos.
Nota: Para admitir múltiples salidas Wayland en el mismo compositor, el atributo « Qt::AA_ShareOpenGLContexts » debe establecerse antes de crear el objeto « QGuiApplication ».
Véase también «Multipantalla » y «Compositor de vista general».
© 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.