src/hbcore/effects/hbeffectscale.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 HbCore 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 "hbeffectscale_p.h"
#include "hbeffectanimation_p.h"
#include "hbeffectutils_p.h"
#include "hbeffectgroup_p.h"
#include "hbeffectscaleanimation_p.h"
#include "hbeffectdef_p.h"
#include <QGraphicsItem>
#include <QtDebug>
#include <QVariantAnimation>

HbEffectScaleAnimation::HbEffectScaleAnimation(
    HbEffectGroup *group,
    HbEffectScale *effect,
    int duration ) :
        HbEffectAnimation(),
        mGroup(group),
        mEffect(effect),
        mCenter(0),
        mCurrentScaling(1.0)
{
    setDuration(duration);
}

void HbEffectScaleAnimation::setCenter(qreal center)
{
    mCenter = center;
}

void HbEffectScaleAnimation::handleAnimationUpdate(const QVariant &value)
{
    if (mGroup->isRunning()) {
        mCurrentScaling = qVariantValue<qreal>(value);
        // Prevent negative scale factors, they crash QT.
        if (mCurrentScaling < 0) {
            mCurrentScaling = 0;
        }
        mGroup->updateItemTransform();
    }
}

void HbEffectScaleAnimation::handleAnimationFinish()
{
    // This informs the effect group when both scale_x and scale_y have finished
    mEffect->handleAnimationFinished();
}

// -----------------------------------------------------------------------------

// HbEffectScale

HbEffectScale::HbEffectScale(
    const QList<HbEffectFxmlParamData> &data,
    QGraphicsItem *item,
    HbEffectGroup *group) :
        HbEffectAbstract(0, item, group),
        mAnimationX(0),
        mAnimationY(0)
{
    int durationX = 0;
    int durationY = 0;
    QEasingCurve curveX = QEasingCurve::Linear;
    QEasingCurve curveY = QEasingCurve::Linear;

    // Default values if not defined in the data. Value 1.0f means the item's "identity" i.e. its normal size.
    mStartXValue = 1.0f;
    mEndXValue = 1.0f;
    mStartYValue = 1.0f;
    mEndYValue = 1.0f;
    mCenterXValue = 0;
    mCenterYValue = 0;

    const HbEffectFxmlParamData* paramX = 0;
    const HbEffectFxmlParamData* paramY = 0;

    Q_FOREACH(const HbEffectFxmlParamData &param, data) {
	    if (param.name() == FXML_KEYWORD_SCALE_X) {
            mKeyFrameListX = param.keyFrames();
			// <start> for scale_x
			mStartWidth =  param.getAttribute(FXML_KEYWORD_START);
			mStartWidthRef = param.startRef();
			// <end> for scale_x
			mEndWidth = param.getAttribute(FXML_KEYWORD_END);
			mEndWidthRef = param.endRef();
			// duration and curvepath
            HbEffectUtils::resolveFxmlDuration(durationX, param);
            HbEffectUtils::resolveFxmlCurveShape(curveX, param);

            // Only if "start ref" and "end ref" are not used, read parameter's "ref" attribute
            if (mStartWidthRef.isEmpty() && mEndWidthRef.isEmpty()) {
                mParamRefX = param.getAttribute(FXML_PARAM_REF);
            }

            paramX = &param;
	    }
	    else if (param.name() == FXML_KEYWORD_SCALE_Y) {
            mKeyFrameListY = param.keyFrames();
			// <start> for scale_y
			mStartHeight =  param.getAttribute(FXML_KEYWORD_START);
			mStartHeightRef = param.startRef();
			// <end> for scale_y
			mEndHeight = param.getAttribute(FXML_KEYWORD_END);
			mEndHeightRef = param.endRef();
            HbEffectUtils::resolveFxmlDuration(durationY, param);
            HbEffectUtils::resolveFxmlCurveShape(curveY, param);

            // Only if "start ref" and "end ref" are not used, read parameter's "ref" attribute
            if (mStartHeightRef.isEmpty() && mEndHeightRef.isEmpty()) {
                mParamRefY = param.getAttribute(FXML_PARAM_REF);
            }

            paramY = &param;
	    }
	    else if (param.name() == FXML_KEYWORD_SCALE_ORIGIN_X) {
            mCenterX = param.getValue();
            mCenterXRef = param.getAttribute(FXML_PARAM_REF);
        }                        
	    else if (param.name() == FXML_KEYWORD_SCALE_ORIGIN_Y) {
            mCenterY = param.getValue();
            mCenterYRef = param.getAttribute(FXML_PARAM_REF);
	    }
    }

    // Validate references. If start and end references are used, at least one of them must be a visual reference.
    if ((mStartWidthRef.isEmpty() || mStartWidthRef.startsWith(FXML_VISUAL) ||
         mEndWidthRef.isEmpty() || mEndWidthRef.startsWith(FXML_VISUAL)) &&
        (mStartHeightRef.isEmpty() || mStartHeightRef.startsWith(FXML_VISUAL) ||
         mEndHeightRef.isEmpty() || mEndHeightRef.startsWith(FXML_VISUAL))) {
        // references ok
    } else {
        // Invalid references - disable effect
        durationX = 0;
        durationY = 0;

        mParamRefX.clear();
        mStartWidthRef.clear();
        mStartWidth.clear();
        mEndWidthRef.clear();
        mEndWidth.clear();

        mParamRefY.clear();
        mStartHeightRef.clear();
        mStartHeight.clear();
        mEndHeightRef.clear();
        mEndHeight.clear();

        mCenterX.clear();
        mCenterXRef.clear();
        mCenterY.clear();
        mCenterYRef.clear();
    }

    if (durationX > 0) {
        mAnimationX = new HbEffectScaleAnimation(group, this, durationX);
        mAnimationX->addLooping(paramX, group);
        mAnimationX->mCurve = curveX;
    }
    // Create at least one animation even if both durations are zero for handling animation finish easily.
    if (durationY > 0 || !mAnimationX) {
        mAnimationY = new HbEffectScaleAnimation(group, this, durationY);
        mAnimationY->addLooping(paramY, group);
        mAnimationY->mCurve = curveY;
    }
}


