/**************************************************************************** ** ** 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 QtSensors module of the Qt Toolkit. ** ** $QT_BEGIN_LICENSE:LGPL$ ** GNU Lesser General Public License Usage ** This file may be used under the terms of the GNU Lesser General Public ** License version 2.1 as published by the Free Software Foundation and ** appearing in the file LICENSE.LGPL included in the packaging of this ** file. Please review the following information to ensure the GNU Lesser ** General Public License version 2.1 requirements will be met: ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. ** ** In addition, as a special exception, Nokia gives you certain additional ** rights. These rights are described in the Nokia Qt LGPL Exception ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. ** ** GNU General Public License Usage ** Alternatively, this file may be used under the terms of the GNU General ** Public License version 3.0 as published by the Free Software Foundation ** and appearing in the file LICENSE.GPL included in the packaging of this ** file. Please review the following information to ensure the GNU General ** Public License version 3.0 requirements will be met: ** http://www.gnu.org/copyleft/gpl.html. ** ** 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$ ** ****************************************************************************/ #include #include #include #include "qsensorgesture.h" #include "qsensorgesture_p.h" #include "qsensorgesturemanager.h" #include /*! \class QSensorGesture \ingroup sensorgestures_main \inmodule QtSensors \brief The QSensorGesture class represents one or more sensor gesture recognizers. In addition to the QSensorGesture::detected() signal, Sensor Gesture Recognizers can have their own specific signals, and may be discovered through QSensorGesture::gestureSignals(). \bold {Note that QSensorGesture uses a custom meta-object in order to provide recognizer-specific signals. This means it is not possible to sub-class QSensorGesture and use Q_OBJECT. Also qobject_cast(ptr) will not work.} \sa QSensorGestureRecognizer You may use QSensorGestureManager to obtain the systems known sensor gesture ids. \sa QSensorGestureManager */ #ifdef Q_QDOC /*! \fn QSensorGesture::detected(QString gestureId) Signals when the \a gestureId gesture has been recognized. */ #endif /*! Constructs the sensor gesture, and initializes the \a ids list of recognizers, with parent \a parent */ QSensorGesture::QSensorGesture(const QStringList &ids, QObject *parent) : QObject(parent) { d_ptr = new QSensorGesturePrivate(); Q_FOREACH (const QString &id, ids) { QSensorGestureRecognizer * rec = QSensorGestureManager::sensorGestureRecognizer(id); if (rec != 0) { d_ptr->m_sensorRecognizers.append(rec); d_ptr->availableIds.append(id); } else { d_ptr->invalidIds.append(id); //add to not available things } } d_ptr->meta = 0; QMetaObjectBuilder builder; builder.setSuperClass(&QObject::staticMetaObject); builder.setClassName("QSensorGesture"); Q_FOREACH (QSensorGestureRecognizer *recognizer, d_ptr->m_sensorRecognizers) { Q_FOREACH (const QString &gesture, recognizer->gestureSignals()) { QMetaMethodBuilder b = builder.addSignal(gesture.toLatin1()); if (!d_ptr->localGestureSignals.contains(QLatin1String(b.signature()))) d_ptr->localGestureSignals.append(QLatin1String(b.signature())); } recognizer->createBackend(); } d_ptr->meta = builder.toMetaObject(); if (d_ptr->m_sensorRecognizers.count() > 0) { d_ptr->valid = true; } } /*! Destroy the QSensorGesture */ QSensorGesture::~QSensorGesture() { stopDetection(); if (d_ptr->meta) qFree(d_ptr->meta); delete d_ptr; } /*! Returns the gesture recognizer ids that were found. */ QStringList QSensorGesture::validIds() const { return d_ptr->availableIds; } /*! Returns the gesture recognizer ids that were not found. */ QStringList QSensorGesture::invalidIds() const { return d_ptr->invalidIds; } /*! Starts the gesture detection routines in the recognizer. */ void QSensorGesture::startDetection() { if (d_ptr->m_sensorRecognizers.count() < 1) return; if (d_ptr->isActive) return; Q_FOREACH (QSensorGestureRecognizer *recognizer, d_ptr->m_sensorRecognizers) { Q_ASSERT(recognizer !=0); connect(recognizer,SIGNAL(detected(QString)), this,SIGNAL(detected(QString)),Qt::UniqueConnection); //connect recognizer signals Q_FOREACH (QString method, recognizer->gestureSignals()) { method.prepend(QLatin1String("2")); connect(recognizer, method.toLatin1(), this, method.toLatin1(), Qt::UniqueConnection); } recognizer->startBackend(); } d_ptr->isActive = true; } /*! Stops the gesture detection routines. */ void QSensorGesture::stopDetection() { if (d_ptr->m_sensorRecognizers.count() < 1) return; if (!d_ptr->isActive) return; Q_FOREACH (QSensorGestureRecognizer *recognizer, d_ptr->m_sensorRecognizers) { disconnect(recognizer,SIGNAL(detected(QString)), this,SIGNAL(detected(QString))); //disconnect recognizer signals Q_FOREACH (QString method,recognizer->gestureSignals()) { method.prepend(QLatin1String("2")); disconnect(recognizer, method.toLatin1(), this, method.toLatin1()); } recognizer->stopBackend(); } d_ptr->isActive = false; } /*! Returns all the possible gestures signals that may be emitted. */ QStringList QSensorGesture::gestureSignals() const { if (d_ptr->m_sensorRecognizers.count() > 0) { return d_ptr->localGestureSignals; } return QStringList(); } /*! Returns whether this gesture is active or not. */ bool QSensorGesture::isActive() { return d_ptr->isActive; } /*! \internal */ const QMetaObject* QSensorGesture::metaObject() const { return d_ptr->meta; } /*! \internal */ int QSensorGesture::qt_metacall(QMetaObject::Call c, int id, void **a) { id = QObject::qt_metacall(c, id, a); if (id < 0 || !d_ptr->meta) return id; QMetaObject::activate(this, d_ptr->meta, id, a); return id; } QSensorGesturePrivate::QSensorGesturePrivate(QObject *parent) : QObject(parent),isActive(0), valid(0) { } QSensorGesturePrivate::~QSensorGesturePrivate() { }