src/hbfeedback/player/hbfeedbackplayer_symbian.cpp
author Dremov Kirill (Nokia-D-MSW/Tampere) <kirill.dremov@nokia.com>
Mon, 19 Apr 2010 14:02:13 +0300
changeset 0 16d8024aca5e
child 1 f7ac710697a9
permissions -rw-r--r--
Revision: 201011 Kit: 201015

/****************************************************************************
**
** Copyright (C) 2008-2010 Nokia Corporation and/or its subsidiary(-ies).
** All rights reserved.
** Contact: Nokia Corporation (developer.feedback@nokia.com)
**
** This file is part of the HbFeedback module of the UI Extensions for Mobile.
**
** 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.
**
** If you have questions regarding the use of this file, please contact
** Nokia at developer.feedback@nokia.com.
**
****************************************************************************/

#include "hbfeedbackplayer_symbian_p.h"

#include <tacticon.h>
#include <touchfeedback.h>

#include <coecntrl.h>

#include <QList>
#include <QMap>
#include <QMapIterator>
#include <QDebug>

#include "hbinstantfeedback.h"
#include "hbcontinuousfeedback.h"
#include "hbtacticonfeedback.h"
#include "hbhitareafeedback.h"

/*!
    Symbian-specific feedback class that wraps Symbian feedback APIs.
*/

class HbFeedbackBasePlayerPrivate
{

public:
    HbFeedbackBasePlayerPrivate();
    ~HbFeedbackBasePlayerPrivate();

public:
    void init();
    inline int getNewIdentifier();
    inline TRect convertToSymbian(const QRect& rect);
    inline CCoeControl* convertToSymbian(QWidget* window);
    inline TTouchLogicalFeedback convertToSymbian(HbFeedback::InstantEffect effect);
    inline TTacticonType convertTacticonToSymbian(HbFeedback::InstantEffect effect);
    inline TTacticonType convertTacticonToSymbian(HbFeedback::TacticonEffect effect);
    inline TTouchContinuousFeedback convertToSymbian(HbFeedback::ContinuousEffect effect);
    inline TTouchEventType convertToSymbian(HbFeedback::HitAreaType hitAreaType);
			
public:
    MTouchFeedback *iFeedback;
    RTacticon iTacticon;
    TBool iTacticonReady;
    QMap <int, QWidget*> registeredHitAreas;
    QMap <int, QWidget*> ongoingContinuousFeedbacks;
    int slidingValue;
};

HbFeedbackBasePlayerPrivate::HbFeedbackBasePlayerPrivate() : slidingValue(0)
{
}

HbFeedbackBasePlayerPrivate::~HbFeedbackBasePlayerPrivate() {
    
    MTouchFeedback::DestroyInstance();
    registeredHitAreas.clear();
    iTacticon.Close();
    iTacticonReady = EFalse;
}

void HbFeedbackBasePlayerPrivate::init() {

    iFeedback = MTouchFeedback::Instance();
    if (!iFeedback) {
        TRAPD(err, iFeedback = MTouchFeedback::CreateInstanceL());
        if (err != KErrNone) {
            iFeedback = 0;
        }
    }
    TInt err = iTacticon.Connect();
    if(err) {
        iTacticonReady = EFalse;
    }
    else {
        iTacticonReady = ETrue;
    }
}

int HbFeedbackBasePlayerPrivate::getNewIdentifier() {
    
    slidingValue++;
    return slidingValue;
}


TRect HbFeedbackBasePlayerPrivate::convertToSymbian(const QRect& rect) {

    return TRect(rect.left(), rect.top(), rect.right(), rect.bottom());
}

TTouchLogicalFeedback HbFeedbackBasePlayerPrivate::convertToSymbian(HbFeedback::InstantEffect effect) {

    TTouchLogicalFeedback instantFeedbackSymbian = ETouchFeedbackBasic;
    
    switch (effect) {
    
    case HbFeedback::None:
        instantFeedbackSymbian = ETouchFeedbackNone;
        break;
    case HbFeedback::Basic:
        instantFeedbackSymbian = ETouchFeedbackBasic;
        break;
    case HbFeedback::Sensitive:
        instantFeedbackSymbian = ETouchFeedbackSensitive;
        break;
    case HbFeedback::BasicButton:
        instantFeedbackSymbian = ETouchFeedbackBasicButton;
        break;
    case HbFeedback::SensitiveButton:
        instantFeedbackSymbian = ETouchFeedbackSensitiveButton;
        break;
    case HbFeedback::BasicItem:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::SensitiveItem:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::BounceEffect:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::PopupOpen:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::PopupClose:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::BasicSlider:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::SensitiveSlider:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::StopFlick:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::Flick:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::Editor:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::TextSelection:
        instantFeedbackSymbian = ETouchFeedbackTextSelection;
        break;
    case HbFeedback::BlankSelection:
        instantFeedbackSymbian = ETouchFeedbackBlankSelection;
        break;
    case HbFeedback::LineSelection:
        instantFeedbackSymbian = ETouchFeedbackLineSelection;
        break;
    case HbFeedback::EmptyLineSelection:
        instantFeedbackSymbian = ETouchFeedbackEmptyLineSelection;
        break;
    case HbFeedback::Checkbox:
        instantFeedbackSymbian = ETouchFeedbackCheckbox;
        break;
    case HbFeedback::MultipleCheckbox:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::SensitiveKeypad:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::BasicKeypad:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::MultitouchActivate:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::RotateStep:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::ItemDrop:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::ItemMoveOver:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::ItemPick:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::ItemScroll:
        instantFeedbackSymbian = ETouchFeedbackBasic; // Effects changing in 10.1 are mapped to basic.
        break;
    case HbFeedback::PopUp:
        instantFeedbackSymbian = ETouchFeedbackPopUp;
        break;
    default:
        break;
    }
    return instantFeedbackSymbian;
}

