1/****************************************************************************
2**
3** Copyright (C) 2016 The Qt Company Ltd.
4** Contact: https://www.qt.io/licensing/
5**
6** This file is part of the QtQuick module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL$
9** Commercial License Usage
10** Licensees holding valid commercial Qt licenses may use this file in
11** accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and The Qt Company. For licensing terms
14** and conditions see https://www.qt.io/terms-conditions. For further
15** information use the contact form at https://www.qt.io/contact-us.
16**
17** GNU Lesser General Public License Usage
18** Alternatively, this file may be used under the terms of the GNU Lesser
19** General Public License version 3 as published by the Free Software
20** Foundation and appearing in the file LICENSE.LGPL3 included in the
21** packaging of this file. Please review the following information to
22** ensure the GNU Lesser General Public License version 3 requirements
23** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
24**
25** GNU General Public License Usage
26** Alternatively, this file may be used under the terms of the GNU
27** General Public License version 2.0 or (at your option) the GNU General
28** Public license version 3 or any later version approved by the KDE Free
29** Qt Foundation. The licenses are as published by the Free Software
30** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
31** included in the packaging of this file. Please review the following
32** information to ensure the GNU General Public License requirements will
33** be met: https://www.gnu.org/licenses/gpl-2.0.html and
34** https://www.gnu.org/licenses/gpl-3.0.html.
35**
36** $QT_END_LICENSE$
37**
38****************************************************************************/
39
40#ifndef QSGABSTRACTSOFTWARERENDERER_H
41#define QSGABSTRACTSOFTWARERENDERER_H
42
43//
44// W A R N I N G
45// -------------
46//
47// This file is not part of the Qt API. It exists purely as an
48// implementation detail. This header file may change from version to
49// version without notice, or even be removed.
50//
51// We mean it.
52//
53
54#include <private/qsgrenderer_p.h>
55
56#include <QtCore/QHash>
57
58QT_BEGIN_NAMESPACE
59
60class QSGSimpleRectNode;
61
62class QSGSoftwareRenderableNode;
63class QSGSoftwareRenderableNodeUpdater;
64
65class Q_QUICK_PRIVATE_EXPORT QSGAbstractSoftwareRenderer : public QSGRenderer
66{
67public:
68 QSGAbstractSoftwareRenderer(QSGRenderContext *context);
69 virtual ~QSGAbstractSoftwareRenderer();
70
71 QSGSoftwareRenderableNode *renderableNode(QSGNode *node) const;
72 void addNodeMapping(QSGNode *node, QSGSoftwareRenderableNode *renderableNode);
73 void appendRenderableNode(QSGSoftwareRenderableNode *node);
74
75 void nodeChanged(QSGNode *node, QSGNode::DirtyState state) override;
76
77 void markDirty();
78
79protected:
80 QRegion renderNodes(QPainter *painter);
81 void buildRenderList();
82 QRegion optimizeRenderList();
83
84 void setBackgroundColor(const QColor &color);
85 void setBackgroundRect(const QRect &rect, qreal devicePixelRatio);
86 QColor backgroundColor();
87 QRect backgroundRect();
88 // only known after calling optimizeRenderList()
89 bool isOpaque() const { return m_isOpaque; }
90
91private:
92 void nodeAdded(QSGNode *node);
93 void nodeRemoved(QSGNode *node);
94 void nodeGeometryUpdated(QSGNode *node);
95 void nodeMaterialUpdated(QSGNode *node);
96 void nodeMatrixUpdated(QSGNode *node);
97 void nodeOpacityUpdated(QSGNode *node);
98
99 QHash<QSGNode*, QSGSoftwareRenderableNode*> m_nodes;
100 QVector<QSGSoftwareRenderableNode*> m_renderableNodes;
101
102 QSGSimpleRectNode *m_background;
103
104 QRegion m_dirtyRegion;
105 QRegion m_obscuredRegion;
106 qreal m_devicePixelRatio = 1;
107 bool m_isOpaque = false;
108
109 QSGSoftwareRenderableNodeUpdater *m_nodeUpdater;
110};
111
112QT_END_NAMESPACE
113
114#endif // QSGABSTRACTSOFTWARERENDERER_H
115

source code of qtdeclarative/src/quick/scenegraph/adaptations/software/qsgabstractsoftwarerenderer_p.h