blob: aa5bf1fe40d73477cc62b4abd636ed039d246887 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
|
// Copyright (C) 2014 Klaralvdalens Datakonsult AB (KDAB).
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
#include "qsortpolicy_p.h"
QT_BEGIN_NAMESPACE
namespace Qt3DRender {
using namespace Qt3DCore;
QSortPolicyPrivate::QSortPolicyPrivate()
: QFrameGraphNodePrivate()
{
}
/*!
\class Qt3DRender::QSortPolicy
\inmodule Qt3DRender
\brief Provides storage for the sort types to be used.
\since 5.7
\inherits Qt3DRender::QFrameGraphNode
A Qt3DRender::QSortPolicy class stores the sorting type used by the FrameGraph.
The sort types determine how drawable entities are sorted before drawing to
determine the drawing order. When QSortPolicy is present in the FrameGraph,
the sorting mechanism is determined by the sortTypes list. Multiple sort types
can be used simultaneously. If QSortPolicy is not present in the FrameGraph,
entities are drawn in the order they appear in the entity hierarchy.
*/
/*!
\qmltype SortPolicy
\inqmlmodule Qt3D.Render
\since 5.7
\instantiates Qt3DRender::QSortPolicy
\inherits FrameGraphNode
\brief Provides storage for the sort types to be used.
A SortPolicy class stores the sorting type used by the FrameGraph.
The sort types determine how drawable entities are sorted before drawing to
determine the drawing order. When SortPolicy is present in the FrameGraph,
the sorting mechanism is determined by the sortTypes list. Multiple sort
types can be used simultaneously. If SortPolicy is not present in the FrameGraph,
entities are drawn in the order they appear in the entity hierarchy.
*/
/*!
\enum Qt3DRender::QSortPolicy::SortType
This enum type describes the available sort types.
\value StateChangeCost sort the objects so as to minimize the cost of
changing from the currently rendered state
\value BackToFront sort the objects from back to front based on inverted z
order. More accurately, the sorting key is the z component of the
projection of the camera-to-object-center vector onto the camera's view
vector.
\value Material sort the objects based on their material (shader) value.
\value FrontToBack sort the objects from front to back. The opposite of
BackToFront.
\value [since 5.14] Texture sort the objects to minimize texture changes.
\value [since 5.15] Uniform sort the objects to minimize uniform changes.
*/
/*!
\property Qt3DRender::QSortPolicy::sortTypes
Specifies the sorting types to be used.
*/
/*!
\qmlproperty list<int> SortPolicy::sortTypes
Specifies the sorting types to be used.
This list can include the following values:
\list
\li StateChangeCost - sort the objects so as to minimize the cost of
changing from the currently rendered state
\li BackToFront - sort the objects from back to front based on inverted z
order. More accurately, the sorting key is the z component of the
projection of the camera-to-object-center vector onto the camera's view
vector.
\li Material - sort the objects based on their material (shader) value.
\li FrontToBack - sort the objects from front to back. The opposite of
BackToFront.
\li [since 5.14] Texture - sort the objects to minimize texture changes.
\li [since 5.15] Uniform - sort the objects to minimize uniform changes.
\endlist
*/
/*!
Constructs QSortPolicy with given \a parent.
*/
QSortPolicy::QSortPolicy(QNode *parent)
: QFrameGraphNode(*new QSortPolicyPrivate, parent)
{
}
/*! \internal */
QSortPolicy::~QSortPolicy()
{
}
/*! \internal */
QSortPolicy::QSortPolicy(QSortPolicyPrivate &dd, QNode *parent)
: QFrameGraphNode(dd, parent)
{
}
/*!
\return the current sort types in use
*/
QList<QSortPolicy::SortType> QSortPolicy::sortTypes() const
{
Q_D(const QSortPolicy);
return d->m_sortTypes;
}
QList<int> QSortPolicy::sortTypesInt() const
{
Q_D(const QSortPolicy);
QList<int> sortTypesInt;
transformVector(d->m_sortTypes, sortTypesInt);
return sortTypesInt;
}
void QSortPolicy::setSortTypes(const QList<SortType> &sortTypes)
{
Q_D(QSortPolicy);
if (sortTypes != d->m_sortTypes) {
d->m_sortTypes = sortTypes;
emit sortTypesChanged(sortTypes);
const bool wasBlocked = blockNotifications(true);
emit sortTypesChanged(sortTypesInt());
blockNotifications(wasBlocked);
}
}
void QSortPolicy::setSortTypes(const QList<int> &sortTypesInt)
{
QList<SortType> sortTypes;
transformVector(sortTypesInt, sortTypes);
setSortTypes(sortTypes);
}
} // namespace Qt3DRender
QT_END_NAMESPACE
#include "moc_qsortpolicy.cpp"
|
