emailuis/nmailui/src/nmuieffects.cpp
author hgs
Fri, 28 May 2010 13:56:43 +0300
changeset 43 99bcbff212ad
parent 23 2dc6caa42ec3
child 47 f83bd4ae1fe3
permissions -rw-r--r--
201021

/*
* Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description: Graphical effects/animations for nmail ui.
*
*/

#include "nmuiheaders.h"

static const char *SendAnimation = ":/effects/mail_send.fxml";

/*!
    \class NmEffects
    \brief This class is for launching the effects
*/

/*!
    Constructor
*/
NmUiEffects::NmUiEffects(HbMainWindow &mainWindow) :
    mMainWindow(mainWindow),
    mSendAnimationScreenShot(NULL),
    mDoSendAnimation(false)
{
    NM_FUNCTION;
}

/*!
    Destructor
*/
NmUiEffects::~NmUiEffects()
{
    NM_FUNCTION;
    
    // Clean send animation if sendAnimationComplete slot is not called for some reason.
    // E.g. red key pressed.
    resetSendAnimation();
}

/*!
    Function will perform needed initializations for selected effect.
*/
void NmUiEffects::prepareEffect(NmUiEffectType effect)
{
    NM_FUNCTION;
    
    switch (effect) {
    case NmEditorSendMessageAnimation:
        // delete any existing stuff
        resetSendAnimation();
        
        // This effect is for editor send message. Get the screen capture of
        // editor view for animation which will be lauched soon.
        mDoSendAnimation = true;

        // take screen shot
        mSendAnimationScreenShot = screenShot();
        
        // Create graphics item based pixmap image but don't show it yet.
        mSendAnimationScreenShot->hide();
        mSendAnimationScreenShot->setPos(0,0);
        mSendAnimationScreenShot->setZValue(0);

        // Adds or moves the item and all its childen to this scene.
        // This scene takes ownership of the item.
        mMainWindow.scene()->addItem(mSendAnimationScreenShot);

        // Set editor screen capture visible before old view is popped.
        // New view is drawn under this image.
        mSendAnimationScreenShot->show();

        HbEffect::add(mSendAnimationScreenShot, SendAnimation, "mail_send");
        break;
    }
}

/*!
    Function will start the selected effect.
*/
void NmUiEffects::startEffect(NmUiEffectType effect)
{
    NM_FUNCTION;
    
    switch (effect) {
    case NmEditorSendMessageAnimation:
        // Send message animation for editor view.
        if (mDoSendAnimation && mSendAnimationScreenShot) {
            mDoSendAnimation = false;
            // Start animation and connect completion signal to sendAnimationComplete slot.
            HbEffect::start(mSendAnimationScreenShot, "mail_send", this, "sendAnimationComplete");
        }
        break;
    }
}

/*!
   Generates a screenshot of the current screen. Picture is rotated
   according to the main window orientation.
 */
QGraphicsPixmapItem *NmUiEffects::screenShot()
{
    NM_FUNCTION;
    
    // Grab whole view into pixmap image (also chrome is included)
    QPixmap screenCapture = QPixmap::grabWindow(mMainWindow.internalWinId());

    QGraphicsPixmapItem *ret = NULL;
    
    // for landscape, the screenshot must be rotated
    if(mMainWindow.orientation() == Qt::Horizontal) {
        QMatrix mat;
        mat.rotate(-90); // rotate 90 degrees counter-clockwise
        ret = new QGraphicsPixmapItem(screenCapture.transformed(mat));
    }
    else {
        ret = new QGraphicsPixmapItem(screenCapture);
    }
    
    return ret;    
}

/*!
   Clean up for send animation
 */
void NmUiEffects::resetSendAnimation()
{
    NM_FUNCTION;
    
    if (mSendAnimationScreenShot) {
        // Clean send animation
        HbEffect::remove(mSendAnimationScreenShot, SendAnimation, "mail_send");
        // Ownership of QGraphicsPixmapItem is tranferred to GraphicsScene when it has been added
        // to it GraphicsScene.
        // GraphicsPixmapItem needs to be removed from the GraphicsScene before deleting
        // it to prevent double deletion.
        mMainWindow.scene()->removeItem(mSendAnimationScreenShot);
        delete mSendAnimationScreenShot;
        mSendAnimationScreenShot = NULL;
        mDoSendAnimation = false;
    }
}

/*!
    Slot is called when send message animation for editor view has been completed.
*/
void NmUiEffects::sendAnimationComplete(HbEffect::EffectStatus status)
{
    NM_FUNCTION;
    
    Q_UNUSED(status);
    resetSendAnimation();
}