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
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
|
// Copyright (C) 2023 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GPL-3.0-only
#include <QtGraphs/qgraphs3dnamespace.h>
QT_BEGIN_NAMESPACE
/*!
\namespace QtGraphs3D
\inmodule QtGraphs
\ingroup graphs_3D
\brief The QtGraphs3D module provides enums used by QtGraphs' 3D API.
*/
/*!
\enum QtGraphs3D::SelectionFlag
Item selection modes. Values of this enumeration can be combined with OR
operator.
\value None
Selection mode disabled.
\value Item
Selection highlights a single item.
\value Row
Selection highlights a single row.
\value ItemAndRow
Combination flag for highlighting both item and row with different colors.
\value Column
Selection highlights a single column.
\value ItemAndColumn
Combination flag for highlighting both item and column with different colors.
\value RowAndColumn
Combination flag for highlighting both row and column.
\value ItemRowAndColumn
Combination flag for highlighting item, row, and column.
\value Slice
Setting this mode flag indicates that the graph should take care of the slice view handling
automatically. If you wish to control the slice view yourself via Q3DScene, do not set this
flag. When setting this mode flag, either \c Row or \c Column must also
be set, but not both. Slicing is supported by Q3DBarsWidgetItem and Q3DSurfaceWidgetItem only.
When this flag is set, slice mode is entered in the following situations:
\list
\li When selection is changed explicitly via series API to a visible item
\li When selection is changed by clicking on the graph
\li When the selection mode changes and the selected item is visible
\endlist
\value MultiSeries
Setting this mode means that items for all series at same position are highlighted, instead
of just the selected item. The actual selection in the other series doesn't change.
When setting this mode flag, one or more of the basic selection flags (\c {Item},
\c {Row}, or \c Column) must also be set.
Multi-series selection is not supported for Q3DScatterWidgetItem.
*/
/*!
\enum QtGraphs3D::SliceType
\since 6.10
Type of slice to grab to an image.
\value SliceNone
Slice type is not defined.
\value SliceRow
Slice for rows.
\value SliceColumn
Slice for columns.
*/
/*!
\enum QtGraphs3D::ShadowQuality
Quality of shadows.
\value None
Shadows are disabled.
\value Low
Shadows are rendered in low quality.
\value Medium
Shadows are rendered in medium quality.
\value High
Shadows are rendered in high quality.
\value SoftLow
Shadows are rendered in low quality with softened edges.
\value SoftMedium
Shadows are rendered in medium quality with softened edges.
\value SoftHigh
Shadows are rendered in high quality with softened edges.
*/
/*!
\enum QtGraphs3D::ElementType
Type of an element in the graph.
\value None
No defined element.
\value Series
An item in a series.
\value AxisXLabel
The x-axis label.
\value AxisYLabel
The y-axis label.
\value AxisZLabel
The z-axis label.
\value CustomItem
A custom item.
*/
/*!
\enum QtGraphs3D::OptimizationHint
The optimization hint for rendering.
\value Default
Provides the full feature set with instancing at a good performance.
\value Legacy
Provides the full feature set at a reasonable performance. To be used if
OptimizationHint.Default performs poorly or does not work.
*/
/*!
\enum QtGraphs3D::CameraPreset
Predefined positions for camera.
\value NoPreset
Used to indicate a preset has not been set, or the scene has been rotated freely.
\value FrontLow
Both x and y rotations of the camera are 0.
\value Front
X rotation is 0 and y rotation is 22.5 degrees.
\value FrontHigh
X rotation is 0 and y rotation is 45 degrees.
\value LeftLow
X rotation is 90 and y rotation is 0 degrees.
\value Left
X rotation is 90 and y rotation is 22.5 degrees.
\value LeftHigh
X rotation is 90 and y rotation is 45 degrees.
\value RightLow
X rotation is -90 and y rotation is 0 degrees.
\value Right
X rotation is -90 and y rotation is 22.5 degrees.
\value RightHigh
X rotation is -90 and y rotation is 45 degrees.
\value BehindLow
X rotation is 180 and y rotation is 0 degrees.
\value Behind
X rotation is 180 and y rotation is 22.5 degrees.
\value BehindHigh
X rotation is 180 and y rotation is 45 degrees.
\value IsometricLeft
X rotation is 45 and y rotation is 22.5 degrees.
\value IsometricLeftHigh
X rotation is 45 and y rotation is 45 degrees.
\value IsometricRight
X rotation is -45 and y rotation is 22.5 degrees.
\value IsometricRightHigh
X rotation is -45 and y rotation is 45 degrees.
\value DirectlyAbove
X rotation is 0 and y rotation is 90 degrees.
\value DirectlyAboveCW45
X rotation is -45 and y rotation is 90 degrees.
\value DirectlyAboveCCW45
X rotation is 45 and y rotation is 90 degrees.
\value FrontBelow
X rotation is 0 and y rotation is -45 degrees.
In Q3DBarsWidgetItem from FrontBelow onward these only work for graphs including negative
values. They act as CameraPreset...Low for positive-only values.
\value LeftBelow
X rotation is 90 and y rotation is -45 degrees.
\value RightBelow
X rotation is -90 and y rotation is -45 degrees.
\value BehindBelow
X rotation is 180 and y rotation is -45 degrees.
\value DirectlyBelow
X rotation is 0 and y rotation is -90 degrees.
Acts as FrontLow for positive-only bars.
*/
/*!
\enum QtGraphs3D::GridLineType
\value Shader
Grid lines are rendered with GPU in a shader.
\value Geometry
Grid lines are rendered with 3D models.
*/
/*!
\enum QtGraphs3D::RenderingMode
\value DirectToBackground
Indicates that the graph will be rendered directly on the window
background and QML items are rendered on top of it. Using non-transparent QML
item as a background will hide the graph. Clears the whole window before
rendering the graph, including the areas outside the graph. If the surface
format of the window supports antialiasing, it will be used (see
\l {QQuick3D::idealSurfaceFormat()}).
This rendering mode offers the best performance at the expense of
non-standard QML behavior. For example, the graphs do not obey the z ordering
of QML items and the opacity value has no effect on them.
\value Indirect
Indicates the graph will be first rendered to an offscreen surface
that is then drawn during normal QML item rendering. The rendered image is
antialiased using the multisampling method if it is supported in the current
environment and the msaaSamples property value is greater than zero.
This rendering mode offers good quality and normal QML item behavior at the
expense of performance.
*/
/*!
\enum QtGraphs3D::TransparencyTechnique
\since 6.9
\brief Specifies which transparency technique to use. The Default value is \c{Default}.
When rendering transparent surface graphs, use \c{Approximate} or \c{Accurate}.
\value Default
Indicates that order-independent transparency techniques are not used.
Offers the best performance. Use when graphs don't contain
transparency or when a bar or scatter graph is also using instancing,
that is \l optimizationHint is {QtGraphs3D::OptimizationHint::Default}.
\value Approximate
Indicates that a graph attempts an approximation of order-independent
transparency. This method is faster than \c Accurate and works on older
hardware but may yield inaccurate results. Use when the order-independent
transparency is needed, but the performance cost has to be lower than
when using accurate order-independent transparency.
\value Accurate
Indicates that accurate order-independent transparency is used.
Use when perfect transparency rendering is needed.
\note Accurate transparency is not yet implemented
and will be enabled when the required functionality
is added to QtQuick3D.
*/
QT_END_NAMESPACE
|
