Multi Screen
Multi Screen es un compositor Wayland de estilo escritorio para múltiples pantallas.
Introducción
Multi-screen es un ejemplo de compositor Wayland de estilo escritorio para múltiples pantallas.

Para obtener una introducción a los principios básicos de la creación de un Qt Wayland Compositor con Qt, consulta el ejemplo «Minimal Qml».
Compatibilidad con múltiples pantallas
Para cada pantalla disponible en el sistema, el ejemplo crea un ` CompositorScreen`, que es una subclase de ` WaylandOutput`. Si solo hay una pantalla física disponible, el ejemplo emula tres pantallas con datos ficticios.
Instantiator {
id: screens
model: emulated ? emulatedScreens : Qt.application.screens
delegate: CompositorScreen {
surfaceArea.color: "lightsteelblue"
text: name
compositor: comp
screen: emulated ? Qt.application.screens[0] : modelData
Component.onCompleted: if (!comp.defaultOutput) comp.defaultOutput = this
position: Qt.point(virtualX, virtualY)
windowed: emulated
}
}Cada « WaylandOutput » contiene una «Window», que se utiliza para albergar el contenido del cliente, tal y como es habitual en Qt Wayland Compositor. Dado que cada «Window» está aislada de las demás, no podemos compartir ningún elemento de « Qt Quick » entre ellas. Por lo tanto, cuando un cliente se conecta y se crea una « ShellSurface », se crea una « ShellSurfaceItem » en cada una de las pantallas.
for (var i = 0; i < screens.count; ++i)
createShellSurfaceItem(shellSurface, moveItem, screens.objectAt(i));Estos elementos sirven como vistas del mismo contenido del cliente. La superficie del cliente en sí solo se creará una vez y será compartida por los elementos de superficie.
Los elementos de superficie de nivel superior se crean como hijos del elemento de fondo Rectangle en cada una de las salidas. Estas vistas se almacenan para su uso posterior y, si el cliente genera alguna ventana hija, estas se vinculan al elemento de la ventana de nivel superior.
var parentSurfaceItem = output.viewsBySurface[shellSurface.parentSurface];
var parent = parentSurfaceItem || output.surfaceArea;El contenido del cliente solo será visible en una o dos pantallas a la vez. Las posiciones de las « ShellSurfaceItem » se sincronizan de modo que, cuando las ventanas entran en una pantalla, se retiran de otra al mismo tiempo. Esto da la impresión de que se trata de un único elemento que se desplaza sin interrupciones entre las pantallas. La posición global del cliente se almacena en un objeto compartido ` moveItem ` y, a partir de ahí, se calcula la posición relativa de la ` ShellSurfaceItem ` de cada pantalla. Si el ` moveItem ` se encuentra actualmente fuera de los límites de una pantalla, sus coordenadas lo reflejarán y no será visible en dicha pantalla.
x: surfaceItem.moveItem.x - surfaceItem.output.geometry.x
y: surfaceItem.moveItem.y - surfaceItem.output.geometry.yPor último, se llama a WaylandQuickItem::setPrimary() en los momentos oportunos para establecer la vista principal de la ShellSurface, que se utiliza cuando el cliente solicita maximizarse o pasar a pantalla completa. La ShellSurfaceItem principal se selecciona en función de la parte de la misma que esté visible en ese momento.
Nota: Para que sea compatible con múltiples salidas Wayland en el mismo compositor, el atributo Qt::AA_ShareOpenGLContexts debe establecerse antes de que se construya el objeto QGuiApplication. En el ejemplo, lo hacemos al principio de la función main().
QCoreApplication::setAttribute(Qt::AA_ShareOpenGLContexts, true);Véase también «Multi Output».
© 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.