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
|
-----------------------------------
Qt Data Visualization 1.0.0 (alpha)
-----------------------------------
Qt Data Visualization module provides multiple graph types to visualize data in 3D space
both with C++ and Qt Quick 2.
System Requirements
===================
- Qt 5.2 or newer
- OpenGL 2.1 or newer (recommended) or OpenGL ES2 (reduced feature set)
Platform specific recommendations:
- Mac: OSX 10.8 recommended
Building
========
Configure the project with qmake:
qmake
After running qmake, build the project with make:
(Linux) make
(Windows with MinGw) mingw32-make
(Windows with Visual Studio) nmake
(OSX) make
The above generates the default makefiles for your configuration, which is typically
the release build if you are using precompiled binary Qt distribution. To build both
debug and release, or one specifically, use one of the following qmake lines instead.
For debug builds:
qmake CONFIG+=debug
make
or
qmake CONFIG+=debug_and_release
make debug
For release builds:
qmake CONFIG+=release
make
or
qmake CONFIG+=debug_and_release
make release
For both builds (Windows/Mac only):
qmake CONFIG+="debug_and_release build_all"
make
After building, install the module to your Qt directory:
make install
If you want to uninstall the module:
make uninstall
Building as a statically linked library
=======================================
The same as above applies, you will just have to add static to the CONFIG:
qmake CONFIG+=static
Documentation
=============
Pregenerated documentation can be found from doc folder for both Qt Assistant
(qtdatavisualization.qch) and in HTML format (qtdatavisualization subfolder).
The documentation can also be generated with:
make docs
Please refer to the generated documentation for more information:
doc/qtdatavisualization/qtdatavisualization-index.html
Known Issues
============
- All other QML elements are drawn on top of the Qt DataVisualization graphs,
including the parent elements of the graphs. To ensure the graphs are not
hidden, make sure you don't draw anything opaque on top of the graphs.
For example, Qt Creator application wizard for Qt Quick 2 applications
creates by default an opaque white Rectangle element as the main element,
which covers any graph added to it.
- Using multiple graphs in one application crashes on application shutdown
unless the last graph to have active context is deleted last.
- Android doesn't support both widgets and OpenGL simultaneously, so only
the Qt Quick 2 API is usable in practice in Android.
- Shadows are not supported with OpenGL ES2 (including Angle builds in Windows).
- Anti-aliasing doesn't work with OpenGL ES2 (including Angle builds in Windows).
- Surfaces with non-straight rows and columns do not always render properly.
- Wrong item can end up selected if you do mouse selection and data removes/inserts
simultaneously due to the asynchronous nature of mouse selection handling.
- Q3DLight class (and Light3D QML item) are currently not usable for anything.
- Q3DScene::secondarySubviewOnTop property has currently no effect.
- The color style Q3DTheme::ColorStyleObjectGradient doesn't work for surface graphs.
- Scatter "point" meshes do not support gradients, they always use the base color.
|
