qstmgesturelib/recognisers/qstmmaybetapgesturerecogniser.cpp
author hgs
Fri, 15 Oct 2010 17:30:59 -0400
changeset 16 3c88a81ff781
permissions -rw-r--r--
201041
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
16
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
*
hgs
parents:
diff changeset
     5
* This program is free software: you can redistribute it and/or modify
hgs
parents:
diff changeset
     6
* it under the terms of the GNU Lesser General Public License as published by
hgs
parents:
diff changeset
     7
* the Free Software Foundation, version 2.1 of the License.
hgs
parents:
diff changeset
     8
* 
hgs
parents:
diff changeset
     9
* This program is distributed in the hope that it will be useful,
hgs
parents:
diff changeset
    10
* but WITHOUT ANY WARRANTY; without even the implied warranty of
hgs
parents:
diff changeset
    11
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
hgs
parents:
diff changeset
    12
* GNU Lesser General Public License for more details.
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* You should have received a copy of the GNU Lesser General Public License
hgs
parents:
diff changeset
    15
* along with this program.  If not, 
hgs
parents:
diff changeset
    16
* see "http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html/".
hgs
parents:
diff changeset
    17
*
hgs
parents:
diff changeset
    18
* Description:
hgs
parents:
diff changeset
    19
*
hgs
parents:
diff changeset
    20
*/
hgs
parents:
diff changeset
    21
#include "qstmgenericsimplegesture.h"
hgs
parents:
diff changeset
    22
#include "qstmmaybetapgesturerecogniser.h"
hgs
parents:
diff changeset
    23
#include "qstmuievent_if.h"
hgs
parents:
diff changeset
    24
#include "qstmutils.h"
hgs
parents:
diff changeset
    25
#include "qstmfilelogger.h"
hgs
parents:
diff changeset
    26
hgs
parents:
diff changeset
    27
using namespace qstmGesture ;
hgs
parents:
diff changeset
    28
using namespace qstmUiEventEngine;
hgs
parents:
diff changeset
    29
hgs
parents:
diff changeset
    30
QStm_MaybeTapGestureRecogniser::QStm_MaybeTapGestureRecogniser(QStm_GestureListenerIf* listener) :
hgs
parents:
diff changeset
    31
                                        QStm_GestureRecogniser(listener)
hgs
parents:
diff changeset
    32
{
hgs
parents:
diff changeset
    33
    m_powner = listener->getOwner() ;
hgs
parents:
diff changeset
    34
    if (listener) {
hgs
parents:
diff changeset
    35
        addTapListener(listener, m_powner) ;
hgs
parents:
diff changeset
    36
    }
hgs
parents:
diff changeset
    37
    m_gestureEnabled = true;
hgs
parents:
diff changeset
    38
    m_numOfActiveStreams = 0;
hgs
parents:
diff changeset
    39
hgs
parents:
diff changeset
    40
}
hgs
parents:
diff changeset
    41
hgs
parents:
diff changeset
    42
QStm_MaybeTapGestureRecogniser::~QStm_MaybeTapGestureRecogniser()
hgs
parents:
diff changeset
    43
{
hgs
parents:
diff changeset
    44
    m_tapListeners.clear() ;
hgs
parents:
diff changeset
    45
    m_tapListenerWindows.clear() ;
hgs
parents:
diff changeset
    46
}
hgs
parents:
diff changeset
    47
hgs
parents:
diff changeset
    48
QStm_GestureRecognitionState QStm_MaybeTapGestureRecogniser::recognise(int numOfActiveStreams,
hgs
parents:
diff changeset
    49
                              QStm_GestureEngineIf* pge)
