1/****************************************************************************
2**
3** Copyright (C) 2014 Klaralvdalens Datakonsult AB (KDAB).
4** Copyright (C) 2016 Paul Lemire
5** Contact: https://www.qt.io/licensing/
6**
7** This file is part of the Qt3D module of the Qt Toolkit.
8**
9** $QT_BEGIN_LICENSE:LGPL$
10** Commercial License Usage
11** Licensees holding valid commercial Qt licenses may use this file in
12** accordance with the commercial license agreement provided with the
13** Software or, alternatively, in accordance with the terms contained in
14** a written agreement between you and The Qt Company. For licensing terms
15** and conditions see https://www.qt.io/terms-conditions. For further
16** information use the contact form at https://www.qt.io/contact-us.
17**
18** GNU Lesser General Public License Usage
19** Alternatively, this file may be used under the terms of the GNU Lesser
20** General Public License version 3 as published by the Free Software
21** Foundation and appearing in the file LICENSE.LGPL3 included in the
22** packaging of this file. Please review the following information to
23** ensure the GNU Lesser General Public License version 3 requirements
24** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
25**
26** GNU General Public License Usage
27** Alternatively, this file may be used under the terms of the GNU
28** General Public License version 2.0 or (at your option) the GNU General
29** Public license version 3 or any later version approved by the KDE Free
30** Qt Foundation. The licenses are as published by the Free Software
31** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
32** included in the packaging of this file. Please review the following
33** information to ensure the GNU General Public License requirements will
34** be met: https://www.gnu.org/licenses/gpl-2.0.html and
35** https://www.gnu.org/licenses/gpl-3.0.html.
36**
37** $QT_END_LICENSE$
38**
39****************************************************************************/
40
41#include "framegraphvisitor_p.h"
42
43#include "framegraphnode_p.h"
44#include "subtreeenabler_p.h"
45#include <Qt3DRender/private/abstractrenderer_p.h>
46#include <Qt3DRender/private/managers_p.h>
47#include <QThreadPool>
48
49QT_BEGIN_NAMESPACE
50
51using namespace Qt3DCore;
52
53namespace Qt3DRender {
54namespace Render {
55
56FrameGraphVisitor::FrameGraphVisitor(const FrameGraphManager *manager)
57 : m_manager(manager)
58{
59 m_leaves.reserve(asize: 8);
60}
61
62QVector<FrameGraphNode *> FrameGraphVisitor::traverse(FrameGraphNode *root)
63{
64 m_leaves.clear();
65 m_enablersToDisable.clear();
66
67 Q_ASSERT_X(root, Q_FUNC_INFO, "The FrameGraphRoot is null");
68
69 // Kick off the traversal
70 Render::FrameGraphNode *node = root;
71 if (node == nullptr)
72 qCritical() << Q_FUNC_INFO << "FrameGraph is null";
73 visit(node);
74 return m_leaves;
75}
76
77// intended to be called after traverse
78// (returns data that is captured during the traverse)
79QVector<FrameGraphNode *> &&FrameGraphVisitor::takeEnablersToDisable()
80{
81 return std::move(m_enablersToDisable);
82}
83
84void FrameGraphVisitor::visit(Render::FrameGraphNode *node)
85{
86 if (node->nodeType() == Render::FrameGraphNode::SubtreeEnabler) {
87 if (!node->isEnabled())
88 return;
89 if (static_cast<SubtreeEnabler*>(node)->enablement() == QSubtreeEnabler::SingleShot) {
90 node->setEnabled(false);
91 m_enablersToDisable.push_back(t: node);
92 }
93 }
94
95 // Recurse to children (if we have any), otherwise if this is a leaf node,
96 // initiate a rendering from the current camera
97 const QVector<Qt3DCore::QNodeId> fgChildIds = node->childrenIds();
98
99 for (const Qt3DCore::QNodeId fgChildId : fgChildIds)
100 visit(node: m_manager->lookupNode(id: fgChildId));
101
102 // Leaf node - create a RenderView ready to be populated
103 // TODO: Pass in only framegraph config that has changed from previous
104 // index RenderViewJob.
105 if (fgChildIds.empty())
106 m_leaves.push_back(t: node);
107}
108
109} // namespace Render
110} // namespace Qt3DRender
111
112QT_END_NAMESPACE
113

source code of qt3d/src/render/framegraph/framegraphvisitor.cpp