TTacticonType HbFeedbackBasePlayerPrivate::convertTacticonToSymbian(HbFeedback::InstantEffect effect) {

    TTacticonType type = ENoTacticon;

    switch (effect) {

    case HbFeedback::PositiveTacticon:
        type = EPositiveTacticon;
        break;
    case HbFeedback::NeutralTacticon:
        type = ENeutralTacticon;
        break;
    case HbFeedback::NegativeTacticon:
        type = ENegativeTacticon;
        break;
    default:
        break;
    }
    return type;
}

TTacticonType HbFeedbackBasePlayerPrivate::convertTacticonToSymbian(HbFeedback::TacticonEffect effect) {

    TTacticonType type = ENoTacticon;
    
    switch (effect) {
    
    case HbFeedback::TacticonPositive:
        type = EPositiveTacticon;
        break;
    case HbFeedback::TacticonNeutral:
        type = ENeutralTacticon;
        break;
    case HbFeedback::TacticonNegative:
        type = ENegativeTacticon;
        break;
    default:
        break;
    }
    return type;
}

TTouchContinuousFeedback HbFeedbackBasePlayerPrivate::convertToSymbian(HbFeedback::ContinuousEffect effect) {

    TTouchContinuousFeedback continuousFeedbackSymbian = ETouchContinuousSmooth;
    
    switch (effect) {
        
    case HbFeedback::ContinuousSmooth:
        continuousFeedbackSymbian = ETouchContinuousSmooth;
        break;
    case HbFeedback::ContinuousSlider:
        continuousFeedbackSymbian = ETouchContinuousSlider;
        break;
    case HbFeedback::ContinuousInput:
        continuousFeedbackSymbian = ETouchContinuousInput;
        break;
    // Effects coming in 10.1 are mapped to smooth temporarily.
    case HbFeedback::ContinuousPopup:
        continuousFeedbackSymbian = ETouchContinuousSmooth;
        break;
    case HbFeedback::ContinuousPinch:
        continuousFeedbackSymbian = ETouchContinuousSmooth;
        break;
    default:
        break;
    }
    return continuousFeedbackSymbian;
}

TTouchEventType HbFeedbackBasePlayerPrivate::convertToSymbian(HbFeedback::HitAreaType hitAreaType) {

    TTouchEventType touchEventType = ETouchEventStylusDown;
    
    if ( hitAreaType == HbFeedback::MouseButtonPress ) {
            touchEventType = ETouchEventStylusDown;
    } else if (hitAreaType == HbFeedback::MouseButtonRelease ) {
        // ETouchEventStylusUp not yet supported
        touchEventType = ETouchEventStylusDown;
    }
    return touchEventType;
}


CCoeControl* HbFeedbackBasePlayerPrivate::convertToSymbian(QWidget* window) {

    CCoeControl* control = 0;
    
    if ( window && window->winId()) {
        control = reinterpret_cast<CCoeControl*>(window->winId());
    }
    return control;
}

HbFeedbackBasePlayer::HbFeedbackBasePlayer() : d(new HbFeedbackBasePlayerPrivate) {

    d->init();
}

HbFeedbackBasePlayer::~HbFeedbackBasePlayer() {

    removeHitAreas();
    cancelContinuousFeedbacks();
    delete d;
}

void HbFeedbackBasePlayer::removeHitAreas() {

    // remove hit areas
    QMapIterator<int, QWidget*> i(d->registeredHitAreas);

    while (i.hasNext()) {
        i.next();
        removeHitArea( i.key());
    }

    d->registeredHitAreas.clear();
}

void HbFeedbackBasePlayer::cancelContinuousFeedbacks() {

    // stop ongoing continuous feedbacks
    QMapIterator<int, QWidget*> i(d->ongoingContinuousFeedbacks);

    while (i.hasNext()) {
        i.next();
        cancelContinuousFeedback(i.key());
    }

    d->ongoingContinuousFeedbacks.clear();
}

