README
99 lines
| 3.6 KiB
| text/plain
|
TextLexer
samakkon
|
r916 | -------------------------------- | ||
Marek Rosa
|
r1363 | Commercial Charts Add-on Beta | ||
|
samakkon
|
r916 | -------------------------------- | ||
| Whats in Qt Commercial Charts | ||||
| ============================= | ||||
| Directory structure: | ||||
| src/ | ||||
| Source code of the Qt Commercial Charts | ||||
Tero Ahola
|
r1402 | plugins/ | ||
| QML bindings plugin and QtCreator plugin | ||||
|
samakkon
|
r916 | examples/ | ||
| Some examples of using Qt Commercial Charts | ||||
| demos/ | ||||
|
Tero Ahola
|
r1402 | More versatile example applications showing how to customize charts, | ||
|
samakkon
|
r917 | combine several chart types and implement interaction in charts | ||
|
samakkon
|
r916 | doc/ | ||
| Documentation | ||||
Michal Klocek
|
r1049 | licenses/ | ||
|
samakkon
|
r917 | Licensing infromation | ||
|
Michal Klocek
|
r1049 | Building | ||
|
samakkon
|
r916 | ======== | ||
Jani Honkonen
|
r1440 | Configure project with qmake. On Windows by default both debug and release | ||
| versions are built. On other platforms you need to specify the version | ||||
| (default is debug): | ||||
| (Windows) qmake | ||||
| (Other platforms) qmake CONFIG+=release | ||||
|
Michal Klocek
|
r1049 | |||
| Build poject with make: | ||||
| (Linux) make | ||||
| (Windows with MinGw) mingw32-make | ||||
|
Tero Ahola
|
r1403 | (Visual Studio) nmake | ||
|
Jani Honkonen
|
r1440 | (OSX) make | ||
|
samakkon
|
r916 | |||
| If you want to install the libraries to your Qt library directory use: | ||||
|
Michal Klocek
|
r1049 | make install | ||
|
samakkon
|
r916 | |||
|
Michal Klocek
|
r1049 | If you want to uninstall the libraries | ||
| make uninstall | ||||
|
samakkon
|
r916 | |||
|
Jani Honkonen
|
r1440 | Building as a statically linked library | ||
| ======================================= | ||||
| The same as above applies you will just have to add staticlib to the CONFIG: | ||||
| qmake CONFIG+=staticlib | ||||
|
samakkon
|
r916 | Documentation | ||
| ============= | ||||
| The documentation can be generated with "make docs". It will be placed | ||||
| into "doc/html" in the build directory. | ||||
| KNOWN ISSUES | ||||
| ============ | ||||
|
Tero Ahola
|
r1402 | * The beta version of Qt Commercial Charts is still under development and thus | ||
| should not be used in e.g. product development | ||||
|
Tero Ahola
|
r1398 | * The Charts API might change between the Beta and the first official release | ||
| * Mutliple axis are not suported at the moment. | ||||
| * Logartmic, polar axis are not supported at the moment. | ||||
|
Tero Ahola
|
r1402 | * If using QAbstractiItemModel derived model with QBarSeries, data manipulation | ||
| with QBarSeries/QBarSet APIs does not synchronize the data into the model | ||||
|
Tero Ahola
|
r1398 | * Model support requires more thorough testing. | ||
| * Some QObject properties are missing | ||||
| * Some notifications missing from QObject properties | ||||
| * Legend layout does not work correctly with several labels | ||||
| * Animations with Bar Charts can cause crashes in certain situations | ||||
| * Automatic scaling of the axes is only done when you add a series on a chart | ||||
| * The QML Bindings are still under development | ||||
| * Mouse and touch interactions not complete on the QML API | ||||
|
Tero Ahola
|
r1402 | * Missing documentation for QML API; the QML demo applications serve as | ||
| documentation instead | ||||
| * Setting bar width is not possible on QBarSeries derived classes (the width | ||||
| is affected with setMargin, but it has limitations) | ||||
| * API for Animations state (signaling started, finished) and setting duration | ||||
sauimone
|
r1409 | etc. is missing | ||
| * In QBarSeries API bar margin related methods will be replaced with bar width | ||||
| in final release | ||||
|
Tero Ahola
|
r1417 | * OSX specific issue: after running 'make install' you need to fix the library | ||
| location of libQtCommercialChart.1.dylib to match the actual installation | ||||
| path. For example: | ||||
| sudo install_name_tool -id | ||||
| /usr/local/Trolltech/Qt-4.8.0/lib/libQtCommercialChart.1.dylib | ||||
| /usr/local/Trolltech/Qt-4.8.0/lib/libQtCommercialChart.1.dylib | ||||
|
Tero Ahola
|
r1398 | |||
|
Tero Ahola
|
r1402 | Main changes between Technology Preview and Beta release | ||
| ======================================================== | ||||
| * QBarSeries now enables defining both values and bar placement in X-Axis. | ||||
| Previous implementation of QBarSeries is now new series type: | ||||
| QGroupedBarSeries | ||||
|
Tero Ahola
|
r1398 | * QML API now defined and mostly implemented | ||
| * Q_PROPERTY definitions have been added to the API | ||||
|
Tero Ahola
|
r1402 | * Model API refactored and moved from Series Classes to separate Model | ||
| Mapper Classes | ||||
|
Tero Ahola
|
r1398 | * First version of Qt Designer plugin included | ||
|
sauimone
|
r1409 | * Example for handling Gestures included (ZoomLineChart example) | ||