summaryrefslogtreecommitdiffstats
path: root/doc/src/imports/qtsensors5.qdoc
blob: 97acacfaf571ae51a2520a26f4e1cf64873845d2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
/****************************************************************************
**
** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (qt-info@nokia.com)
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:FDL$
** GNU Free Documentation License
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file.
**
** Other Usage
** Alternatively, this file may be used in accordance with the terms
** and conditions contained in a signed written agreement between you
** and Nokia.
**
**
**
**
** $QT_END_LICENSE$
**
****************************************************************************/

/*!
    \qmlmodule QtSensors 5
    \title QtSensors 5.x
    \brief The QML import for QtSensors

    \section1 Overview

    The identifying string for this component is \e QtSensors.
    Use this in the QML \e import  statement.

    The QML Sensors 5 Plugin provides an easy to use interface to the Sensors API.
    It enables us to receive sensor events and to read current values from
    sensors.

    The plugin contains many sensor types and properties to read values
    from them. As an example consider the tilt sensor. The qmlsensors2
    simply displays text on-screen to show the current tilt.

    The QML code that reads the value is quite simple. Here we see a QML component
    tilt declared which is an \l TiltSensor element. First
    the sensor is started by setting the running property
    to true. The element receives a signal when the x and y rotation changes and it
    can be picked up by the onXRotationChanged and onYRotationChanged slot. Now the
    xRotation and yRotation property of this element can be
    used to extract the current tilt so that it can be used for further calulations.

    \qml
        TiltSensor {
            id: tilt
            enabled: false
            unit: TiltSensor.Degrees
            accuracy: 1.0
        }
    \endqml

    \qml
        Text {
            x:5
            y:160
            text: "X Rotation: " + tilt.xRotation
        }
    \endqml

    \qml
        Text {
            x:5
            y:180
            text: "Y Rotation: " + tilt.yRotation
        }

    \endqml

    \section1 QML Elements

*/