/* deletes the effect and rewinds the animation so that next animation can star,
    rewind is necessary as the general use case is that the effect is restarted before 
    being complete, in which case the rewind would transform the item and prepare for
    the next effect.
*/
HbEffectScale::~HbEffectScale()
{
    if (mAnimationX) {
        mAnimationX->stop();
        // Applying the cancel policy so that if dynamically new effect is started HbEffect::start then this finishes
        // and the new one starts.
        // This will set the endstate for the object correctly when destroying effect
        delete mAnimationX;
    }
    if (mAnimationY) {
        mAnimationY->stop();
        delete mAnimationY;
    }
}

QString HbEffectScale::name() const
{
    return HB_EFFECT_NAME_SCALE;
}

void HbEffectScale::init()
{
    QSizeF orgSize = item()->boundingRect().size();

    // Resolve Dynamic attributes at this point
    bool valueOk;
    qreal value;

    const QRectF &extRect = group()->extRect();

    // start width
    if (!mStartWidth.isEmpty()) {
        value = HbEffectUtils::resolveFxmlRef(
            mStartWidthRef, mStartWidth, &valueOk, item(), HbEffectUtils::Size, extRect);
        if (valueOk) {
            mStartXValue = value;
        }
    }
    // start height
    if (!mStartHeight.isEmpty()) {
        value = HbEffectUtils::resolveFxmlRef(mStartHeightRef, mStartHeight, &valueOk, item(), HbEffectUtils::Size, extRect);
        if (valueOk) {
            mStartYValue = value;
        }
    }

    // end width
    if (!mEndWidth.isEmpty()) {
        value = HbEffectUtils::resolveFxmlRef(
            mEndWidthRef, mEndWidth, &valueOk, item(), HbEffectUtils::Size, extRect);

        if (valueOk) {
            mEndXValue = value;
        }
    }
    // end height
    if (!mEndHeight.isEmpty()) {
        value = HbEffectUtils::resolveFxmlRef(
            mEndHeightRef, mEndHeight, &valueOk, item(), HbEffectUtils::Size, extRect);

        if (valueOk) {
            mEndYValue = value;
        }
    }

    // CenterX
    value = HbEffectUtils::resolveFxmlRef(
        mCenterXRef, mCenterX, &valueOk, item(), HbEffectUtils::CenterMappedToTargetRect, extRect);
    
    if (valueOk) {
        mCenterXValue = value;
    }
    // CenterY
    value = HbEffectUtils::resolveFxmlRef(
        mCenterYRef, mCenterY, &valueOk, item(), HbEffectUtils::CenterMappedToTargetRect, extRect);

    if (valueOk) {
        mCenterYValue = value;
    }

    // QT's scale animations do not handle 0 value correctly so change it here.
    if (HbEffectUtils::fuzzyIsNull(mStartXValue)) {
        mStartXValue = 0.00002;
    }
    if (HbEffectUtils::fuzzyIsNull(mStartYValue)) {
        mStartYValue = 0.00002;
    }
    if (HbEffectUtils::fuzzyIsNull(mEndXValue)) {
        mEndXValue = 0.00002;
    }
    if (HbEffectUtils::fuzzyIsNull(mEndYValue)) {
        mEndYValue = 0.00002;
    }

    if (mAnimationX) {
        // Start and end values are relative to item's size so value 1 means normal size
        mAnimationX->setStartValue(QVariant(mStartXValue));
        mAnimationX->setEndValue(QVariant(mEndXValue));
        // Center value is in pixels
        mAnimationX->setCenter(mCenterXValue);

        bool startEndRefUsed = !mStartWidthRef.isEmpty() && !mEndWidthRef.isEmpty();

        qreal paramRefValueX = 0.0;
        
        // Resolve SCALE_X parameter's "ref" value only if that's needed
        if (!startEndRefUsed) {
            paramRefValueX = HbEffectUtils::resolveFxmlRef(
                mParamRefX, "1", &valueOk, item(), HbEffectUtils::Size, extRect);
        }

        // Set keyframes in animation
        foreach(const HbKeyFrame &kf, mKeyFrameListX) {

            // If start and end references are used,
            // value at given step is (1-c)*startX + c*endX where c is the keyframe coefficient value
            if (startEndRefUsed) {
                value = (1 - kf.val) * mStartXValue + kf.val * mEndXValue;
            }
            // Otherwise c defines the value
            else {
                value = kf.val;
                // Multiply keyframe's value with parameter's "ref" if it is defined
                if (valueOk) {
                    value *= paramRefValueX;
                }
            }

            mAnimationX->setKeyValueAt(kf.pos, QVariant(value));

            // Update also stored start and end values if keyframe refers to those
            if (HbEffectUtils::fuzzyIsNull(kf.pos)) {
                mStartXValue = value;
            } else if (HbEffectUtils::fuzzyIsOneOrGreater(kf.pos)) {
                mEndXValue = value;
            }
        }
    }
    if (mAnimationY) {
        // Start and end values are relative to item's size so value 1 means normal size
        mAnimationY->setStartValue(QVariant(mStartYValue));
        mAnimationY->setEndValue(QVariant(mEndYValue));
        // Center value is in pixels
        mAnimationY->setCenter(mCenterYValue);

        bool startEndRefUsed = !mStartHeightRef.isEmpty() && !mEndHeightRef.isEmpty();

        qreal paramRefValueY = 0.0;
        // Resolve SCALE_Y parameter's "ref" value only if that's needed
        if (!startEndRefUsed) {
            paramRefValueY = HbEffectUtils::resolveFxmlRef(
                mParamRefY, "1", &valueOk, item(), HbEffectUtils::Size, extRect);
        }

        // Set keyframes in animation
        foreach(const HbKeyFrame &kf, mKeyFrameListY) {
            // If start and end references are used,
            // value at given step is (1-c)*startY + c*endY where c is the keyframe coefficient value
            if (startEndRefUsed) {
                value = (1 - kf.val) * mStartYValue + kf.val * mEndYValue;
            }
            // Otherwise c defines the value
            else {
                value = kf.val;
                // Multiply keyframe's value with parameter's "ref" if it is defined
                if (valueOk) {
                    value *= paramRefValueY;
                }
            }

            mAnimationY->setKeyValueAt(kf.pos, QVariant(value));

            // Update also stored start and end values if keyframe refers to those
            if (HbEffectUtils::fuzzyIsNull(kf.pos)) {
                mStartYValue = value;
            } else if (HbEffectUtils::fuzzyIsOneOrGreater(kf.pos)) {
                mEndYValue = value;
            }
        }
    }
}

