path: root/examples/datavisualization/rotations/doc/src
diff options
authorMiikka Heikkinen <>2014-02-13 09:59:52 +0200
committerMiikka Heikkinen <>2014-02-13 10:09:17 +0200
commit88cd10aa7b3559b092cf5575b0a17d002dc100ae (patch)
tree9d6e7efdec49419558bb4ef4a9bc02ae3cb1cfc4 /examples/datavisualization/rotations/doc/src
parentecabd51692b476567dc42a745f51996ec665b385 (diff)
Fix examples installation
Had to add one folder to the examples structure so installation works correctly. Change-Id: Ic92dfe9997413a6243abcf5eeba12744ba9e938c Reviewed-by: Tomi Korpipää <>
Diffstat (limited to 'examples/datavisualization/rotations/doc/src')
1 files changed, 68 insertions, 0 deletions
diff --git a/examples/datavisualization/rotations/doc/src/rotations.qdoc b/examples/datavisualization/rotations/doc/src/rotations.qdoc
new file mode 100644
index 00000000..2de29195
--- /dev/null
+++ b/examples/datavisualization/rotations/doc/src/rotations.qdoc
@@ -0,0 +1,68 @@
+** Copyright (C) 2014 Digia Plc
+** All rights reserved.
+** For any questions to Digia, please use contact form at
+** 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
+ \example rotations
+ \title Rotations Example
+ \ingroup qtdatavisualization_examples
+ \brief Using rotated scatter items
+ This example shows how to do the following:
+ \list
+ \li Use item rotations
+ \li Use custom item meshes
+ \li Use range gradient to color the series
+ \endlist
+ For more basic example about using Qt Data Visualization graphs, see \l{Bars Example}.
+ \image rotations-example.png
+ \section1 Using rotations
+ In this example we want to orient the arrow items tangentially to the origin. This requires
+ rotating them, which can be achieved by specifying rotation quaternion to each item:
+ \snippet ../examples/rotations/scatterdatamodifier.cpp 0
+ \snippet ../examples/rotations/scatterdatamodifier.cpp 1
+ \snippet ../examples/rotations/scatterdatamodifier.cpp 2
+ Since the items need to be rotated along two axes, we define two rotation quaternions, one
+ for Y-axis and one for Z-axis, and then multiply these together to get the total rotation,
+ which we set to the data item.
+ \section1 Using custom item meshes
+ The narrow arrow mesh we use for magnetic field arrow items is not a standard mesh. Instead
+ we supply our own \c{narrowarrow.obj} file which contains the object definition for the mesh
+ in \c Wavefront obj format:
+ \snippet ../examples/rotations/scatterdatamodifier.cpp 3
+ \section1 Using range gradient
+ Setting the color style to range gradient in a series means that the item is colored according
+ to its relative Y-value on the visible Y-coordinate range. We want the arrows on the bottom
+ part of the graph to be darker and gradually get lighter higher they are, so we define a
+ range gradient with black color at the position 0.0 and white color at the position 1.0:
+ \snippet ../examples/rotations/scatterdatamodifier.cpp 4
+ \section1 Example contents