/****************************************************************************

**

** 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 HbWidgets 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 <hbratingslider.h>

#include <hbtooltip.h>

#include <hbstyleoptionratingslider_p.h>

#include <QGraphicsItem>

#include <QGraphicsSceneMouseEvent>

#include <hbtoucharea.h>

#ifdef HB_GESTURE_FW

#include <hbtapgesture.h>

#include <hbpangesture.h>

#endif 

#ifdef HB_EFFECTS

#include <hbeffect.h>

#include "hbeffectinternal_p.h"

#define HB_RATINGSLIDER_ITEM_TYPE "HB_RATINGSLIDER"

#endif

#define MAX_NUMBER_OF_ICONS 10

HbRatingSliderPrivate::HbRatingSliderPrivate():

    mMousePressed(false),

    mLookupValues(0),

    mReadOnly(false),

    mNumberOfIcons(5),

    mStepCount(5),

    mCurrentValue(0),

    mFrame(0),

    mTrack(0),

    mLayoutItem(0),

    mUnratedIconName(""),

    mTouchArea(0),

    mRatedIconName("")

{    

}

HbRatingSliderPrivate::~HbRatingSliderPrivate()

{

    if(mLookupValues) {

        delete [] mLookupValues;

    }

}

void HbRatingSliderPrivate::init()

{

    Q_Q(HbRatingSlider);

    mLayoutItem = q->style()->createPrimitive(HbStyle::P_RatingSlider_layout,q);

    mFrame = q->style()->createPrimitive(HbStyle::P_RatingSlider_frame,mLayoutItem);

    mTrack = q->style()->createPrimitive(HbStyle::P_RatingSlider_track,mFrame);

    mTouchArea = q->style()->createPrimitive(HbStyle::P_RatingSlider_toucharea, q);

    q->updatePrimitives();

    #ifdef HB_EFFECTS

    HbEffectInternal::add(HB_RATINGSLIDER_ITEM_TYPE,"ratingslider_appear", "ratingslider_appear");

    HbEffectInternal::add(HB_RATINGSLIDER_ITEM_TYPE,"ratingslider_disappear", "ratingslider_disappear");

    #endif

    #ifdef HB_GESTURE_FW

    q->grabGesture(Qt::TapGesture);

    q->grabGesture(Qt::PanGesture);

    if(QGraphicsObject *touchArea = mTouchArea->toGraphicsObject()) {

        touchArea->grabGesture(Qt::TapGesture);

        touchArea->grabGesture(Qt::PanGesture);

    }

    #endif 

}

void HbRatingSliderPrivate::createLookupTable()

{

    if(mLookupValues) {

        delete [] mLookupValues;

        mLookupValues=0;

    }

    mLookupValues = new int[mStepCount];

    qreal width = mFrame->boundingRect().width();

    int bandWidth =(int) (width/mStepCount);

    for(int i=0;i < mStepCount;i++) {

        mLookupValues[i] = bandWidth*(i+1);

    }

}

int HbRatingSliderPrivate::calculateProgressValue(qreal pos)

{

    Q_Q(HbRatingSlider);

    int count=0;

    for(count=0;count< mStepCount ;count++) {

        if(pos <= mLookupValues[count])

                break;

    }

    if(q->layoutDirection() == Qt::RightToLeft) {

        count = mStepCount -count;

    }

    else {

        count++;

    }

    if (pos > mLookupValues[mStepCount-1]) {

        return -1;

    }

    return count;

}

/*!

    \class HbRatingSlider

    \brief This is a widget that enables a user to rate contents like videos , music etc.

    \image html ratingslider.png  "A Rating Slider with rating done"

    The default version of Rating Slider contains 5 repeated icons drawn side by side, using a single themed graphics.

    The application can replace the themed graphic with a custom graphic.

    The custom graphics should contain only one icon (eg one star)  which will be multipled by the API \a setNumberOfIcons().

    By default it is 5 and maximum number of icons are 10.

    Along with the rating Rating Slider can be used to show the cumulative rating also.

    To use HbRatingSlider with default settings it just needs to be created.

    example code:

    \code

    HbRatingSlider *object = new HbRatingSlider(parent);

    \endcode

    HbRatingSlider emits below signals 

    void ratingDone(int ratingValue);

    void ratingChanged(int ratingValue);

    ratingDone is emitted when the user does the rating and releases the finger. 

    ratingChanged is emitted when the user presses and drags the finger on Rating Slider.

    To use HbRatingSlider with default settings it just needs to be created. 

    example code: 

    \code 

    HbMainWindow window;

    HbRatingSlider *rs = new HbRatingSlider();

    window.addView(rs);

    \endcode 

    HbRatingSlider supports integer ratings.But using the API \a setStepCount() fraction ratings can also be 

    shown on Rating Slider

    The below  code can be used to show some rating e.g. 2.5/5       

    \code

    //2.5/5 can be set as  25/50

    HbRatingSlider *slider = new HbRatingSlider();

    slider->setStepCount(50); //5 *10//

    slider->setCurrentRating(25); //2.5*10 it shows 25/50 which is same as 2.5/5

    \endcode

    This will show as 2.5/5. Now if on the same ratingslider 

    the Application wants to configure a Rating Slider with range 1-5

    on emitting the signal rating changed it can set to 5.

 */

