homescreenapp/hsutils/src/hssnapline.cpp
author hgs
Fri, 25 Jun 2010 19:19:22 +0300
changeset 62 341166945d65
child 69 87476091b3f5
permissions -rw-r--r--
201025
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
62
hgs
parents:
diff changeset
     1
/*
hgs
parents:
diff changeset
     2
* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
hgs
parents:
diff changeset
     3
* All rights reserved.
hgs
parents:
diff changeset
     4
* This component and the accompanying materials are made available
hgs
parents:
diff changeset
     5
* under the terms of "Eclipse Public License v1.0"
hgs
parents:
diff changeset
     6
* which accompanies this distribution, and is available
hgs
parents:
diff changeset
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
hgs
parents:
diff changeset
     8
*
hgs
parents:
diff changeset
     9
* Initial Contributors:
hgs
parents:
diff changeset
    10
* Nokia Corporation - initial contribution.
hgs
parents:
diff changeset
    11
*
hgs
parents:
diff changeset
    12
* Contributors:
hgs
parents:
diff changeset
    13
*
hgs
parents:
diff changeset
    14
* Description:
hgs
parents:
diff changeset
    15
*
hgs
parents:
diff changeset
    16
*/
hgs
parents:
diff changeset
    17
hgs
parents:
diff changeset
    18
#include <QGraphicsOpacityEffect>
hgs
parents:
diff changeset
    19
#include <QPropertyAnimation>
hgs
parents:
diff changeset
    20
hgs
parents:
diff changeset
    21
#include "hsapp_defs.h"
hgs
parents:
diff changeset
    22
#include "HsSnapLine.h"
hgs
parents:
diff changeset
    23
hgs
parents:
diff changeset
    24
/*!
hgs
parents:
diff changeset
    25
    Constructor.
hgs
parents:
diff changeset
    26
    
hgs
parents:
diff changeset
    27
    \a parent Owner.
hgs
parents:
diff changeset
    28
*/
hgs
parents:
diff changeset
    29
HsSnapLine::HsSnapLine(QGraphicsItem *parent)
hgs
parents:
diff changeset
    30
  : QGraphicsLineItem(parent),
hgs
parents:
diff changeset
    31
    mFadeInAnimation(0),
hgs
parents:
diff changeset
    32
    mFadeOutAnimation(0),
hgs
parents:
diff changeset
    33
    mOpacity(0.0),
hgs
parents:
diff changeset
    34
    mFadeInAnimationDuration(0),
hgs
parents:
diff changeset
    35
    mFadeOutAnimationDuration(0)
hgs
parents:
diff changeset
    36
{
hgs
parents:
diff changeset
    37
    QGraphicsOpacityEffect *effect = new QGraphicsOpacityEffect(this);
hgs
parents:
diff changeset
    38
    effect->setOpacity(0.0);
hgs
parents:
diff changeset
    39
    effect->setEnabled(false);
hgs
parents:
diff changeset
    40
    setGraphicsEffect(effect);
hgs
parents:
diff changeset
    41
hgs
parents:
diff changeset
    42
    mFadeInAnimation = new QPropertyAnimation(graphicsEffect(), "opacity", this);
hgs
parents:
diff changeset
    43
    connect(mFadeInAnimation, SIGNAL(finished()), SLOT(fadeInAnimationFinished()));
hgs
parents:
diff changeset
    44
hgs
parents:
diff changeset
    45
    mFadeOutAnimation = new QPropertyAnimation(graphicsEffect(), "opacity", this);
hgs
parents:
diff changeset
    46
    connect(mFadeOutAnimation, SIGNAL(finished()), SLOT(fadeOutAnimationFinished()));
hgs
parents:
diff changeset
    47
hgs
parents:
diff changeset
    48
    QPen pen;
hgs
parents:
diff changeset
    49
    pen.setWidth(3);
hgs
parents:
diff changeset
    50
    pen.setColor(Qt::darkCyan); //TODO: Change the color to the Theme element
hgs
parents:
diff changeset
    51
    setPen(pen);
hgs
parents:
diff changeset
    52
}
hgs
parents:
diff changeset
    53
 
hgs
parents:
diff changeset
    54