hgs
parents:
diff changeset
    50
{
hgs
parents:
diff changeset
    51
    QStm_GestureRecognitionState state = m_state = ENotMyGesture;
hgs
parents:
diff changeset
    52
    // Check if we are enabled or not
hgs
parents:
diff changeset
    53
    if (!m_gestureEnabled) return state ;
hgs
parents:
diff changeset
    54
    
hgs
parents:
diff changeset
    55
    // Look at the events to see if it looks like a tap or double tap
hgs
parents:
diff changeset
    56
    if (numOfActiveStreams == 1) {
hgs
parents:
diff changeset
    57
        m_numOfActiveStreams = numOfActiveStreams; 
hgs
parents:
diff changeset
    58
        // Then look at the event stream, it has to be tap and release
hgs
parents:
diff changeset
    59
        const qstmUiEventEngine::QStm_UiEventIf* puie = pge->getUiEvents(0);
hgs
parents:
diff changeset
    60
        int countOfEvents = puie->countOfEvents() ;
hgs
parents:
diff changeset
    61
        qstmUiEventEngine::QStm_UiEventCode eventCode = puie->code() ;
hgs
parents:
diff changeset
    62
hgs
parents:
diff changeset
    63
        if (m_loggingenabled) {
hgs
parents:
diff changeset
    64
            LOGARG("QStm_MaybeTapGestureRecogniser: event: %s, countOfEvents: %d, code: %d", 
hgs
parents:
diff changeset
    65
                   event_name(eventCode), countOfEvents, eventCode);
hgs
parents:
diff changeset
    66
        }
hgs
parents:
diff changeset
    67
        void* target = puie->target();
hgs
parents:
diff changeset
    68
        
hgs
parents:
diff changeset
    69
        if (countOfEvents == 2) { // Do we have touch and release in the stream, check if there are two events
hgs
parents:
diff changeset
    70
hgs
parents:
diff changeset
    71
            // Then look at the events to see if they are suitable for us
hgs
parents:
diff changeset
    72
            if (target && eventCode == qstmUiEventEngine::ERelease) {// The last one is release
hgs
parents:
diff changeset
    73
hgs
parents:
diff changeset
    74
                qstmUiEventEngine::QStm_UiEventIf* puieFirst = puie->previousEvent();
hgs
parents:
diff changeset
    75
hgs
parents:
diff changeset
    76
                if (puieFirst != NULL && 
hgs
parents:
diff changeset
    77
                    (eventCode = puieFirst->code()) == qstmUiEventEngine::ETouch && // is the first one ETouch
hgs
parents:
diff changeset
    78
                    isPointClose(puie->currentXY(), puie->previousXY())) { // if system failed to deliver move event between 
hgs
parents:
diff changeset
    79
                	                                                       // down and up we can get tap with two points
hgs
parents:
diff changeset
    80
                	                                                       // too far from each other, so check for it
hgs
parents:
diff changeset
    81
hgs
parents:
diff changeset
    82
                    if (m_loggingenabled) {
hgs
parents:
diff changeset
    83
                        LOGARG("QStm_MaybeTapGestureRecogniser: 0x%x TAP: countOfEvents: %d, event: %s", this, countOfEvents, event_name(eventCode));
hgs
parents:
diff changeset
    84
                    }
hgs
parents:
diff changeset
    85
                    
hgs
parents:
diff changeset
    86
                    m_firstTapXY = puieFirst->currentXY() ;
hgs
parents:
diff changeset
    87
                    m_firstTapTarget = target ;
hgs
parents:
diff changeset
    88
                    m_firstTapSpeed = puie->speed() ;
hgs
parents:
diff changeset
    89
                    int inx = m_tapListenerWindows.indexOf(m_firstTapTarget) ;
hgs
parents:
diff changeset
    90
                    if (inx == -1) {
hgs
parents:
diff changeset
    91
                        inx = 0;
hgs
parents:
diff changeset
    92
                    }
hgs
parents:
diff changeset
    93
                    qstmGesture::QStm_GenericSimpleGesture pgest(
hgs
parents:
diff changeset
    94
                                        qstmGesture::EGestureUidMaybeTap, 
hgs
parents:
diff changeset
    95
                                        m_firstTapXY, 
hgs
parents:
diff changeset
    96
                                        puie->timestamp(),
hgs
parents:
diff changeset
    97
                                        qstmGesture::ETapTypeSingle, 
hgs
parents:
diff changeset
    98
                                        puieFirst) ; // TODO: speed is 0?
hgs
parents:
diff changeset
    99
                                    pgest.setTarget(puie->target());
hgs
parents:
diff changeset
   100
                                    QStm_GestureListenerIf* plistener = m_tapListeners[inx] ;
hgs
parents:
diff changeset
   101
                                    plistener->gestureEnter(pgest) ;
hgs
parents:
diff changeset
   102
                }
hgs
parents:
diff changeset
   103
            }
hgs
parents:
diff changeset
   104
        }
hgs
parents:
diff changeset
   105
    }
hgs
parents:
diff changeset
   106
    m_state = state;
hgs
parents:
diff changeset
   107
    return state;
hgs
parents:
diff changeset
   108
}
hgs
parents:
diff changeset
   109
