CPP mínimo
Minimal CPP es un ejemplo que muestra cómo escribir un compositor de Wayland en C++.
«Minimal CPP» es un ejemplo minimalista de compositor que implementa un « Qt Wayland Compositor » completo utilizando C++. La API de C++ de QtWaylandCompositor es de bajo nivel y está pensada para aplicaciones especializadas, como el soporte de características de hardware, o en caso de que Qt Quick no esté disponible. La API de QML ofrece mayor comodidad y funcionalidad. A modo de comparación, el ejemplo «Minimal QML» implementa más funcionalidades con 30 líneas de QML que este ejemplo con más de 300 líneas.

Este ejemplo se divide en dos partes. La lógica de Wayland se encuentra en la clase Compositor, y la interfaz de usuario, en la clase Window.
Ventana
La clase ` Window ` es bastante sencilla. Para mostrar las superficies de Wayland, recorre las vistas del compositor y las representa en pantalla utilizando ` QOpenGLTextureBlitter`:
void Window::paintGL()
{
m_compositor->startRender();
QOpenGLFunctions *functions = context()->functions();
functions->glClearColor(.4f, .7f, .1f, 0.5f);
functions->glClear(GL_COLOR_BUFFER_BIT | GL_DEPTH_BUFFER_BIT);
GLenum currentTarget = GL_TEXTURE_2D;
m_textureBlitter.bind(currentTarget);
functions->glEnable(GL_BLEND);
functions->glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA);
const auto views = m_compositor->views();
for (View *view : views) {
auto texture = view->getTexture();
if (!texture)
continue;
if (texture->target() != currentTarget) {
currentTarget = texture->target();
m_textureBlitter.bind(currentTarget);
}
GLuint textureId = texture->textureId();
QWaylandSurface *surface = view->surface();
if (surface && surface->hasContent()) {
QSize s = surface->destinationSize();
view->initPosition(size(), s);
QPointF pos = view->globalPosition();
QRectF surfaceGeometry(pos, s);
QOpenGLTextureBlitter::Origin surfaceOrigin =
view->currentBuffer().origin() == QWaylandSurface::OriginTopLeft
? QOpenGLTextureBlitter::OriginTopLeft
: QOpenGLTextureBlitter::OriginBottomLeft;
QMatrix4x4 targetTransform = QOpenGLTextureBlitter::targetTransform(surfaceGeometry, QRect(QPoint(), size()));
m_textureBlitter.blit(textureId, targetTransform, surfaceOrigin);
}
}
m_textureBlitter.release();
m_compositor->endRender();
}Todos los eventos de teclado y ratón se envían al compositor. Por ejemplo:
void Window::mousePressEvent(QMouseEvent *event)
{
m_compositor->handleMousePress(event->position().toPoint(), event->button());
}Compositor
La clase ` Compositor ` es más compleja, ya que tiene que implementar gran parte de la lógica que, en un compositor basado en QML, gestionarían ` WaylandCompositor ` y ` WaylandQuickItem `.
La función ` create ` configura el compositor utilizando ` IviApplication`, que es la extensión de shell más básica. La función se invoca una vez que se ha inicializado el contexto de OpenGL:
void Compositor::create()
{
QWaylandOutput *output = new QWaylandOutput(this, m_window);
QWaylandOutputMode mode(m_window->size(), 60000);
output->addMode(mode, true);
QWaylandCompositor::create();
output->setCurrentMode(mode);
m_iviApplication = new QWaylandIviApplication(this);
connect(m_iviApplication, &QWaylandIviApplication::iviSurfaceCreated, this, &Compositor::onIviSurfaceCreated);
}Toda la lógica para los eventos del ratón y el foco del teclado debe implementarse manualmente, incluidas las capturas implícitas del ratón (enviar todos los movimientos del ratón a la superficie que recibió la pulsación inicial del ratón). Ten en cuenta que los eventos de pulsación del ratón en el protocolo Wayland no contienen la posición del ratón, por lo que siempre tenemos que enviar un movimiento del ratón cuando recibimos una pulsación del ratón:
void Compositor::handleMousePress(const QPoint &position, Qt::MouseButton button)
{
if (!m_mouseView) {
if ((m_mouseView = viewAt(position)))
raise(m_mouseView);
}
auto *seat = defaultSeat();
seat->sendMouseMoveEvent(m_mouseView, mapToView(m_mouseView, position));
seat->sendMousePressEvent(button);
}Al soltar el ratón, finalizamos la captura implícita y notificamos a la superficie la posición actual del ratón:
void Compositor::handleMousePress(const QPoint &position, Qt::MouseButton button)
{
if (!m_mouseView) {
if ((m_mouseView = viewAt(position)))
raise(m_mouseView);
}
auto *seat = defaultSeat();
seat->sendMouseMoveEvent(m_mouseView, mapToView(m_mouseView, position));
seat->sendMousePressEvent(button);
}Cuando se nos notifica una nueva superficie, creamos un ` View ` para realizar un seguimiento de la misma y conectamos señales para poder gestionar las actualizaciones.
void Compositor::onIviSurfaceCreated(QWaylandIviSurface *iviSurface)
{
View *view = new View(iviSurface->iviId());
view->setSurface(iviSurface->surface());
view->setOutput(outputFor(m_window));
m_views << view;
connect(view, &QWaylandView::surfaceDestroyed, this, &Compositor::viewSurfaceDestroyed);
connect(iviSurface->surface(), &QWaylandSurface::redraw, this, &Compositor::triggerRender);
}La clase ` View ` es una subclase de ` QWaylandView`, que representa una vista específica de una superficie. La función ` advance ` actualiza el búfer actual de la vista y devuelve `true` si hay contenido nuevo. La función ` getTexture ` hace que el contenido del búfer esté disponible como una textura OpenGL para que la clase ` Window ` pueda utilizarlo:
QOpenGLTexture *View::getTexture() {
if (advance())
m_texture = currentBuffer().toOpenGLTexture();
return m_texture;
}© 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.