/*!
hgs
parents:
diff changeset
    55
    Destructor.
hgs
parents:
diff changeset
    56
*/
hgs
parents:
diff changeset
    57
HsSnapLine::~HsSnapLine()
hgs
parents:
diff changeset
    58
{
hgs
parents:
diff changeset
    59
}
hgs
parents:
diff changeset
    60
hgs
parents:
diff changeset
    61
/*!
hgs
parents:
diff changeset
    62
    Sets the configuration for the showing the snap line, it includes fade-in / fade-out timeout.
hgs
parents:
diff changeset
    63
*/
hgs
parents:
diff changeset
    64
void HsSnapLine::setConfiguration(const QVariantHash &configuration)
hgs
parents:
diff changeset
    65
{
hgs
parents:
diff changeset
    66
    bool canConvert = false;
hgs
parents:
diff changeset
    67
    //The following values should be in int, so the status received in canConvert is ignored
hgs
parents:
diff changeset
    68
    mFadeInAnimationDuration = configuration[SNAPLINEFADEINDURATION].toInt(&canConvert);
hgs
parents:
diff changeset
    69
    mFadeOutAnimationDuration = configuration[SNAPLINEFADEOUTDURATION].toInt(&canConvert);
hgs
parents:
diff changeset
    70
}
hgs
parents:
diff changeset
    71
hgs
parents:
diff changeset
    72
/*!
hgs
parents:
diff changeset
    73
    Show the snap line. fade-in animation is started on the line if the line is positioned at a different place.
hgs
parents:
diff changeset
    74
    Before starting the fade-in animation, the fade-out animation is stoped if it is running.
hgs
parents:
diff changeset
    75
*/
hgs
parents:
diff changeset
    76
void HsSnapLine::showLine(const QLineF &snapLine)
hgs
parents:
diff changeset
    77
{
hgs
parents:
diff changeset
    78
    QLineF displayLine = snapLine;
hgs
parents:
diff changeset
    79
    qreal angle = displayLine.angle();
hgs
parents:
diff changeset
    80
    if (qAbs(angle) == 0.0 || qAbs(angle) == 180.0) { //this is a horizontal line
hgs
parents:
diff changeset
    81
        //adding 1 is required below, as the line is 3 pixels wide and is translated by 1 point before displaying
hgs
parents:
diff changeset
    82
        if (displayLine.y1() != (line().y1()+1.0) ) { //this horizontal line is at new position horizontally
hgs
parents:
diff changeset
    83
            if (isFadeOutAnimationRunning()) { //if fade-out animation is running, stop it, animation is running at old position
hgs
parents:
diff changeset
    84
                stopFadeOutAnimation();
hgs
parents:
diff changeset
    85
            }
hgs
parents:
diff changeset
    86
            //start fade-in animation at new position.
hgs
parents:
diff changeset
    87
            startFadeInAnimation();
hgs
parents:
diff changeset
    88
        }
hgs
parents:
diff changeset
    89
        else { //this horizontal line is at the old position horizontally
hgs
parents:
diff changeset
    90
            if (isFadeOutAnimationRunning()) { //if fade-out animation is running, stop it, animation is running at old position
hgs
parents:
diff changeset
    91
                stopFadeOutAnimation();
hgs
parents:
diff changeset
    92
                //start fade-in animation at the old position
hgs
parents:
diff changeset
    93
                startFadeInAnimation();
hgs
parents:
diff changeset
    94
            }
hgs
parents:
diff changeset
    95
        }
hgs
parents:
diff changeset
    96
        displayLine.translate(0.0, -1.0);
hgs
parents:
diff changeset
    97
    }
hgs
parents:
diff changeset
    98
    if (qAbs(angle) == 90.0 || qAbs(angle) == 270.0) { //this is a vertical line
hgs
parents:
diff changeset
    99
        if (displayLine.x1() != (line().x1()+1)) { //this Vertical line is at different position vertically
hgs
parents:
diff changeset
   100
            if (isFadeOutAnimationRunning()) {
hgs
parents:
diff changeset
   101
                stopFadeOutAnimation();
hgs
parents:
diff changeset
   102
            }
hgs
parents:
diff changeset
   103
            startFadeInAnimation();
hgs
parents:
diff changeset
   104
        }
hgs
parents:
diff changeset
   105
        else {
hgs
parents:
diff changeset
   106
            if (isFadeOutAnimationRunning()) {
hgs
parents:
diff changeset
   107
                stopFadeOutAnimation();
hgs
parents:
diff changeset
   108
                startFadeInAnimation();
hgs
parents:
diff changeset
   109
            }
hgs
parents:
diff changeset
   110
        }
hgs
parents:
diff changeset
   111
        displayLine.translate(-1.0, 0.0);
hgs
parents:
diff changeset
   112
    }
hgs
parents:
diff changeset
   113
hgs
parents:
diff changeset
   114
    setLine(displayLine);
hgs
parents:
diff changeset
   115
    show();
hgs
parents:
diff changeset
   116
}
hgs
parents:
diff changeset
   117
