diff options
Diffstat (limited to 'src/datavisualization/doc/snippets')
6 files changed, 398 insertions, 0 deletions
diff --git a/src/datavisualization/doc/snippets/doc_src_q3dbars_construction.cpp b/src/datavisualization/doc/snippets/doc_src_q3dbars_construction.cpp new file mode 100644 index 00000000..a5615601 --- /dev/null +++ b/src/datavisualization/doc/snippets/doc_src_q3dbars_construction.cpp @@ -0,0 +1,46 @@ +/**************************************************************************** +** +** Copyright (C) 2013 Digia Plc +** All rights reserved. +** For any questions to Digia, please use contact form at http://qt.digia.com +** +** This file is part of the QtDataVisualization module. +** +** Licensees holding valid Qt Enterprise licenses may use this file in +** accordance with the Qt Enterprise License Agreement provided with the +** Software or, alternatively, in accordance with the terms contained in +** a written agreement between you and Digia. +** +** If you have questions regarding the use of this file, please use +** contact form at http://qt.digia.com +** +****************************************************************************/ + +//! [3] +#include <QtDataVisualization> + +using namespace QtDataVisualization; + +int main(int argc, char **argv) +{ + QGuiApplication app(argc, argv); + + //! [4] + Q3DBars *bars = new Q3DBars(); + //! [4] + //! [0] + bars->rowAxis()->setRange(0, 4); + bars->columnAxis()->setRange(0, 4); + //! [0] + //! [1] + QBarDataRow data; + data << 1.0 << 3.0 << 7.5 << 5.0 << 2.2; + bars->activeDataProxy()->addRow(&data); + //! [1] + //! [2] + bars->show(); + //! [2] + + return app.exec(); +} +//! [3] diff --git a/src/datavisualization/doc/snippets/doc_src_q3dscatter_construction.cpp b/src/datavisualization/doc/snippets/doc_src_q3dscatter_construction.cpp new file mode 100644 index 00000000..b2f48921 --- /dev/null +++ b/src/datavisualization/doc/snippets/doc_src_q3dscatter_construction.cpp @@ -0,0 +1,42 @@ +/**************************************************************************** +** +** Copyright (C) 2013 Digia Plc +** All rights reserved. +** For any questions to Digia, please use contact form at http://qt.digia.com +** +** This file is part of the QtDataVisualization module. +** +** Licensees holding valid Qt Enterprise licenses may use this file in +** accordance with the Qt Enterprise License Agreement provided with the +** Software or, alternatively, in accordance with the terms contained in +** a written agreement between you and Digia. +** +** If you have questions regarding the use of this file, please use +** contact form at http://qt.digia.com +** +****************************************************************************/ + +//! [3] +#include <QtDataVisualization> + +using namespace QtDataVisualization; + +int main(int argc, char **argv) +{ + QGuiApplication app(argc, argv); + + //! [0] + Q3DScatter *scatter = new Q3DScatter(); + //! [0] + //! [1] + QScatterDataArray data; + data << QVector3D(1.0f, 0.5f, 1.0f) << QVector3D(-1.0f, -0.5f, -1.0f) << QVector3D(0.5f, 0.0f, 0.0f); + scatter->activeDataProxy()->addItems(data); + //! [1] + //! [2] + scatter->show(); + //! [2] + + return app.exec(); +} +//! [3] diff --git a/src/datavisualization/doc/snippets/doc_src_q3dsurface_construction.cpp b/src/datavisualization/doc/snippets/doc_src_q3dsurface_construction.cpp new file mode 100644 index 00000000..33b6cf37 --- /dev/null +++ b/src/datavisualization/doc/snippets/doc_src_q3dsurface_construction.cpp @@ -0,0 +1,50 @@ +/**************************************************************************** +** +** Copyright (C) 2013 Digia Plc +** All rights reserved. +** For any questions to Digia, please use contact form at http://qt.digia.com +** +** This file is part of the QtDataVisualization module. +** +** Licensees holding valid Qt Enterprise licenses may use this file in +** accordance with the Qt Enterprise License Agreement provided with the +** Software or, alternatively, in accordance with the terms contained in +** a written agreement between you and Digia. +** +** If you have questions regarding the use of this file, please use +** contact form at http://qt.digia.com +** +****************************************************************************/ + +//! [5] +#include <QtDataVisualization> + +using namespace QtDataVisualization; + +int main(int argc, char **argv) +{ + QGuiApplication app(argc, argv); + + //! [0] + Q3DSurface surface; + //! [0] + //! [1] + QSurfaceDataArray *data = new QSurfaceDataArray; + QSurfaceDataRow *dataRow = new QSurfaceDataRow; + //! [1] + + //! [2] + *dataRow << 0.1 << 1.8 << 0.4; + *data << dataRow; + //! [2] + + //! [3] + surface.activeDataProxy()->resetArray(data); + //! [3] + //! [4] + surface.show(); + //! [4] + + return app.exec(); +} +//! [5] diff --git a/src/datavisualization/doc/snippets/doc_src_qmldatavisualization.cpp b/src/datavisualization/doc/snippets/doc_src_qmldatavisualization.cpp new file mode 100644 index 00000000..f4446e17 --- /dev/null +++ b/src/datavisualization/doc/snippets/doc_src_qmldatavisualization.cpp @@ -0,0 +1,121 @@ +/**************************************************************************** +** +** Copyright (C) 2013 Digia Plc +** All rights reserved. +** For any questions to Digia, please use contact form at http://qt.digia.com +** +** This file is part of the QtDataVisualization module. +** +** Licensees holding valid Qt Enterprise licenses may use this file in +** accordance with the Qt Enterprise License Agreement provided with the +** Software or, alternatively, in accordance with the terms contained in +** a written agreement between you and Digia. +** +** If you have questions regarding the use of this file, please use +** contact form at http://qt.digia.com +** +****************************************************************************/ + +//! [0] +import com.digia.QtDataVisualization 1.0 +//! [0] + +//! [1] +Bars3D { + rows: 4 + columns: 4 + dataProxy: barProxy // an ItemModelBarDataProxy + barSpacing: Qt.size(0.5, 0.5) + barSpacingRelative: false + itemLabelFormat: "@valueTitle for @colLabel, @rowLabel: @valueLabel" +} +//! [1] + +//! [2] +Scatter3D { + dataProxy: scatterProxy // an ItemModelScatterDataProxy + itemLabelFormat: "X:@xLabel Y:@yLabel Z:@zLabel" + axisX.segmentCount: 2 + axisX.subSegmentCount: 2 + axisX.labelFormat: "%.2f" + axisZ.segmentCount: 2 + axisZ.subSegmentCount: 2 + axisZ.labelFormat: "%.2f" + axisY.segmentCount: 3 + axisY.subSegmentCount: 2 + axisY.labelFormat: "%.2f" +} +//! [2] + +//! [3] +Surface3D { + dataProxy: surfaceProxy // an ItemModelSurfaceDataProxy + axisX.min: 0.0 + axisX.max: 10.0 + axisZ.min: 0.0 + axisZ.max: 10.0 + axisY.min: 0.0 + axisY.max: 5.0 + axisX.segmentCount: 5 + axisX.subSegmentCount: 2 + axisX.labelFormat: "%i" + axisZ.segmentCount: 5 + axisZ.subSegmentCount: 2 + axisZ.labelFormat: "%i" + axisY.segmentCount: 5 + axisY.labelFormat: "%.1f" +} +//! [3] + +//! [4] +BarDataMapping { + id: barMapping + rowRole: "year" + columnRole: "city" + valueRole: "expenses" + rowCategories: ["2010", "2011", "2012", "2013"] + columnCategories: ["Oulu", "Rauma", "Helsinki", "Tampere"] +} +//! [4] + +//! [5] +ScatterDataMapping { + id: scatterMapping + xPosRole: "xPos" + yPosRole: "yPos" + zPosRole: "zPos" +} +//! [5] + +//! [6] +SurfaceDataMapping { + id: surfaceMapping + rowRole: "latitude" + columnRole: "longitude" + valueRole: "population" +} +//! [6] + +//! [7] +ItemModelBarDataProxy { + id: barProxy + activeMapping: barMapping // a BarDataMapping + itemModel: dataModel // a ListModel +} +//! [7] + +//! [8] +ItemModelScatterDataProxy { + id: scatterProxy + activeMapping: scatterMapping // a ScatterDataMapping + itemModel: dataModel // a ListModel +} +//! [8] + +//! [9] +ItemModelSurfaceDataProxy { + id: surfaceProxy + activeMapping: surfaceMapping // a SurfaceDataMapping + itemModel: dataModel // a ListModel +} +//! [9] diff --git a/src/datavisualization/doc/snippets/doc_src_qtdatavisualization.cpp b/src/datavisualization/doc/snippets/doc_src_qtdatavisualization.cpp new file mode 100644 index 00000000..2f3d6a98 --- /dev/null +++ b/src/datavisualization/doc/snippets/doc_src_qtdatavisualization.cpp @@ -0,0 +1,118 @@ +/**************************************************************************** +** +** Copyright (C) 2013 Digia Plc +** All rights reserved. +** For any questions to Digia, please use contact form at http://qt.digia.com +** +** This file is part of the QtDataVisualization module. +** +** Licensees holding valid Qt Enterprise licenses may use this file in +** accordance with the Qt Enterprise License Agreement provided with the +** Software or, alternatively, in accordance with the terms contained in +** a written agreement between you and Digia. +** +** If you have questions regarding the use of this file, please use +** contact form at http://qt.digia.com +** +****************************************************************************/ + +//! [0] +#include <QtDataVisualization> + +using namespace QtDataVisualization; +//! [0] + +//! [1] +proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f")); +//! [1] + +//! [2] +proxy->setItemLabelFormat(QStringLiteral("@xTitle: @xValue, @yTitle: @yValue, @zTitle: @zValue")); +//! [2] + +//! [3] +// By defining row and column categories, you tell the mapping which row and column each item +// belongs to. The categories must match the data stored in the model in the roles you define +// for row and column mapping. In this example we expect "year" role to return four digit year +// and "month" to return three letter designation for the month. +// +// An example of an item in model would be: +// Requested role -> Returned data +// "year" -> "2006" // Matches the first row category, so this item is added to the first row. +// "month" -> "jan" // Matches the first column category, so this item is added as first item in the row. +// "income" -> "12.1" +// "expenses" -> "9.2" +QStringList years; +QStringList months; +years << "2006" << "2007" << "2008" << "2009" << "2010" << "2011" << "2012"; +months << "jan" << "feb" << "mar" << "apr" << "may" << "jun" << "jul" << "aug" << "sep" << "oct" << "nov" << "dec"; + +QItemModelBarDataMapping *mapping = new QItemModelBarDataMapping(QStringLiteral("year"), // Row role + QStringLiteral("month"), // Column role + QStringLiteral("income"), // Value role + years, // Row categories + months); // Column categories + +QItemModelBarDataProxy *proxy = new QItemModelBarDataProxy(customModel, mapping); + +//... + +// To display different data later, you can simply change the mapping of the current +// mapping object, or set another mapping object. +proxy->activeMapping()->setValueRole(QStringLiteral("expenses")); +//! [3] + +//! [4] +// Map "density" value to X-axis, "hardness" to Y-axis and "conductivity" to Z-axis. +QItemModelScatterDataMapping *mapping = new QItemModelScatterDataMapping(QStringLiteral("density"), + QStringLiteral("hardness"), + QStringLiteral("conductivity")) + +QItemModelScatterDataProxy *proxy = new QItemModelScatterDataProxy(customModel, mapping); +//! [4] + +//! [5] +QItemModelSurfaceDataMapping *mapping = new QItemModelSurfaceDataMapping(QStringLiteral("longitude"), // Row role + QStringLiteral("latitude"), // Column role + QStringLiteral("height")); // value role + +QItemModelSurfaceDataProxy *proxy = new QItemModelSurfaceDataProxy(customModel, mapping); +//! [5] + +//! [6] +qmake +make +//! [6] + +//! [7] +qmake CONFIG+=static +make +//! [7] + +//! [8] +qmake +make +./qmlsurface +//! [8] + +//! [9] +Q3DBars *graph = new Q3DBars(); +QWidget *container = QWidget::createWindowContainer(graph); +//! [9] + +//! [10] +Q3DBars graph; +QBarDataProxy *newProxy = new QBarDataProxy; + +QBarDataArray *dataArray = new QBarDataArray; +dataArray->reserve(10); +for (int i = 0; i < 10; i++) { + QBarDataRow *dataRow = new QBarDataRow(5); + for (int j = 0; j < 5; j++) + (*dataRow)[j].setValue(myData->getValue(i, j)); + dataArray->append(dataRow); +} + +newProxy->resetArray(dataArray); +graph->setActiveDataProxy(newProxy); +//! [10] diff --git a/src/datavisualization/doc/snippets/doc_src_qtdatavisualization.pro b/src/datavisualization/doc/snippets/doc_src_qtdatavisualization.pro new file mode 100644 index 00000000..81555f88 --- /dev/null +++ b/src/datavisualization/doc/snippets/doc_src_qtdatavisualization.pro @@ -0,0 +1,21 @@ +/**************************************************************************** +** +** Copyright (C) 2013 Digia Plc +** All rights reserved. +** For any questions to Digia, please use contact form at http://qt.digia.com +** +** This file is part of the QtDataVisualization module. +** +** Licensees holding valid Qt Enterprise licenses may use this file in +** accordance with the Qt Enterprise License Agreement provided with the +** Software or, alternatively, in accordance with the terms contained in +** a written agreement between you and Digia. +** +** If you have questions regarding the use of this file, please use +** contact form at http://qt.digia.com +** +****************************************************************************/ + +#! [0] +QT += datavisualization +#! [0] |