summaryrefslogtreecommitdiffstats
path: root/README
blob: db562b91663abbb492a377dc47cc8da6fc73817a (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
----------------------
Qt Charts Add-on 1.4.0
----------------------

What's in Qt Charts
===================

Directory structure:

src/
    Source code of the Qt Charts
plugins/
    QML bindings plugins and QtCreator plugin
examples/
    Some examples of using Qt Charts
demos/
    More versatile example applications showing how to customize charts,
    combine several chart types and implement interaction in charts
doc/
    Documentation
licenses/
    Licensing information

Building
========

Please note that if you have already installed a previous version of
Qt Charts, you should first uninstall it with
    make uninstall

Configure project with qmake and build project with make:
    (Linux) make 
    (Windows with MinGw) mingw32-make
    (Visual Studio) nmake
    (OSX) make

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:
    qmake CONFIG+="debug_and_release build_all"; make

If you want to leave out demos and examples from the build you can use
the following config with qmake:
    CONFIG+=nomake_demos_examples
For some embedded environments, such as VxWorks, all examples and demos
may not be applicable. There it's recommended to use the above mentioned
config option.

If you want to install the libraries to your Qt library directory use:
    make install

If you want to uninstall the libraries:
    make uninstall

Building as a statically linked library
=======================================

The same as above applies, you will just have to add staticlib to the CONFIG:
    qmake CONFIG+=staticlib

Documentation
=============

Documentation can be found from doc/html and doc/qch directories. The documentation
can also be generated with:
    make docs

The documentation provided with Charts is generated with qdoc and the creation of the
documentation is prioritized for Qt5. We recommend building the documentation using Qt5,
if you want to do it yourself. Creating the documentation using Qt4 also works, but some
pages are not generated correctly, such as the 'List of All Members' page for all C++ and
QML APIs in .qch documentation.

Main Changes between 1.3.1 and 1.4.0
====================================

- New: Added possibility to set brush image for AreaSeries, BarSet, BoxPlotSeries,
    BoxSet, PieSlice and ScatterSeries by specifying 'brushFilename'
- New: Added possibility to show series point values for line, spline and scatter series
- New: Added possibility to position the bar value labels

Bug Fixes and minor new features
================================

- New: Added count property for QBoxPlotSeries
- New: Added option to set markers in legend in reverse order
- New: Install the plugins.qmltypes file for Qt Quick 2 requested by Qt Creator
- New: Added clear function for BarCategoryAxis
- Fixed: Assert failure with percent bar series zero values
- Fixed: Updated files generated with Qt Creator for demos
- Fixed: DeclarativeChart::legend property marked as constant
- Fixed: Crash with ScatterChartItem mouse events
- Fixed: Build for iOS and for building the QtQuick2 plugin statically
- Fixed: Setting values for BarSet using Qt.point
- Fixed: Bar category rendering for empty category
- Fixed: QBoxSet color setting
- Fixed: Mouse event handling for pie
- Fixed: Legend truncation
- Fixed: Scatter series color
- Fixed: Crash in ChartDataSet::attachAxis()
- Fixed: Added missing library directory
- Fixed: Added Charts directory to include path
- Fixed: NOMINMAX definition

Known issues
============

- Zooming too far or too close may eventually freeze the zooming and scrolling.
- Qt Quick 1 is not supported on iOS.