QtCharts module
Go to file
Sergio Ahumada c07b1a694b Update the git-archive export options
The .gitattributes, .gitignore, .commit-template files do not need to be
present in packaged sources, as they are for people using the Git
repository.  People who download tarballs usually don't reimport into
Git -- they should just download the actual repositories.

Meanwhile, the .tag file is quite useful. Instead of making Git extract
to the useless SHA-1 of the "$Id$\n" string, ask git-archive to store
the SHA-1 of the commit being packaged.

Also removing 'tests' and 'tools' directories from the source package.

Change-Id: I6823bad4ee4a5a666532e972a66da075856d5fee
Reviewed-by: Miikka Heikkinen <miikka.heikkinen@digia.com>
2013-10-03 14:13:28 +03:00
demos Remove qmlcustommodel demo from demos.pro 2013-10-02 10:29:53 +03:00
doc Remove qmlcustommodel demo 2013-10-02 09:29:41 +03:00
examples Fix Chart build on Solaris 2013-09-19 09:53:38 +03:00
features minor. typo in previous commit 2012-08-01 14:27:31 +03:00
licenses Qt Commercial -> Qt Enterprise 2013-06-13 08:03:50 +03:00
plugins Doc: language review of Qt Charts doc 2013-09-16 09:26:32 +03:00
src Fix Chart build when QT_NO_TEXTSTREAM is defined 2013-10-03 13:30:46 +03:00
tests Add hovered signal with index for bar charts 2013-08-19 10:58:59 +03:00
tools Fix memory leak on demolauncher 2013-06-19 12:15:18 +03:00
.gitattributes Update the git-archive export options 2013-10-03 14:13:28 +03:00
.gitignore Fixed bug with plugin folder in .gitignore 2012-08-28 14:01:20 +03:00
.tag Update the git-archive export options 2013-10-03 14:13:28 +03:00
README Add possibility to build Charts without demos and examples 2013-09-05 07:46:50 +03:00
charts.pro Add possibility to build Charts without demos and examples 2013-09-05 07:46:50 +03:00
config.pri Generate charts plugin for QtQuick2 as well as QtQuick1 2013-04-23 09:24:32 +03:00

README

----------------------
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