DBusScreenAdaptor.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: 2026 fuddlesworth
// SPDX-License-Identifier: LGPL-2.1-or-later
 
#pragma once
 
#include "phosphorscreens_export.h"
 
#include <QDBusAbstractAdaptor>
#include <QHash>
#include <QObject>
#include <QPointer>
#include <QRect>
#include <QStringList>
 
#include <functional>
 
class QScreen;
 
namespace Phosphor::Screens {
 
class IConfigStore;
class ScreenManager;
 
class PHOSPHORSCREENS_EXPORT DBusScreenAdaptor : public QDBusAbstractAdaptor
{
    Q_OBJECT
    Q_CLASSINFO("D-Bus Interface", "org.plasmazones.Screen")
 
public:
    explicit DBusScreenAdaptor(ScreenManager* manager, IConfigStore* store, QObject* parent = nullptr);
    ~DBusScreenAdaptor() override;
 
public Q_SLOTS:
    // Screen queries
    QStringList getScreens();
    QString getScreenInfo(const QString& screenId);
    QString getPrimaryScreen();
    QString getScreenId(const QString& connectorName);
    void setPrimaryScreenFromKWin(const QString& connectorName);
    void setAvailableGeometryFromKWin(const QString& screenName, int x, int y, int width, int height);
    QRect getAvailableGeometry(const QString& screenId);
    QRect getScreenGeometry(const QString& screenId);
 
    // Virtual screen management
    QString getVirtualScreenConfig(const QString& physicalScreenId);
    QString setVirtualScreenConfig(const QString& physicalScreenId, const QString& configJson);
    QStringList getPhysicalScreens();
    QString getEffectiveScreenAt(int x, int y);
 
    QString swapVirtualScreenInDirection(const QString& currentVirtualScreenId, const QString& direction);
 
    QString rotateVirtualScreens(const QString& physicalScreenId, bool clockwise);
 
Q_SIGNALS:
    void screenAdded(const QString& screenId);
    void screenRemoved(const QString& screenId);
    void screenGeometryChanged(const QString& screenId);
    void virtualScreensChanged(const QString& physicalScreenId);
 
protected:
    ScreenManager* screenManager() const;
    IConfigStore* configStore() const;
 
private:
    void handleScreenGeometryChanged(QScreen* screen, const QString& physId);
    void handleScreenRemoved(QScreen* removedScreen, QScreen* targetScreen, const QString& cachedId);
    void handleScreenIdentifierChanged(const QString& oldId, const QString& newId);
    bool emitForEffectiveScreens(const QString& physId, const std::function<void(const QString&)>& emitFn);
    void invalidateScreenInfoCache();
    void connectScreenManagerSignals(ScreenManager* mgr);
    void disconnectScreenManagerSignals(ScreenManager* mgr);
    void wireQGuiApplicationSignals();
 
    QString m_primaryScreenOverride;
    // QPointer-guarded so a ScreenManager / IConfigStore destroyed before
    // this adaptor (e.g. daemon tears down data members before QObject
    // children) safely reads as null rather than dangling. Prevents UAF in
    // the destructor's disconnect path.
    QPointer<ScreenManager> m_screenManager;
    QPointer<IConfigStore> m_configStore;
 
    QStringList m_lastEmittedEffectiveIds;
    QHash<QString, QStringList> m_cachedEffectiveIdsPerScreen;
    QHash<QString, QString> m_cachedScreenInfoJson;
 
    bool m_qGuiAppSignalsWired = false;
};
 
} // namespace Phosphor::Screens