| 1 | /**************************************************************************** | 
| 2 | ** | 
| 3 | ** Copyright (C) 2016 The Qt Company Ltd. | 
| 4 | ** Contact: https://www.qt.io/licensing/ | 
| 5 | ** | 
| 6 | ** This file is part of the QtSensors module of the Qt Toolkit. | 
| 7 | ** | 
| 8 | ** $QT_BEGIN_LICENSE:LGPL$ | 
| 9 | ** Commercial License Usage | 
| 10 | ** Licensees holding valid commercial Qt licenses may use this file in | 
| 11 | ** accordance with the commercial license agreement provided with the | 
| 12 | ** Software or, alternatively, in accordance with the terms contained in | 
| 13 | ** a written agreement between you and The Qt Company. For licensing terms | 
| 14 | ** and conditions see https://www.qt.io/terms-conditions. For further | 
| 15 | ** information use the contact form at https://www.qt.io/contact-us. | 
| 16 | ** | 
| 17 | ** GNU Lesser General Public License Usage | 
| 18 | ** Alternatively, this file may be used under the terms of the GNU Lesser | 
| 19 | ** General Public License version 3 as published by the Free Software | 
| 20 | ** Foundation and appearing in the file LICENSE.LGPL3 included in the | 
| 21 | ** packaging of this file. Please review the following information to | 
| 22 | ** ensure the GNU Lesser General Public License version 3 requirements | 
| 23 | ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. | 
| 24 | ** | 
| 25 | ** GNU General Public License Usage | 
| 26 | ** Alternatively, this file may be used under the terms of the GNU | 
| 27 | ** General Public License version 2.0 or (at your option) the GNU General | 
| 28 | ** Public license version 3 or any later version approved by the KDE Free | 
| 29 | ** Qt Foundation. The licenses are as published by the Free Software | 
| 30 | ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 | 
| 31 | ** included in the packaging of this file. Please review the following | 
| 32 | ** information to ensure the GNU General Public License requirements will | 
| 33 | ** be met: https://www.gnu.org/licenses/gpl-2.0.html and | 
| 34 | ** https://www.gnu.org/licenses/gpl-3.0.html. | 
| 35 | ** | 
| 36 | ** $QT_END_LICENSE$ | 
| 37 | ** | 
| 38 | ****************************************************************************/ | 
| 39 |  | 
| 40 | #include "qmltapsensor.h" | 
| 41 | #include <QtSensors/QTapSensor> | 
| 42 |  | 
| 43 | /*! | 
| 44 |     \qmltype TapSensor | 
| 45 |     \instantiates QmlTapSensor | 
| 46 |     \ingroup qml-sensors_type | 
| 47 |     \inqmlmodule QtSensors | 
| 48 |     \since QtSensors 5.0 | 
| 49 |     \inherits Sensor | 
| 50 |     \brief The TapSensor element reports tap and double tap events | 
| 51 |            along the X, Y and Z axes. | 
| 52 |  | 
| 53 |     The TapSensor element reports tap and double tap events | 
| 54 |     along the X, Y and Z axes. | 
| 55 |  | 
| 56 |     This element wraps the QTapSensor class. Please see the documentation for | 
| 57 |     QTapSensor for details. | 
| 58 |  | 
| 59 |     \sa TapReading | 
| 60 | */ | 
| 61 |  | 
| 62 | QmlTapSensor::QmlTapSensor(QObject *parent) | 
| 63 |     : QmlSensor(parent) | 
| 64 |     , m_sensor(new QTapSensor(this)) | 
| 65 | { | 
| 66 |     connect(sender: m_sensor, SIGNAL(returnDoubleTapEventsChanged(bool)), | 
| 67 |             receiver: this, SIGNAL(returnDoubleTapEventsChanged(bool))); | 
| 68 | } | 
| 69 |  | 
| 70 | QmlTapSensor::~QmlTapSensor() | 
| 71 | { | 
| 72 | } | 
| 73 |  | 
| 74 | QmlSensorReading *QmlTapSensor::createReading() const | 
| 75 | { | 
| 76 |     return new QmlTapSensorReading(m_sensor); | 
| 77 | } | 
| 78 |  | 
| 79 | QSensor *QmlTapSensor::sensor() const | 
| 80 | { | 
| 81 |     return m_sensor; | 
| 82 | } | 
| 83 |  | 
| 84 | /*! | 
| 85 |     \qmlproperty bool TapSensor::returnDoubleTapEvents | 
| 86 |     This property holds a value indicating if double tap events should be reported. | 
| 87 |  | 
| 88 |     Please see QTapSensor::returnDoubleTapEvents for information about this property. | 
| 89 | */ | 
| 90 |  | 
| 91 | bool QmlTapSensor::returnDoubleTapEvents() const | 
| 92 | { | 
| 93 |     return m_sensor->returnDoubleTapEvents(); | 
| 94 | } | 
| 95 |  | 
| 96 | void QmlTapSensor::setReturnDoubleTapEvents(bool ret) | 
| 97 | { | 
| 98 |     m_sensor->setReturnDoubleTapEvents(ret); | 
| 99 | } | 
| 100 |  | 
| 101 | /*! | 
| 102 |     \qmltype TapReading | 
| 103 |     \instantiates QmlTapSensorReading | 
| 104 |     \ingroup qml-sensors_reading | 
| 105 |     \inqmlmodule QtSensors | 
| 106 |     \since QtSensors 5.0 | 
| 107 |     \inherits SensorReading | 
| 108 |     \brief The TapReading element holds the most recent TapSensor reading. | 
| 109 |  | 
| 110 |     The TapReading element holds the most recent TapSensor reading. | 
| 111 |  | 
| 112 |     This element wraps the QTapReading class. Please see the documentation for | 
| 113 |     QTapReading for details. | 
| 114 |  | 
| 115 |     This element cannot be directly created. | 
| 116 | */ | 
| 117 |  | 
| 118 | QmlTapSensorReading::QmlTapSensorReading(QTapSensor *sensor) | 
| 119 |     : QmlSensorReading(sensor) | 
| 120 |     , m_sensor(sensor) | 
| 121 | { | 
| 122 | } | 
| 123 |  | 
| 124 | QmlTapSensorReading::~QmlTapSensorReading() | 
| 125 | { | 
| 126 | } | 
| 127 |  | 
| 128 | /*! | 
| 129 |     \qmlproperty TapDirection TapReading::tapDirection | 
| 130 |     This property holds the direction of the tap. | 
| 131 |  | 
| 132 |     Please see QTapReading::tapDirection for information about this property. | 
| 133 |  | 
| 134 |     Note that TapDirection constants are exposed through the TapReading class. | 
| 135 |     \code | 
| 136 |         TapSensor { | 
| 137 |             onReadingChanged: { | 
| 138 |                 if ((reading.tapDirection & TapReading.X_Both)) | 
| 139 |                     // do something | 
| 140 |             } | 
| 141 |         } | 
| 142 |     \endcode | 
| 143 | */ | 
| 144 |  | 
| 145 | QTapReading::TapDirection QmlTapSensorReading::tapDirection() const | 
| 146 | { | 
| 147 |     return m_tapDirection; | 
| 148 | } | 
| 149 |  | 
| 150 | /*! | 
| 151 |     \qmlproperty bool TapReading::doubleTap | 
| 152 |     This property holds a value indicating if there was a single or double tap. | 
| 153 |  | 
| 154 |     Please see QTapReading::doubleTap for information about this property. | 
| 155 | */ | 
| 156 |  | 
| 157 | bool QmlTapSensorReading::isDoubleTap() const | 
| 158 | { | 
| 159 |     return m_isDoubleTap; | 
| 160 | } | 
| 161 |  | 
| 162 | QSensorReading *QmlTapSensorReading::reading() const | 
| 163 | { | 
| 164 |     return const_cast<QTapSensor*>(m_sensor)->reading(); | 
| 165 | } | 
| 166 |  | 
| 167 | void QmlTapSensorReading::readingUpdate() | 
| 168 | { | 
| 169 |     QTapReading::TapDirection td = m_sensor->reading()->tapDirection(); | 
| 170 |     if (m_tapDirection != td) { | 
| 171 |         m_tapDirection = td; | 
| 172 |         Q_EMIT tapDirectionChanged(); | 
| 173 |     } | 
| 174 |     bool dTap = m_sensor->reading()->isDoubleTap(); | 
| 175 |     if (m_isDoubleTap != dTap) { | 
| 176 |         m_isDoubleTap = dTap; | 
| 177 |         Q_EMIT isDoubleTapChanged(); | 
| 178 |     } | 
| 179 | } | 
| 180 |  |