summaryrefslogtreecommitdiffstats
path: root/README
blob: 770c8c154a1588b1e947ca2c9bfb96949c23cb33 (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
----------------------
Qt Charts Add-on 1.3.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

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

Main Changes between 1.2.1 and 1.3.0
====================================

- New chart type added: Polar chart
- New series type added: Box and whiskers
- QtQuick 2 support added
  - Note: Since Qt Charts still uses QGraphicsView framework under the hood
    even with QtQuick 2, its performance is actually better with QtQuick 1 than with QtQuick 2.

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

- New: Added missing QML support for LogValueAxis
- New: Implement index based removing/replacing points in a series
- New: Added API to specify plot area background for the chart
- New: Added HTML support for various text items such as axis labels or titles
       - HTML tags (e.g. <br/>) and character codes (e.g. &deg;) are now supported
       - Setting pen for text items is deprecated and does nothing
       - When setting brush for text items, only the color of the brush is relevant.
         It specifies the default text color for the item.
       - Logic for identifying axis label format specifiers was improved, so adding
         additional information to labels via label format string is now more viable.
- New: Added QChart::zoomReset() and QChart::isZoomed()
- New: Added API for setting roundness of the corners for the background of the chart
- Fixed: If vertical QLogValueAxis base is selected so that it has only single visible tick,
         its label always displays as "..."
- Fixed: Crash when removing pie series from chart
- Fixed: Most themes disable axis shades
- Fixed: Lingering shades from high contrast theme
- Fixed: Crash when adding/removing points during animation
- Fixed: Wrong expand direction with rotated chart view
- Fixed: Android build errors
- Fixed: Explicitly set default pen/brush/font got overridden by theme
         - Default pens, brushes, and fonts were changed to ones that won't clash with commonly
           used types of the same. Most notably black pen is no longer default and won't anymore
           get overridden by theme if used.
- Fixed: Multi-line axis titles and labels now position correctly
         - Note that '\n' no longer causes new line in text items, use HTML tag <br/> instead
- Fixed: Legend markers text truncation with small font sizes
- Fixed: QChartView right click zoom out when zooming only along one axis
- Fixed: Crash or memory leak when resetting animation options mid-animation
- Fixed: QBarCategoryAxis doesn't notify domain on category remove
- Fixed: axisXTop QML property now actually puts axis on top