hgs
parents:
diff changeset
   118
/*!
hgs
parents:
diff changeset
   119
    Hide the snap line. Fade-out animation is started on the line to be hidden.
hgs
parents:
diff changeset
   120
    If fade-in animation is running, it is stoped before starting the fade-out animation.
hgs
parents:
diff changeset
   121
*/
hgs
parents:
diff changeset
   122
void HsSnapLine::hideLine()
hgs
parents:
diff changeset
   123
{
hgs
parents:
diff changeset
   124
    if (isFadeInAnimationRunning()) {
hgs
parents:
diff changeset
   125
        stopFadeInAnimation();
hgs
parents:
diff changeset
   126
    }
hgs
parents:
diff changeset
   127
    startFadeOutAnimation();
hgs
parents:
diff changeset
   128
}
hgs
parents:
diff changeset
   129
hgs
parents:
diff changeset
   130
/*!
hgs
parents:
diff changeset
   131
    Start fade-in animation.
hgs
parents:
diff changeset
   132
*/
hgs
parents:
diff changeset
   133
void HsSnapLine::startFadeInAnimation()
hgs
parents:
diff changeset
   134
{
hgs
parents:
diff changeset
   135
    mFadeInAnimation->setStartValue(mOpacity);
hgs
parents:
diff changeset
   136
    mFadeInAnimation->setEndValue(1.0);
hgs
parents:
diff changeset
   137
    mFadeInAnimation->setDuration(getFadeInDuration());
hgs
parents:
diff changeset
   138
hgs
parents:
diff changeset
   139
    graphicsEffect()->setEnabled(true);
hgs
parents:
diff changeset
   140
    mFadeInAnimation->start();
hgs
parents:
diff changeset
   141
}
hgs
parents:
diff changeset
   142
hgs
parents:
diff changeset
   143
/*!
hgs
parents:
diff changeset
   144
    Check if fade-in animation is running.
hgs
parents:
diff changeset
   145
*/
hgs
parents:
diff changeset
   146
bool HsSnapLine::isFadeInAnimationRunning() const
hgs
parents:
diff changeset
   147
{
hgs
parents:
diff changeset
   148
    return mFadeInAnimation->state() == QAbstractAnimation::Running;
hgs
parents:
diff changeset
   149
}
hgs
parents:
diff changeset
   150
hgs
parents:
diff changeset
   151
/*!
hgs
parents:
diff changeset
   152
    Stop the fade-in animation.
hgs
parents:
diff changeset
   153
*/
hgs
parents:
diff changeset
   154
void HsSnapLine::stopFadeInAnimation()
hgs
parents:
diff changeset
   155
{
hgs
parents:
diff changeset
   156
    mFadeInAnimation->stop();
hgs
parents:
diff changeset
   157
    actionOnFadeInAnimationStop();
hgs
parents:
diff changeset
   158
}
hgs
parents:
diff changeset
   159
hgs
parents:
diff changeset
   160
/*!
hgs
parents:
diff changeset
   161
    SLOT called when fade-in animation is finished / reaches it's end.
hgs
parents:
diff changeset
   162
*/
hgs
parents:
diff changeset
   163