void HbFeedbackBasePlayer::playInstantFeedback(const HbInstantFeedback& feedback) {

    if (d->iFeedback) {
        // If the effect is a tacticon, use the tacticon playing mechanism of the feedback player
        if (feedback.instantEffect() == HbFeedback::PositiveTacticon ||
            feedback.instantEffect() == HbFeedback::NeutralTacticon  ||
            feedback.instantEffect() == HbFeedback::NegativeTacticon) {
            if (d->iTacticonReady) {
                d->iTacticon.PlayTacticon(d->convertTacticonToSymbian(feedback.instantEffect()));
            }
        } else {
            CCoeControl* control = d->convertToSymbian(feedback.window());
            if (control) {
                d->iFeedback->InstantFeedback(control, d->convertToSymbian(feedback.instantEffect()));
            }
            else {
                d->iFeedback->InstantFeedback(d->convertToSymbian(feedback.instantEffect()));
            }
        }
    }
}

void HbFeedbackBasePlayer::playTacticonFeedback(const HbTacticonFeedback& feedback) {

    if (d->iTacticonReady) {
        d->iTacticon.PlayTacticon(d->convertTacticonToSymbian(feedback.tacticonEffect()));
    }
}

int HbFeedbackBasePlayer::startContinuousFeedback(const HbContinuousFeedback& feedback) {

    int identifier = -1;
    CCoeControl* control = d->convertToSymbian(feedback.window());
    
    if (d->iFeedback && control) {
        identifier = d->getNewIdentifier();
        if (feedback.continuousEffect() != HbFeedback::ContinuousNone) {
            d->iFeedback->StartFeedback(control, d->convertToSymbian(feedback.continuousEffect()),
                                        0, feedback.intensity(),
                                        1000*feedback.timeout());
        }
        d->ongoingContinuousFeedbacks.insert(identifier, feedback.window());
    }
    return identifier;
}

void HbFeedbackBasePlayer::updateContinuousFeedback(int identifier, const HbContinuousFeedback& feedback) {

    CCoeControl* control = d->convertToSymbian(feedback.window());

    if (d->iFeedback && control) {
        if (d->ongoingContinuousFeedbacks.contains(identifier)) {
            CCoeControl* storedControl = d->convertToSymbian(d->ongoingContinuousFeedbacks[identifier]);
            if (storedControl == control) {
                if (feedback.continuousEffect() != HbFeedback::ContinuousNone) {
                    d->iFeedback->StartFeedback( storedControl,
                                                d->convertToSymbian(feedback.continuousEffect()),
                                                0, feedback.intensity(),
                                                1000*feedback.timeout());
                } else {
                    d->iFeedback->StopFeedback(storedControl);
                }
            }
        }
    }
}

void HbFeedbackBasePlayer::cancelContinuousFeedback(int identifier) {

    if (d->iFeedback) {
        if (d->ongoingContinuousFeedbacks.contains(identifier)) {
            d->iFeedback->StopFeedback(d->convertToSymbian(d->ongoingContinuousFeedbacks[identifier]));
            d->ongoingContinuousFeedbacks.remove(identifier);
        }
    }
}

bool HbFeedbackBasePlayer::continuousFeedbackOngoing(int identifier) {

    bool feedbackOngoing(false);
    if (d->ongoingContinuousFeedbacks.contains(identifier)) {
        feedbackOngoing = true;
    }
    return feedbackOngoing;
}

int HbFeedbackBasePlayer::insertHitArea(const HbHitAreaFeedback& feedback) {

    int identifier = -1;
    CCoeControl* control = d->convertToSymbian(feedback.window());
    if (d->iFeedback && control) {
        identifier = d->getNewIdentifier();
        TTouchLogicalFeedback logicalFeedback = d->convertToSymbian(feedback.instantEffect());
        // current hit area implementation below does not yet support new logical feedbacks
        if (logicalFeedback > ETouchFeedbackSensitive) {
            logicalFeedback = ETouchFeedbackSensitive;
        }

        int errorValue = d->iFeedback->SetFeedbackArea(control, identifier,
                         d->convertToSymbian(feedback.rect()),
                         logicalFeedback,
                         d->convertToSymbian(feedback.hitAreaType()));
        if (errorValue >= 0) {
            // no error
            d->registeredHitAreas.insert(identifier, feedback.window());
        }
    }
    return identifier;
}

void HbFeedbackBasePlayer::updateHitArea(int identifier, const HbHitAreaFeedback& feedback) {

    CCoeControl* control = d->convertToSymbian(feedback.window());

    if (d->iFeedback && control && d->registeredHitAreas.contains(identifier)) {
        CCoeControl* storedControl = d->convertToSymbian(d->registeredHitAreas[identifier]);
        if (storedControl == control) {
            d->iFeedback->ChangeFeedbackArea(storedControl, identifier, d->convertToSymbian(feedback.rect()));
        }
    }
}

void HbFeedbackBasePlayer::removeHitArea(int identifier) {

    if (d->iFeedback && d->registeredHitAreas.contains(identifier)) {
        CCoeControl* storedControl = d->convertToSymbian(d->registeredHitAreas[identifier]);
        d->iFeedback->RemoveFeedbackArea(storedControl, identifier);
        d->registeredHitAreas.remove(identifier);
    }
}

bool HbFeedbackBasePlayer::hitAreaExists(int identifier) {

    return d->registeredHitAreas.contains(identifier);
}