hgs
parents:
diff changeset
   110
void QStm_MaybeTapGestureRecogniser::release(QStm_GestureEngineIf* /*ge*/)
hgs
parents:
diff changeset
   111
{
hgs
parents:
diff changeset
   112
    if (m_loggingenabled) {
hgs
parents:
diff changeset
   113
        LOGARG("QStm_MaybeTapGestureRecogniser: 0x%x release, %d %d", this, m_firstTapXY.x(), m_firstTapXY.y());
hgs
parents:
diff changeset
   114
    }
hgs
parents:
diff changeset
   115
    m_state = ENotMyGesture;
hgs
parents:
diff changeset
   116
}
hgs
parents:
diff changeset
   117
hgs
parents:
diff changeset
   118
void QStm_MaybeTapGestureRecogniser::enableLogging(bool loggingOn)
hgs
parents:
diff changeset
   119
{
hgs
parents:
diff changeset
   120
    m_loggingenabled = loggingOn;
hgs
parents:
diff changeset
   121
}
hgs
parents:
diff changeset
   122
hgs
parents:
diff changeset
   123
void QStm_MaybeTapGestureRecogniser::setOwner(void* owner)
hgs
parents:
diff changeset
   124
{
hgs
parents:
diff changeset
   125
    m_powner = owner;
hgs
parents:
diff changeset
   126
}
hgs
parents:
diff changeset
   127
hgs
parents:
diff changeset
   128
hgs
parents:
diff changeset
   129
void QStm_MaybeTapGestureRecogniser::enable(bool enabled)
hgs
parents:
diff changeset
   130
{
hgs
parents:
diff changeset
   131
    m_gestureEnabled = enabled ;
hgs
parents:
diff changeset
   132
}
hgs
parents:
diff changeset
   133
hgs
parents:
diff changeset
   134
bool QStm_MaybeTapGestureRecogniser::isEnabled()
hgs
parents:
diff changeset
   135
{
hgs
parents:
diff changeset
   136
    return m_gestureEnabled ;
hgs
parents:
diff changeset
   137
}
hgs
parents:
diff changeset
   138
hgs
parents:
diff changeset
   139
void QStm_MaybeTapGestureRecogniser::setTapRange(int rangeInMillimetres)
hgs
parents:
diff changeset
   140
{
hgs
parents:
diff changeset
   141
    m_rangesizeInPixels = QStm_Utils::mm2Pixels(rangeInMillimetres) ;
hgs
parents:
diff changeset
   142
}
hgs
parents:
diff changeset
   143
hgs
parents:
diff changeset
   144
bool QStm_MaybeTapGestureRecogniser::isPointClose(const QPoint&  firstPoint, const QPoint& secondPoint)
hgs
parents:
diff changeset
   145
{
hgs
parents:
diff changeset
   146
    QRect tolerance = QStm_Utils::toleranceRectPx(secondPoint, m_rangesizeInPixels) ;
hgs
parents:
diff changeset
   147
    bool aretheyclose = tolerance.contains(firstPoint);
hgs
parents:
diff changeset
   148
    return aretheyclose ;
hgs
parents:
diff changeset
   149
}
hgs
parents:
diff changeset
   150
hgs
parents:
diff changeset
   151
void QStm_MaybeTapGestureRecogniser::addTapListener(QStm_GestureListenerIf* listener, void* listenerOwner)
hgs
parents:
diff changeset
   152
{
hgs
parents:
diff changeset
   153
    m_tapListeners.append(listener) ;
hgs
parents:
diff changeset
   154
    m_tapListenerWindows.append(listenerOwner) ;
hgs
parents:
diff changeset
   155
}
hgs
parents:
diff changeset
   156
hgs
parents:
diff changeset
   157
void QStm_MaybeTapGestureRecogniser::removeTapListener(QStm_GestureListenerIf* listener, void* /*listenerOwner*/)
hgs
parents:
diff changeset
   158
{
hgs
parents:
diff changeset
   159
    int inx = m_tapListeners.indexOf(listener) ;
hgs
parents:
diff changeset
   160
    if(inx != -1) {
hgs
parents:
diff changeset
   161
        m_tapListeners.removeAt(inx) ;
hgs
parents:
diff changeset
   162
        m_tapListenerWindows.removeAt(inx) ;
hgs
parents:
diff changeset
   163
    }
hgs
parents:
diff changeset
   164
}
hgs
parents:
diff changeset
   165