summaryrefslogtreecommitdiffstats
path: root/doc/src/imports/qtsensors5.qdoc
blob: 6f1a46a45d13b62e2b327c0ac329174b1f3f2f64 (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
/****************************************************************************
**
** Copyright (C) 2012 Nokia Corporation and/or its subsidiary(-ies).
** Contact: http://www.qt-project.org/
**
** 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 import statement, as such: \e import QtSensors 5.0

    The QML Sensors 5 Plugin provides an easy to use interface to the Sensors API.
    It enables the receiving of sensor events and reading current values from the
    sensors.

    The plugin contains many sensor types and properties to read values.
    As an example, consider the tilt sensor. The \l {QML QtSensors example}
    simply displays text on-screen to show the current tilt value.

    The QML code to read the value is quite simple. Below is a QML \l TiltSensor element
    declared with an id of \e tilt. 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 value so that it can be used for further calculations.

    \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

*/