summaryrefslogtreecommitdiffstats
path: root/src/sensors/gestures/qsensorgesturemanager.cpp
diff options
context:
space:
mode:
Diffstat (limited to 'src/sensors/gestures/qsensorgesturemanager.cpp')
-rw-r--r--src/sensors/gestures/qsensorgesturemanager.cpp127
1 files changed, 127 insertions, 0 deletions
diff --git a/src/sensors/gestures/qsensorgesturemanager.cpp b/src/sensors/gestures/qsensorgesturemanager.cpp
new file mode 100644
index 00000000..a0430e15
--- /dev/null
+++ b/src/sensors/gestures/qsensorgesturemanager.cpp
@@ -0,0 +1,127 @@
+/****************************************************************************
+**
+** 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 "qsensorgesturemanager.h"
+#include "qsensorgesturemanagerprivate_p.h"
+
+Q_GLOBAL_STATIC(QSensorGestureManagerPrivate, sensorGestureManagerPrivate)
+
+/*!
+ \class QSensorGestureManager
+ \ingroup sensorgestures_main
+ \inmodule QtSensors
+
+ \brief The QSensorGestureManager class manages sensor gestures, registers and creates sensor gesture plugins.
+
+ Sensor Gesture plugins register their recognizers using the registerSensorGestureRecognizer() function.
+
+ \snippet snippets/sensorgestures/creating.cpp Receiving sensor gesture signals
+
+ */
+
+/*!
+ \fn QSensorGestureManager::newSensorGestureAvailable()
+ Signals when a new sensor gesture becomes available for use.
+ */
+
+/*!
+ Constructs the QSensorGestureManager as a child of \a parent
+ */
+QSensorGestureManager::QSensorGestureManager(QObject *parent)
+ : QObject(parent)
+{
+}
+
+/*!
+ Destroy the QSensorGestureManager
+*/
+QSensorGestureManager::~QSensorGestureManager()
+{
+}
+
+/*!
+ Registers the sensor recognizer \a recognizer for use.
+ QSensorGestureManager retains ownership of the recognizer object.
+ Returns true unless the gesture has already been registered, in
+ which case the object is deleted.
+
+ */
+
+ bool QSensorGestureManager::registerSensorGestureRecognizer(QSensorGestureRecognizer *recognizer)
+ {
+ bool ok = sensorGestureManagerPrivate()->registerSensorGestureRecognizer(recognizer);
+ if (ok)
+ Q_EMIT newSensorGestureAvailable();
+ else
+ delete recognizer;
+
+ return ok;
+ }
+
+
+ /*!
+ Returns the list of the currently registered gestures.
+ Includes all the standard built-ins as well as available plugins.
+ */
+ QStringList QSensorGestureManager::gestureIds() const
+ {
+ return sensorGestureManagerPrivate()->gestureIds();
+ }
+
+ /*!
+ Returns the list of all the gesture signals for the registered \a gestureId gesture recognizer id.
+ */
+ QStringList QSensorGestureManager::recognizerSignals(const QString &gestureId) const
+ {
+ QSensorGestureRecognizer *recognizer = sensorGestureRecognizer(gestureId);
+ if (recognizer != 0)
+ return recognizer->gestureSignals();
+ else
+ return QStringList();
+ }
+
+/*!
+ Returns the sensor gesture object for the recognizer \a id.
+ */
+QSensorGestureRecognizer *QSensorGestureManager::sensorGestureRecognizer(const QString &id)
+{
+ return sensorGestureManagerPrivate()->sensorGestureRecognizer(id);
+}