summaryrefslogtreecommitdiffstats
path: root/README
blob: 5424ab650a265ffcaed8eedbdd9ca2ec21bf431b (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
---------------------------------
Qt Enterprise Charts Add-on 1.3.0
---------------------------------

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

Directory structure:

src/
    Source code of the Qt Enterprise Charts
plugins/
    QML bindings plugins and QtCreator plugin
examples/
    Some examples of using Qt Enterprise 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 Enterprise 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 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 Enterprise 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