From 2a11c7f805ce1f980167af4971cde1eebe660c7a Mon Sep 17 00:00:00 2001 From: Miikka Heikkinen Date: Wed, 11 Dec 2013 11:38:59 +0200 Subject: Add a paragraph about series to Data Handling article MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Also other minor fixes. Task-number: QTRD-2593 Change-Id: I2491090cf00b6a081b11a62a577cc192b8a2ad03 Reviewed-by: Tomi Korpipää --- .../doc/src/qtdatavisualization.qdoc | 19 +++++++++++++++---- 1 file changed, 15 insertions(+), 4 deletions(-) (limited to 'src/datavisualization/doc/src/qtdatavisualization.qdoc') diff --git a/src/datavisualization/doc/src/qtdatavisualization.qdoc b/src/datavisualization/doc/src/qtdatavisualization.qdoc index 7716fb4c..ddbbf04b 100644 --- a/src/datavisualization/doc/src/qtdatavisualization.qdoc +++ b/src/datavisualization/doc/src/qtdatavisualization.qdoc @@ -167,6 +167,19 @@ \page qtdatavisualization_data_handling.html \title Qt Data Visualization Data Handling + \section1 Series + + Series is combination of logically connected set of data items (handled by a data proxy) + and visual properties that describe how the data items should be rendered, such as item + meshes and colors. Each visualization type has its own series type. For example, bar graphs + use QBar3DSeries. Bar and scatter graphs can have multiple series added simultaneously. + Surface graphs support only a single series at a time. + + This code snippet shows how to use QBar3DSeries to render bars as cylinders and with a + gradient instead of a uniform color: + + \snippet doc_src_qtdatavisualization.cpp 11 + \section1 Data proxies The data that users wish to visualize comes in many formats, all of which cannot obviously be @@ -175,9 +188,9 @@ which takes data in a format suitable for that visualization. For example, the basic proxy for QBar3DSeries is QBarDataProxy, which stores rows of QBarDataItem objects. Each QBarDataItem stores a single bar value. Additional typedefs are provided for - QBarDataArray and QBarDataRow containers. + \c QBarDataArray and \c QBarDataRow containers. - This code snipped shows how to use basic proxy when your data is stored in some hypothetical + This code snippet shows how to use basic proxy when your data is stored in some hypothetical \c myData object: \snippet doc_src_qtdatavisualization.cpp 10 @@ -244,8 +257,6 @@ For the best performance with the scatter and surface graphs, only keep the data you need in the proxy. - - \note Data handling is not yet fully optimized in the technology preview version. */ /*! -- cgit v1.2.3