diff options
Diffstat (limited to 'examples/datavisualization/rotations/doc/src')
-rw-r--r-- | examples/datavisualization/rotations/doc/src/rotations.qdoc | 68 |
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 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 +** +****************************************************************************/ + +/*! + \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 +*/ |