void HsSnapLine::fadeInAnimationFinished()
hgs
parents:
diff changeset
   164
{
hgs
parents:
diff changeset
   165
    actionOnFadeInAnimationStop();
hgs
parents:
diff changeset
   166
}
hgs
parents:
diff changeset
   167
hgs
parents:
diff changeset
   168
/*!
hgs
parents:
diff changeset
   169
    Action when fade-in animation stops running.
hgs
parents:
diff changeset
   170
*/
hgs
parents:
diff changeset
   171
void HsSnapLine::actionOnFadeInAnimationStop()
hgs
parents:
diff changeset
   172
{
hgs
parents:
diff changeset
   173
    mOpacity = mFadeInAnimation->currentValue().toDouble();
hgs
parents:
diff changeset
   174
    graphicsEffect()->setEnabled(false);
hgs
parents:
diff changeset
   175
}
hgs
parents:
diff changeset
   176
hgs
parents:
diff changeset
   177
/*!
hgs
parents:
diff changeset
   178
    Start fade-out animation.
hgs
parents:
diff changeset
   179
*/
hgs
parents:
diff changeset
   180
void HsSnapLine::startFadeOutAnimation()
hgs
parents:
diff changeset
   181
{
hgs
parents:
diff changeset
   182
    mFadeOutAnimation->setStartValue(mOpacity);
hgs
parents:
diff changeset
   183
    mFadeOutAnimation->setEndValue(0.0);
hgs
parents:
diff changeset
   184
    mFadeOutAnimation->setDuration(getFadeOutDuration());
hgs
parents:
diff changeset
   185
hgs
parents:
diff changeset
   186
    graphicsEffect()->setEnabled(true);
hgs
parents:
diff changeset
   187
    mFadeOutAnimation->start();
hgs
parents:
diff changeset
   188
}
hgs
parents:
diff changeset
   189
hgs
parents:
diff changeset
   190
/*!
hgs
parents:
diff changeset
   191
    Check if fade-out animation is running.
hgs
parents:
diff changeset
   192
*/
hgs
parents:
diff changeset
   193
bool HsSnapLine::isFadeOutAnimationRunning() const
hgs
parents:
diff changeset
   194
{
hgs
parents:
diff changeset
   195
    return mFadeOutAnimation->state() == QAbstractAnimation::Running;
hgs
parents:
diff changeset
   196
}
hgs
parents:
diff changeset
   197
hgs
parents:
diff changeset
   198
/*!
hgs
parents:
diff changeset
   199
    Stop the fade-out animation.
hgs
parents:
diff changeset
   200
*/
hgs
parents:
diff changeset
   201
void HsSnapLine::stopFadeOutAnimation()
hgs
parents:
diff changeset
   202
{
hgs
parents:
diff changeset
   203
    mFadeOutAnimation->stop();
hgs
parents:
diff changeset
   204
    actionOnFadeOutAnimationStop();
hgs
parents:
diff changeset
   205
}
hgs
parents:
diff changeset
   206
hgs
parents:
diff changeset
   207
/*!
hgs
parents:
diff changeset
   208
    SLOT called when fade-out animation is finished / reaches it's end.
hgs
parents:
diff changeset
   209
*/
hgs
parents:
diff changeset
   210
void HsSnapLine::fadeOutAnimationFinished()
hgs
parents:
diff changeset
   211
{
hgs
parents:
diff changeset
   212
    actionOnFadeOutAnimationStop();
hgs
parents:
diff changeset
   213
}
hgs
parents:
diff changeset
   214
hgs
parents:
diff changeset
   215
/*!
hgs
parents:
diff changeset
   216
    Action when fade-out animation stops running.
hgs
parents:
diff changeset
   217
*/
hgs
parents:
diff changeset
   218
void HsSnapLine::actionOnFadeOutAnimationStop()
hgs
parents:
diff changeset
   219
{
hgs
parents:
diff changeset
   220
    mOpacity = mFadeOutAnimation->currentValue().toDouble();
hgs
parents:
diff changeset
   221
    graphicsEffect()->setEnabled(false);
hgs
parents:
diff changeset
   222
    hide();
hgs
parents:
diff changeset
   223
    setLine(QLineF());
hgs
parents:
diff changeset
   224
}