/*!

    @beta

     Constructs a Rating Slider bar with the given parent.

    \param parent Parent Item.

*/

HbRatingSlider::HbRatingSlider(QGraphicsItem *parent) :

HbWidget(*new HbRatingSliderPrivate,parent)

{

    Q_D( HbRatingSlider );

    d->q_ptr = this;

    d->init();

}

/*!

    @beta

    Protected constructor

*/

HbRatingSlider::HbRatingSlider(HbRatingSliderPrivate &dd,QGraphicsItem *parent) : 

    HbWidget( dd,parent)

{

    Q_D( HbRatingSlider );

    d->init();

}

/*!

    Destructor

*/

HbRatingSlider::~HbRatingSlider()

{

}

/*!

    @beta

    Sets the read only property. It disables the interaction with widget

    \param value true or false.

    \sa readOnly()

*/

void HbRatingSlider::setReadOnly(bool value)

{

    Q_D(HbRatingSlider);

    d->mReadOnly = value;

}

/*!    

    @beta  

    Sets the number of icons. There can be n number of repeated icons. This method can be used to set 

    the number of icons required.The default image is "*" and has 5 stars.

    \param number. A value between 1 and 10 

    \sa numberOfIcons()

*/

void HbRatingSlider::setNumberOfIcons(int number)

{

    Q_D(HbRatingSlider);

    if ( (number <= 0) || (number > MAX_NUMBER_OF_ICONS) ){

        return;

    }

    d->mNumberOfIcons = number;

    updatePrimitives();

    d->createLookupTable();

}

/*!        

    @beta  

    Returns the number of icons set.

    \sa setNumberOfIcons()

*/

int HbRatingSlider::numberOfIcons() const

{

    Q_D(const HbRatingSlider);

    return d->mNumberOfIcons;

}

/*!

    @beta

    Sets the step count for the Rating Slider.This indicates the interval of the rating. Eg. If step count is 10

    then 10 rating is possible.

    \param count. A value between 1 and 100. This can be considerd as the maximum rating possible. 

    \sa numberOfIcons()

*/

void HbRatingSlider::setStepCount(int count)

{

    Q_D(HbRatingSlider);

    if( (count <= 0) || (count > 100) ) {

        return;

    }

    d->mStepCount = count;

    d->createLookupTable();    

    HbStyleOptionRatingSlider option;

    initStyleOption(&option);

    if (d->mTrack) {

           style()->updatePrimitive(d->mTrack, HbStyle::P_RatingSlider_track, &option);

    }

}

/*!

    @beta

    Returns the step count.

*/    

int HbRatingSlider::stepCount() const

{

    Q_D(const HbRatingSlider);

    return d->mStepCount;

}

/*!

    @beta

    Returns the read only flag of the Rating slider

*/

bool HbRatingSlider::isReadOnly() const

{

    Q_D(const HbRatingSlider);

    return d->mReadOnly;

}

/*!

    @beta

    It sets the current rating value.

    \param count. A value between 1 and stepcount. 

    \sa currentRating()

*/

