File indexing completed on 2024-05-12 05:32:20

 /*
     SPDX-FileCopyrightText: 2014 Martin Gräßlin <mgraesslin@kde.org>
     SPDX-FileCopyrightText: 2018 David Edmundson <davidedmundson@kde.org>
 
     SPDX-License-Identifier: LGPL-2.1-only OR LGPL-3.0-only OR LicenseRef-KDE-Accepted-LGPL
 */
 #pragma once
 
 #include "kwin_export.h"
 
 #include <QList>
 #include <QObject>
 
 struct wl_client;
 struct wl_display;
 struct wl_resource;
 
 namespace KWin
 {
 
 class ClientConnection;
 class DisplayPrivate;
 class OutputInterface;
 class OutputDeviceV2Interface;
 class SeatInterface;
 class GraphicsBuffer;
 
 /**
  * @brief Class holding the Wayland server display loop.
  *
  * @todo Improve documentation
  */
 class KWIN_EXPORT Display : public QObject
 {
     Q_OBJECT
     Q_PROPERTY(bool running READ isRunning NOTIFY runningChanged)
 public:
     explicit Display(QObject *parent = nullptr);
     virtual ~Display();
 
     /**
      * Adds a socket with the given @p fileDescriptor to the Wayland display. This function
      * returns @c true if the socket has been added successfully; otherwise returns @c false.
      *
      * The compositor can call this function even after the display has been started.
      * @arg socketName can optionally be parsed to store the socket name represented by the given file-descriptor
      *
      * @see start()
      */
     bool addSocketFileDescriptor(int fileDescriptor, const QString &socketName = QString());
     /**
      * Adds a UNIX socket with the specified @p name to the Wayland display. This function
      * returns @c true if the socket has been added successfully; otherwise returns @c false.
      *
      * If the specified socket name @p name is empty, the display will pick a free socket with
      * a filename "wayland-%d".
      *
      * The compositor can call this function even after the display has been started.
      *
      * @see start()
      */
     bool addSocketName(const QString &name = QString());
 
     /**
      * Returns the list of socket names that the display listens for client connections.
      */
     QStringList socketNames() const;
 
     quint32 serial();
     quint32 nextSerial();
 
     /**
      * Start accepting client connections. If the display has started successfully, this
      * function returns @c true; otherwise @c false is returned.
      */
     bool start();
     void dispatchEvents();
 
     /**
      * Create a client for the given file descriptor.
      *
      * The client is created as if it connected through the normal server
      * socket. This method can be used to create a connection bypassing the
      * normal socket connection. It's recommended to use together with
      * socketpair and pass the other side of the socket to the client.
      *
      * @param fd The file descriptor for the socket to the client
      * @returns The new ClientConnection or @c null on failure.
      */
     ClientConnection *createClient(int fd);
 
     operator wl_display *();
     operator wl_display *() const;
     bool isRunning() const;
 
     void createShm();
     /**
      * @returns All SeatInterface currently managed on the Display.
      */
     QList<SeatInterface *> seats() const;
     QList<OutputDeviceV2Interface *> outputDevices() const;
     QList<OutputInterface *> outputs() const;
     QList<OutputInterface *> outputsIntersecting(const QRect &rect) const;
     OutputInterface *largestIntersectingOutput(const QRect &rect) const;
 
     /**
      * Gets the ClientConnection for the given @p client.
      * If there is no ClientConnection yet for the given @p client, it will be created.
      * @param client The native client for which the ClientConnection is retrieved
      * @return The ClientConnection for the given native client
      */
     ClientConnection *getConnection(wl_client *client);
     QList<ClientConnection *> connections() const;
 
     /**
      * Returns the graphics buffer for the given @a resource, or @c null if there's no buffer.
      */
     static GraphicsBuffer *bufferForResource(wl_resource *resource);
 
 private Q_SLOTS:
     void flush();
 
 Q_SIGNALS:
     void socketNamesChanged();
     void runningChanged(bool);
     void clientConnected(KWin::ClientConnection *);
     void clientDisconnected(KWin::ClientConnection *);
 
 private:
     friend class DisplayPrivate;
     std::unique_ptr<DisplayPrivate> d;
 };
 
 }