void HbEffectScale::setStartState(QTransform &transform)
{
    // Set the start state
    updateItemTransform(transform);
}

/* Starts the scale effect animation. If the effect is already started,
the result is undefined.
*/
void HbEffectScale::start()
{
    if (mAnimationX) {
        mAnimationX->stop(); // rewind the animation before starting again
        mAnimationX->setCurrentTime(0);
        mAnimationX->mFinished = false;
        mAnimationX->start();
    }
    if (mAnimationY) {
        mAnimationY->stop(); // rewind the animation before starting again
        mAnimationY->setCurrentTime(0);
        mAnimationY->mFinished = false;
        mAnimationY->start();
    }
}

/* Cancels the effect animation and sets the animation end state immediately.
*/
void HbEffectScale::cancel(QTransform &transform, bool itemIsValid)
{
    Q_UNUSED(itemIsValid)

    if (mAnimationX) {
        mAnimationX->stop();
    }
    if (mAnimationY) {
        mAnimationY->stop();
    }

    // This will set the endstate for the object correctly when cancelling effect
    QTransform newTransform;
    newTransform.translate(mCenterXValue, mCenterYValue);
    newTransform.scale(mEndXValue, mEndYValue);
    newTransform.translate(-mCenterXValue, -mCenterYValue);
    // Combine the new transform with the existing one
    transform *= newTransform;
}

