File indexing completed on 2025-03-16 11:21:24

 /*
     SPDX-FileCopyrightText: 2011 Martin Gräßlin <mgraesslin@kde.org>
     SPDX-FileCopyrightText: 2020 David Edmundson <davidedmundson@kde.org>
     SPDX-FileCopyrightText: 2021 Vlad Zahorodnii <vlad.zahorodnii@kde.org>
 
     SPDX-License-Identifier: GPL-2.0-or-later
 */
 
 #include "windowthumbnailitem.h"
 #include "composite.h"
 #include "core/renderbackend.h"
 #include "effects.h"
 #include "scene/itemrenderer.h"
 #include "scene/windowitem.h"
 #include "scene/workspacescene.h"
 #include "scripting_logging.h"
 #include "virtualdesktops.h"
 #include "window.h"
 #include "workspace.h"
 
 #include <kwingltexture.h>
 #include <kwinglutils.h>
 
 #include <QQuickWindow>
 #include <QRunnable>
 #include <QSGImageNode>
 #include <QSGTextureProvider>
 
 namespace KWin
 {
 class ThumbnailTextureProvider : public QSGTextureProvider
 {
 public:
     explicit ThumbnailTextureProvider(QQuickWindow *window);
 
     QSGTexture *texture() const override;
     void setTexture(const std::shared_ptr<GLTexture> &nativeTexture);
     void setTexture(QSGTexture *texture);
 
 private:
     QQuickWindow *m_window;
     std::shared_ptr<GLTexture> m_nativeTexture;
     std::unique_ptr<QSGTexture> m_texture;
 };
 
 ThumbnailTextureProvider::ThumbnailTextureProvider(QQuickWindow *window)
     : m_window(window)
 {
 }
 
 QSGTexture *ThumbnailTextureProvider::texture() const
 {
     return m_texture.get();
 }
 
 void ThumbnailTextureProvider::setTexture(const std::shared_ptr<GLTexture> &nativeTexture)
 {
     if (m_nativeTexture != nativeTexture) {
         const GLuint textureId = nativeTexture->texture();
         m_nativeTexture = nativeTexture;
 #if QT_VERSION < QT_VERSION_CHECK(6, 0, 0)
         m_texture.reset(m_window->createTextureFromNativeObject(QQuickWindow::NativeObjectTexture,
                                                                 &textureId, 0,
                                                                 nativeTexture->size(),
                                                                 QQuickWindow::TextureHasAlphaChannel));
 #else
         m_texture.reset(QNativeInterface::QSGOpenGLTexture::fromNative(textureId, m_window,
                                                                        nativeTexture->size(),
                                                                        QQuickWindow::TextureHasAlphaChannel));
 #endif
         m_texture->setFiltering(QSGTexture::Linear);
         m_texture->setHorizontalWrapMode(QSGTexture::ClampToEdge);
         m_texture->setVerticalWrapMode(QSGTexture::ClampToEdge);
     }
 
     // The textureChanged signal must be emitted also if only texture data changes.
     Q_EMIT textureChanged();
 }
 
 void ThumbnailTextureProvider::setTexture(QSGTexture *texture)
 {
     m_nativeTexture = nullptr;
     m_texture.reset(texture);
     Q_EMIT textureChanged();
 }
 
 class ThumbnailTextureProviderCleanupJob : public QRunnable
 {
 public:
     explicit ThumbnailTextureProviderCleanupJob(ThumbnailTextureProvider *provider)
         : m_provider(provider)
     {
     }
 
     void run() override
     {
         m_provider.reset();
     }
 
 private:
     std::unique_ptr<ThumbnailTextureProvider> m_provider;
 };
 
 WindowThumbnailItem::WindowThumbnailItem(QQuickItem *parent)
     : QQuickItem(parent)
 {
     setFlag(ItemHasContents);
     updateFrameRenderingConnection();
 
     connect(Compositor::self(), &Compositor::aboutToToggleCompositing,
             this, &WindowThumbnailItem::destroyOffscreenTexture);
     connect(Compositor::self(), &Compositor::compositingToggled,
             this, &WindowThumbnailItem::updateFrameRenderingConnection);
 }
 
 WindowThumbnailItem::~WindowThumbnailItem()
 {
     destroyOffscreenTexture();
 
     if (m_provider) {
         if (window()) {
             window()->scheduleRenderJob(new ThumbnailTextureProviderCleanupJob(m_provider),
                                         QQuickWindow::AfterSynchronizingStage);
         } else {
             qCCritical(KWIN_SCRIPTING) << "Can't destroy thumbnail texture provider because window is null";
         }
     }
 }
 
 void WindowThumbnailItem::releaseResources()
 {
     if (m_provider) {
         window()->scheduleRenderJob(new ThumbnailTextureProviderCleanupJob(m_provider),
                                     QQuickWindow::AfterSynchronizingStage);
         m_provider = nullptr;
     }
 }
 
 void WindowThumbnailItem::itemChange(QQuickItem::ItemChange change, const QQuickItem::ItemChangeData &value)
 {
     if (change == QQuickItem::ItemSceneChange) {
         updateFrameRenderingConnection();
     }
     QQuickItem::itemChange(change, value);
 }
 
 bool WindowThumbnailItem::isTextureProvider() const
 {
     return true;
 }
 
 QSGTextureProvider *WindowThumbnailItem::textureProvider() const
 {
     if (QQuickItem::isTextureProvider()) {
         return QQuickItem::textureProvider();
     }
     if (!m_provider) {
         m_provider = new ThumbnailTextureProvider(window());
     }
     return m_provider;
 }
 
 void WindowThumbnailItem::updateFrameRenderingConnection()
 {
     disconnect(m_frameRenderingConnection);
 
     if (!Compositor::compositing()) {
         return;
     }
     if (!window()) {
         return;
     }
 
     if (useGlThumbnails()) {
         m_frameRenderingConnection = connect(Compositor::self()->scene(), &WorkspaceScene::preFrameRender, this, &WindowThumbnailItem::updateOffscreenTexture);
     }
 }
 
 bool WindowThumbnailItem::useGlThumbnails()
 {
     static bool qtQuickIsSoftware = QStringList({QStringLiteral("software"), QStringLiteral("softwarecontext")}).contains(QQuickWindow::sceneGraphBackend());
     return Compositor::self()->backend()->compositingType() == OpenGLCompositing && !qtQuickIsSoftware;
 }
 
 QSize WindowThumbnailItem::sourceSize() const
 {
     return m_sourceSize;
 }
 
 void WindowThumbnailItem::setSourceSize(const QSize &sourceSize)
 {
     if (m_sourceSize != sourceSize) {
         m_sourceSize = sourceSize;
         invalidateOffscreenTexture();
         Q_EMIT sourceSizeChanged();
     }
 }
 
 void WindowThumbnailItem::destroyOffscreenTexture()
 {
     if (!Compositor::compositing()) {
         return;
     }
     if (!useGlThumbnails()) {
         return;
     }
 
     if (m_offscreenTexture) {
         WorkspaceScene *scene = Compositor::self()->scene();
         scene->makeOpenGLContextCurrent();
         m_offscreenTarget.reset();
         m_offscreenTexture.reset();
 
         if (m_acquireFence) {
             glDeleteSync(m_acquireFence);
             m_acquireFence = 0;
         }
         scene->doneOpenGLContextCurrent();
     }
 }
 
 QSGNode *WindowThumbnailItem::updatePaintNode(QSGNode *oldNode, QQuickItem::UpdatePaintNodeData *)
 {
     if (Compositor::compositing() && !m_offscreenTexture) {
         return oldNode;
     }
 
     // Wait for rendering commands to the offscreen texture complete if there are any.
     if (m_acquireFence) {
         glClientWaitSync(m_acquireFence, GL_SYNC_FLUSH_COMMANDS_BIT, 5000);
         glDeleteSync(m_acquireFence);
         m_acquireFence = 0;
     }
 
     if (!m_provider) {
         m_provider = new ThumbnailTextureProvider(window());
     }
 
     if (m_offscreenTexture) {
         m_provider->setTexture(m_offscreenTexture);
     } else {
         const QImage placeholderImage = fallbackImage();
         m_provider->setTexture(window()->createTextureFromImage(placeholderImage));
         m_devicePixelRatio = placeholderImage.devicePixelRatio();
     }
 
     QSGImageNode *node = static_cast<QSGImageNode *>(oldNode);
     if (!node) {
         node = window()->createImageNode();
         node->setFiltering(QSGTexture::Linear);
     }
     node->setTexture(m_provider->texture());
 
     if (m_offscreenTexture && m_offscreenTexture->isYInverted()) {
         node->setTextureCoordinatesTransform(QSGImageNode::MirrorVertically);
     } else {
         node->setTextureCoordinatesTransform(QSGImageNode::NoTransform);
     }
 
     node->setRect(paintedRect());
 
     return node;
 }
 
 qreal WindowThumbnailItem::saturation() const
 {
     return 1;
 }
 
 void WindowThumbnailItem::setSaturation(qreal saturation)
 {
     qCWarning(KWIN_SCRIPTING) << "ThumbnailItem.saturation is removed. Use a shader effect to change saturation";
 }
 
 qreal WindowThumbnailItem::brightness() const
 {
     return 1;
 }
 
 void WindowThumbnailItem::setBrightness(qreal brightness)
 {
     qCWarning(KWIN_SCRIPTING) << "ThumbnailItem.brightness is removed. Use a shader effect to change brightness";
 }
 
 QQuickItem *WindowThumbnailItem::clipTo() const
 {
     return nullptr;
 }
 
 void WindowThumbnailItem::setClipTo(QQuickItem *clip)
 {
     qCWarning(KWIN_SCRIPTING) << "ThumbnailItem.clipTo is removed and it has no replacements";
 }
 
 QUuid WindowThumbnailItem::wId() const
 {
     return m_wId;
 }
 
 void WindowThumbnailItem::setWId(const QUuid &wId)
 {
     if (m_wId == wId) {
         return;
     }
     m_wId = wId;
     if (!m_wId.isNull()) {
         setClient(workspace()->findToplevel(wId));
     } else if (m_client) {
         m_client = nullptr;
         updateImplicitSize();
         Q_EMIT clientChanged();
     }
     Q_EMIT wIdChanged();
 }
 
 Window *WindowThumbnailItem::client() const
 {
     return m_client;
 }
 
 void WindowThumbnailItem::setClient(Window *client)
 {
     if (m_client == client) {
         return;
     }
     if (m_client) {
         disconnect(m_client, &Window::frameGeometryChanged,
                    this, &WindowThumbnailItem::invalidateOffscreenTexture);
         disconnect(m_client, &Window::damaged,
                    this, &WindowThumbnailItem::invalidateOffscreenTexture);
         disconnect(m_client, &Window::frameGeometryChanged,
                    this, &WindowThumbnailItem::updateImplicitSize);
     }
     m_client = client;
     if (m_client) {
         connect(m_client, &Window::frameGeometryChanged,
                 this, &WindowThumbnailItem::invalidateOffscreenTexture);
         connect(m_client, &Window::damaged,
                 this, &WindowThumbnailItem::invalidateOffscreenTexture);
         connect(m_client, &Window::frameGeometryChanged,
                 this, &WindowThumbnailItem::updateImplicitSize);
         setWId(m_client->internalId());
     } else {
         setWId(QUuid());
     }
     invalidateOffscreenTexture();
     updateImplicitSize();
     Q_EMIT clientChanged();
 }
 
 void WindowThumbnailItem::updateImplicitSize()
 {
     QSize frameSize;
     if (m_client) {
         frameSize = m_client->frameGeometry().toAlignedRect().size();
     }
     setImplicitSize(frameSize.width(), frameSize.height());
 }
 
 QImage WindowThumbnailItem::fallbackImage() const
 {
     if (m_client) {
         return m_client->icon().pixmap(window(), boundingRect().size().toSize()).toImage();
     }
     return QImage();
 }
 
 static QRectF centeredSize(const QRectF &boundingRect, const QSizeF &size)
 {
     const QSizeF scaled = size.scaled(boundingRect.size(), Qt::KeepAspectRatio);
     const qreal x = boundingRect.x() + (boundingRect.width() - scaled.width()) / 2;
     const qreal y = boundingRect.y() + (boundingRect.height() - scaled.height()) / 2;
     return QRectF(QPointF(x, y), scaled);
 }
 
 QRectF WindowThumbnailItem::paintedRect() const
 {
     if (!m_client) {
         return QRectF();
     }
     if (!m_offscreenTexture) {
         const QSizeF iconSize = m_client->icon().actualSize(window(), boundingRect().size().toSize());
         return centeredSize(boundingRect(), iconSize);
     }
 
     const QRectF visibleGeometry = m_client->visibleGeometry();
     const QRectF frameGeometry = m_client->frameGeometry();
     const QSizeF scaled = QSizeF(frameGeometry.size()).scaled(boundingRect().size(), Qt::KeepAspectRatio);
 
     const qreal xScale = scaled.width() / frameGeometry.width();
     const qreal yScale = scaled.height() / frameGeometry.height();
 
     QRectF paintedRect(boundingRect().x() + (boundingRect().width() - scaled.width()) / 2,
                        boundingRect().y() + (boundingRect().height() - scaled.height()) / 2,
                        visibleGeometry.width() * xScale,
                        visibleGeometry.height() * yScale);
 
     paintedRect.moveLeft(paintedRect.x() + (visibleGeometry.x() - frameGeometry.x()) * xScale);
     paintedRect.moveTop(paintedRect.y() + (visibleGeometry.y() - frameGeometry.y()) * yScale);
 
     return paintedRect;
 }
 
 void WindowThumbnailItem::invalidateOffscreenTexture()
 {
     m_dirty = true;
     update();
 }
 
 void WindowThumbnailItem::updateOffscreenTexture()
 {
     if (m_acquireFence || !m_dirty || !m_client) {
         return;
     }
     Q_ASSERT(window());
 
     const QRectF geometry = m_client->visibleGeometry();
     QSize textureSize = geometry.toAlignedRect().size();
     if (sourceSize().width() > 0) {
         textureSize.setWidth(sourceSize().width());
     }
     if (sourceSize().height() > 0) {
         textureSize.setHeight(sourceSize().height());
     }
 
     m_devicePixelRatio = window()->devicePixelRatio();
     textureSize *= m_devicePixelRatio;
 
     if (!m_offscreenTexture || m_offscreenTexture->size() != textureSize) {
         m_offscreenTexture.reset(new GLTexture(GL_RGBA8, textureSize));
         m_offscreenTexture->setFilter(GL_LINEAR);
         m_offscreenTexture->setWrapMode(GL_CLAMP_TO_EDGE);
         m_offscreenTarget.reset(new GLFramebuffer(m_offscreenTexture.get()));
     }
 
     GLFramebuffer::pushFramebuffer(m_offscreenTarget.get());
     glClearColor(0.0, 0.0, 0.0, 0.0);
     glClear(GL_COLOR_BUFFER_BIT);
 
     auto scale = Compositor::self()->scene()->renderer()->renderTargetScale();
 
     QMatrix4x4 projectionMatrix;
     projectionMatrix.ortho(geometry.x() * scale, (geometry.x() + geometry.width()) * scale,
                            geometry.y() * scale, (geometry.y() + geometry.height()) * scale, -1, 1);
 
     WindowPaintData data;
     data.setProjectionMatrix(projectionMatrix);
 
     // The thumbnail must be rendered using kwin's opengl context as VAOs are not
     // shared across contexts. Unfortunately, this also introduces a latency of 1
     // frame, which is not ideal, but it is acceptable for things such as thumbnails.
     const int mask = Scene::PAINT_WINDOW_TRANSFORMED;
     Compositor::self()->scene()->renderer()->renderItem(m_client->windowItem(), mask, infiniteRegion(), data);
     GLFramebuffer::popFramebuffer();
 
     // The fence is needed to avoid the case where qtquick renderer starts using
     // the texture while all rendering commands to it haven't completed yet.
     m_dirty = false;
     m_acquireFence = glFenceSync(GL_SYNC_GPU_COMMANDS_COMPLETE, 0);
 
     // We know that the texture has changed, so schedule an item update.
     update();
 }
 
 } // namespace KWin