2020-08-02 22:22:19 +00:00
|
|
|
/*
|
|
|
|
KWin - the KDE window manager
|
|
|
|
This file is part of the KDE project.
|
2015-05-05 13:04:15 +00:00
|
|
|
|
2020-08-02 22:22:19 +00:00
|
|
|
SPDX-FileCopyrightText: 2015 Martin Gräßlin <mgraesslin@kde.org>
|
2015-05-05 13:04:15 +00:00
|
|
|
|
2020-08-02 22:22:19 +00:00
|
|
|
SPDX-License-Identifier: GPL-2.0-or-later
|
|
|
|
*/
|
2015-05-05 13:04:15 +00:00
|
|
|
#ifndef KWIN_SCENE_QPAINTER_FB_BACKEND_H
|
|
|
|
#define KWIN_SCENE_QPAINTER_FB_BACKEND_H
|
2021-01-05 19:23:37 +00:00
|
|
|
#include "qpainterbackend.h"
|
2015-05-05 13:04:15 +00:00
|
|
|
|
|
|
|
#include <QObject>
|
2017-08-11 19:40:49 +00:00
|
|
|
#include <QImage>
|
2015-05-05 13:04:15 +00:00
|
|
|
|
|
|
|
namespace KWin
|
|
|
|
{
|
|
|
|
class FramebufferBackend;
|
|
|
|
|
|
|
|
class FramebufferQPainterBackend : public QObject, public QPainterBackend
|
|
|
|
{
|
|
|
|
Q_OBJECT
|
|
|
|
public:
|
|
|
|
FramebufferQPainterBackend(FramebufferBackend *backend);
|
Run clang-tidy with modernize-use-override check
Summary:
Currently code base of kwin can be viewed as two pieces. One is very
ancient, and the other one is more modern, which uses new C++ features.
The main problem with the ancient code is that it was written before
C++11 era. So, no override or final keywords, lambdas, etc.
Quite recently, KDE compiler settings were changed to show a warning if
a virtual method has missing override keyword. As you might have already
guessed, this fired back at us because of that ancient code. We had
about 500 new compiler warnings.
A "solution" was proposed to that problem - disable -Wno-suggest-override
and the other similar warning for clang. It's hard to call a solution
because those warnings are disabled not only for the old code, but also
for new. This is not what we want!
The main argument for not actually fixing the problem was that git
history will be screwed as well because of human factor. While good git
history is a very important thing, we should not go crazy about it and
block every change that somehow alters git history. git blame allows to
specify starting revision for a reason.
The other argument (human factor) can be easily solved by using tools
such as clang-tidy. clang-tidy is a clang-based linter for C++. It can
be used for various things, e.g. fixing coding style(e.g. add missing
braces to if statements, readability-braces-around-statements check),
or in our case add missing override keywords.
Test Plan: Compiles.
Reviewers: #kwin, davidedmundson
Reviewed By: #kwin, davidedmundson
Subscribers: davidedmundson, apol, romangg, kwin
Tags: #kwin
Differential Revision: https://phabricator.kde.org/D22371
2019-07-22 16:52:26 +00:00
|
|
|
~FramebufferQPainterBackend() override;
|
2015-05-05 13:04:15 +00:00
|
|
|
|
2019-02-22 12:17:46 +00:00
|
|
|
QImage *bufferForScreen(int screenId) override;
|
2020-11-09 13:35:15 +00:00
|
|
|
bool needsFullRepaint(int screenId) const override;
|
2020-11-09 14:31:26 +00:00
|
|
|
void beginFrame(int screenId) override;
|
2021-07-23 14:33:27 +00:00
|
|
|
void endFrame(int screenId, const QRegion &damage) override;
|
2015-05-05 13:04:15 +00:00
|
|
|
|
|
|
|
private:
|
Introduce RenderLoop
At the moment, our frame scheduling infrastructure is still heavily
based on Xinerama-style rendering. Specifically, we assume that painting
is driven by a single timer, etc.
This change introduces a new type - RenderLoop. Its main purpose is to
drive compositing on a specific output, or in case of X11, on the
overlay window.
With RenderLoop, compositing is synchronized to vblank events. It
exposes the last and the next estimated presentation timestamp. The
expected presentation timestamp can be used by effects to ensure that
animations are synchronized with the upcoming vblank event.
On Wayland, every outputs has its own render loop. On X11, per screen
rendering is not possible, therefore the platform exposes the render
loop for the overlay window. Ideally, the Scene has to expose the
RenderLoop, but as the first step towards better compositing scheduling
it's good as is for the time being.
The RenderLoop tries to minimize the latency by delaying compositing as
close as possible to the next vblank event. One tricky thing about it is
that if compositing is too close to the next vblank event, animations
may become a little bit choppy. However, increasing the latency reduces
the choppiness.
Given that, there is no any "silver bullet" solution for the choppiness
issue, a new option has been added in the Compositing KCM to specify the
amount of latency. By default, it's "Medium," but if a user is not
satisfied with the upstream default, they can tweak it.
2020-11-19 08:52:29 +00:00
|
|
|
void reactivate();
|
|
|
|
void deactivate();
|
|
|
|
|
2019-02-22 12:17:46 +00:00
|
|
|
/**
|
|
|
|
* @brief mapped memory buffer on fb device
|
|
|
|
*/
|
2015-05-05 13:04:15 +00:00
|
|
|
QImage m_renderBuffer;
|
2019-02-22 12:17:46 +00:00
|
|
|
/**
|
|
|
|
* @brief buffer to draw into
|
|
|
|
*/
|
2015-05-05 13:04:15 +00:00
|
|
|
QImage m_backBuffer;
|
2019-02-22 12:17:46 +00:00
|
|
|
|
2015-05-05 13:04:15 +00:00
|
|
|
FramebufferBackend *m_backend;
|
2019-02-22 12:17:46 +00:00
|
|
|
bool m_needsFullRepaint;
|
2015-05-05 13:04:15 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
#endif
|