void  HbRatingSlider::setCurrentRating(int rating)

{

    Q_D(HbRatingSlider);

    if( rating >d->mStepCount ) {

        rating = d->mStepCount;

    }

    if( (rating == d->mCurrentValue) || (rating < 0) ) {

        return;

    }

    d->mCurrentValue = rating;

    HbStyleOptionRatingSlider option;

    initStyleOption(&option);

    if (d->mTrack) {

           style()->updatePrimitive(d->mTrack, HbStyle::P_RatingSlider_track, &option);

    }

}

/*!

    @beta

    Returns the the current rating value.

*/

int HbRatingSlider::currentRating() const

{

    Q_D(const HbRatingSlider);

    return d->mCurrentValue;

}

/*!

    @beta

    It sets the unrated graphics name.This is the graphics shown when Rating Slider is displayed.

    the graphicscan be a single star kind of or multi star image. If it is single star then use setNumberOfIcons for 

    setting number of stars.

    \param name. The graphics name along with the path. 

    \sa unRatedIconName()

*/

void HbRatingSlider::setUnRatedIconName(const QString name)

{

    Q_D(HbRatingSlider);

    if(d->mUnratedIconName != name) {

        d->mUnratedIconName =name;

        HbStyleOptionRatingSlider option;

        initStyleOption(&option);

        updatePrimitives();

    }

}

/*!

    @beta

    Returns the unrated graphics name .

*/

QString HbRatingSlider::unRatedIconName() const

{

    Q_D(const HbRatingSlider);

    return d->mUnratedIconName;

}

/*!

    @beta

    It sets the rated graphics name.This is the graphics shown when rating is on going.

    the graphicscan be a single star kind of or multi star image. If it is single star then use setNumberOfIcons for 

    setting number of stars.

    \param name. The graphics name along with the path. 

    \sa unRatedIconName()

*/

void HbRatingSlider::setRatedIconName(const QString name)

{

    Q_D(HbRatingSlider);

    if(d->mRatedIconName != name) {

        d->mRatedIconName = name;

        HbStyleOptionRatingSlider option;

        initStyleOption(&option);

        updatePrimitives();

    }

}

/*!

    @beta

    Returns the rated graphics name .

*/

QString HbRatingSlider::ratedIconName() const 

{

    Q_D(const HbRatingSlider);

    return d->mRatedIconName;

}

#ifndef HB_GESTURE_FW

/*!

    \reimp

*/

void HbRatingSlider::mousePressEvent(QGraphicsSceneMouseEvent *event) 

{

    Q_D(HbRatingSlider);

    if(d->mTouchArea->isUnderMouse()) {

        if(d->mReadOnly) {    

            event->ignore();

            return;

        }

        d->mMousePressed = true;

        event->accept();

        updatePrimitives();

    }

}

/*!

    \reimp

*/

void HbRatingSlider::mouseMoveEvent ( QGraphicsSceneMouseEvent * event ) 

{

    Q_D(HbRatingSlider);

    if(!d->mMousePressed) {

        return;

    }

    QPointF layoutItemPos = d->mLayoutItem->pos();

    QPointF frameItemPos = d->mFrame->pos();   

    qreal xVal = event->pos().x() - layoutItemPos.x()+ frameItemPos.x();

    if(d->mTouchArea->isUnderMouse()) {

        if(d->mReadOnly) {

            event->ignore();

            return;

        }

        if(xVal <0) {    

            setCurrentRating(0);

            return;

        }

        QRectF rect = d->mTouchArea->boundingRect();

        int rating=0;

        if(rect.contains(xVal,0 )) {

            rating = d->calculateProgressValue(xVal);

            if(!toolTip().isNull()) {

                HbToolTip::showText(toolTip(),this);

            }    

            setCurrentRating(rating);

            emit ratingChanged (d->mCurrentValue);

            event->accept();

        }

    }

    else {

            setCurrentRating(0);

        }

}

/*!

    \reimp

*/

void HbRatingSlider::mouseReleaseEvent(QGraphicsSceneMouseEvent *event) 

{

    Q_D(HbRatingSlider);