File indexing completed on 2025-04-20 04:59:08

 /*
     SPDX-FileCopyrightText: 2020 Vlad Zahorodnii <vlad.zahorodnii@kde.org>
 
     SPDX-License-Identifier: GPL-2.0-or-later
 */
 
 #pragma once
 
 #include "effect/globals.h"
 
 #include <QObject>
 
 namespace KWin
 {
 
 class RenderLoopPrivate;
 class SurfaceItem;
 class Item;
 class Output;
 
 /**
  * The RenderLoop class represents the compositing scheduler on a particular output.
  *
  * The RenderLoop class drives the compositing. The frameRequested() signal is emitted
  * when the loop wants a new frame to be rendered. The frameCompleted() signal is
  * emitted when a previously rendered frame has been presented on the screen. In case
  * you want the compositor to repaint the scene, call the scheduleRepaint() function.
  */
 class KWIN_EXPORT RenderLoop : public QObject
 {
     Q_OBJECT
 
 public:
     explicit RenderLoop(Output *output);
     ~RenderLoop() override;
 
     /**
      * Pauses the render loop. While the render loop is inhibited, scheduleRepaint()
      * requests are queued.
      *
      * Once the render loop is uninhibited, the pending schedule requests are going to
      * be re-applied.
      */
     void inhibit();
 
     /**
      * Uninhibits the render loop.
      */
     void uninhibit();
 
     /**
      * This function must be called before the Compositor sumbits the next
      * frame.
      */
     void prepareNewFrame();
 
     /**
      * This function must be called before the Compositor starts rendering the next
      * frame.
      */
     void beginPaint();
 
     /**
      * Returns the refresh rate at which the output is being updated, in millihertz.
      */
     int refreshRate() const;
 
     /**
      * Sets the refresh rate of this RenderLoop to @a refreshRate, in millihertz.
      */
     void setRefreshRate(int refreshRate);
 
     void setPresentationSafetyMargin(std::chrono::nanoseconds safetyMargin);
 
     /**
      * Schedules a compositing cycle at the next available moment.
      */
     void scheduleRepaint(Item *item = nullptr);
 
     /**
      * Returns the timestamp of the last frame that has been presented on the screen.
      * The returned timestamp is sourced from the monotonic clock.
      */
     std::chrono::nanoseconds lastPresentationTimestamp() const;
 
     /**
      * If a repaint has been scheduled, this function returns the expected time when
      * the next frame will be presented on the screen. The returned timestamp is sourced
      * from the monotonic clock.
      */
     std::chrono::nanoseconds nextPresentationTimestamp() const;
 
     void setPresentationMode(PresentationMode mode);
 
 Q_SIGNALS:
     /**
      * This signal is emitted when the refresh rate of this RenderLoop has changed.
      */
     void refreshRateChanged();
     /**
      * This signal is emitted when a frame has been actually presented on the screen.
      * @a timestamp indicates the time when it took place.
      */
     void framePresented(RenderLoop *loop, std::chrono::nanoseconds timestamp, PresentationMode mode);
 
     /**
      * This signal is emitted when the render loop wants a new frame to be composited.
      *
      * The Compositor should make a connection to this signal using Qt::DirectConnection.
      */
     void frameRequested(RenderLoop *loop);
 
 private:
     std::unique_ptr<RenderLoopPrivate> d;
     friend class RenderLoopPrivate;
 };
 
 } // namespace KWin