void HbEffectScale::updateItemTransform(QTransform &transform)
{
    QTransform newTransform;
    // Handle centering for scaling the matrix
    newTransform.translate(mCenterXValue, mCenterYValue);
    
    // Get the current scaling factor from animation or use 1.0 if animation does not exist
    qreal currentScalingX = mAnimationX ? mAnimationX->mCurrentScaling : 1.0;
    qreal currentScalingY = mAnimationY ? mAnimationY->mCurrentScaling : 1.0;

    // Scale the transformation matrix to reach the new scaling factor.
    newTransform.scale(currentScalingX, currentScalingY);
    // Centering must be canceled after the scaling has been done in the matrix
    newTransform.translate(-mCenterXValue, -mCenterYValue);
    // Combine the new transform with the existing one
    transform *= newTransform;
}

void HbEffectScale::handleAnimationFinished()
{
    bool allFinished = true;

    if (mAnimationX && !mAnimationX->mFinished) {
        allFinished = false;
    }
    if (mAnimationY && !mAnimationY->mFinished) {
        allFinished = false;
    }

    // Inform the effect group that the whole scale effect has finished (both scaleX and scaleY)
    if (allFinished) {
        group()->effectFinished();
    }
}

void HbEffectScale::pause()
{
    if (mAnimationX) {
        mAnimationX->pause();
    }
    if (mAnimationY) {
        mAnimationY->pause();
    }
}

void HbEffectScale::resume()
{
    if (mAnimationX) {
        mAnimationX->resume();
    }
    if (mAnimationY) {
        mAnimationY->resume();
    }
}